Autiobooks: Automatically convert epubs to audiobooks
Autiobooks generates .m4b audiobooks from regular .epub e-books, using Kokoro's high-quality speech synthesis.
Kokoro is an open-weight text-to-speech model with 82 million parameters. It yields natural sounding output while being able to run on consumer hardware.
It supports American, British English, French, Korean, Japanese and Mandarin (though we only-support English, for now) and a wide range of different voices with different accents and prosody.
PRs are welcome!
Changelog
1.1.0
- Fix race condition - @Thabian
1.0.9
- Fix issue with output file containing multiple audio stream 10 - @tomhense
- Add an entrypoint for pipx - @tomhense
1.0.7
- Uptick kokoro package
1.0.6
- Fix chapter index - @tomhense
1.0.5
- Fix pip installs
1.0.3
- Fix bug causing errors on some linux installs
- Read epub files with chapters not marked as ITEM_DOCUMENT
- Select all chapters if none are selected
1.0.2
- Window can be resized
1.0.1
- Initial release
How to install and run
(Note that pip installs are currently not working - we are looking into the cause of this, but in the meantime, please download the repo and run directly)
If you have Python 3 on your computer, you can install it with pip. Be aware that it won't work with Python 3.13.
pip install autiobooks
You will require ffmpeg and tkinter installed:
Linux:
sudo apt install ffmpeg python3-tkinter
MacOS:
brew install ffmpeg python-tk
Also recommended is espeak-ng for better processing of unknown words.
To start the program, run:
python3 -m autiobooks
The program creates .wav files for each chapter, then combines them into a .m4b file for playing using an audiobook player.
Author
by David Nesbitt, distributed under MIT license.
Metadata
Release files for autiobooks 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| autiobooks-1.1.0.tar.gz | 12.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| autiobooks-1.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.7 kB
Release files / autiobooks-1.1.0.tar.gz
| Download URL | autiobooks-1.1.0.tar.gz |
|---|---|
| Size | 12.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
800565da02f8598157f817f7f2694fd3aa680d805480f0bd0e32ab7f1e28ee09
|
|
BLAKE2b-256 checksum How to use checksums |
5a6cc796b695127fb752bde296acd1652d49ec02f408f6b2b82259ffded07f6d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Release files / autiobooks-1.1.0-py3-none-any.whl
| Download URL | autiobooks-1.1.0-py3-none-any.whl |
|---|---|
| Size | 12.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6180fa908a885ff84c14d907cbf62d920e4ecb95ba41e265442c60a5b5ca8808
|
|
BLAKE2b-256 checksum How to use checksums |
f3860d0341624e5ab2866002139fb424c9c641fdae6a92681315349599a3c94e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.3
|
Security for autiobooks 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.