Skip to main content

Autiobooks: Automatically convert epubs to audiobooks

Installing via pip and running PyPI - Python Version PyPI - Version

Autiobooks generates .m4b audiobooks from regular .epub e-books, using Kokoro's high-quality speech synthesis.

Demo of Autiobooks in action

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)

Source distribution for autiobooks 1.1.0
File Size Uploaded Provenance
autiobooks-1.1.0.tar.gz 12.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for autiobooks 1.1.0
File Interpreter ABI Platform
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page