Metadata-Version: 2.1
Name: sonus
Version: 0.6.0
Summary: Cross-platform OverDrive audiobook client and chapterizer written in Python. 
Home-page: https://github.com/digitalec/sonus
Author: digitalec
License: GPL3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.6
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

## sonus
sonus is a cross-platform OverDrive audiobook client and chapterizer written in Python and the only tool that properly splits and tags chapters.

This tool was written with the need for a portable way to automate chapterizing and tagging of OverDrive MP3 files for use in standard media players. You must have an active OverDrive account and check-out the books you wish to download.

![PyPI](https://img.shields.io/pypi/v/sonus?style=flat)
[![Downloads](https://pepy.tech/badge/sonus)](https://pepy.tech/project/sonus)
![GitHub last commit](https://img.shields.io/github/last-commit/digitalec/sonus?style=flat)
![GitHub last release](https://img.shields.io/github/release-date/digitalec/sonus?style=flat)
[![Donate](https://img.shields.io/badge/Donate-PayPal-blue?style=flat&logo=paypal)](https://paypal.me/digitalec)

### Features
- Download and chapterize audiobooks
- Chapterize existing OverDrive files
- Return loan early


### Requirements
- Python 3.6+ - [download](https://python.org/)
- ffmpeg - [download](https://ffmpeg.org/)


### Installation

Install the latest release from PyPI:
```
$ pip install sonus
$ sonus --version
sonus 0.1.0
```

...or install by cloning this repository
```
$ git clone https://github.com/digitalec/sonus.git
$ cd sonus
$ python -m sonus --version
sonus 0.1.0
```

### Usage
Audiobook files are saved inside the specified `--output` directory under a Artist/Title/Chapters structure.


To download and chapterize an audiobook:
```
$ sonus BookName.odm --output /media/audiobooks
```

&nbsp;

If you already have existing audiobooks downloaded using the OverDrive Media Console, you can still chapterize them to make them easier to play on other devices. Specify the path to the folder containing all of the OverDrive "-partX.mp3" files:
```
C:\> sonus "C:\Users\Name\Documents\My Media\MP3 Audiobooks\BookName" --output "E:\Audiobooks"
```

&nbsp;

Once you're done with an audiobook and wish to return the loan:
```
$ sonus --return BookName.odm
```

### Credits

- sonus was inspired by the _OverDrive Chapterizer_ feature of inAudible
- _Download_ logic is a modified version of that from [overdrive-dl](https://github.com/davideg/overdrive-dl)
- _Return Early_ logic is from [odmpy](https://github.com/ping/odmpy)
