Skip to content

adnjoo/kokoro-epub

Repository files navigation

title emoji colorFrom colorTo sdk sdk_version app_file pinned short_description
Kokoro Epub
💻
red
gray
gradio
5.44.0
app.py
false
epub 2 mp3 / m4b

kokoro-epub

Important

This tool is intended for use with non-DRM, legally acquired eBooks only.
The authors are not responsible for any misuse of this software or any resulting legal consequences.

Converts EPUB to audiobook (MP3 or M4B (chapter markers)) using python.

Quick Start

# Setup
python3.11 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# System requirement for MP3/M4B merge
sudo apt install ffmpeg -y    # required for pydub exports

# Run
python app.py

👉 Try it free on Hugging Face Space — or run faster in the cloud at bookbearai.com.

GPU Torch

Gutenberg Kafka - The Metamorphosis 25152 words ~ 100 pages ~ 60mb (MP3 2h12m • 64 kbps • 24 kHz • mono)

5060 Ti 16GB - ETA 194s/3' | WPS 130 vs CPU - 1389s/23' | WPS 18

 pip install --upgrade torch --index-url https://download.pytorch.org/whl/cu128

CLI Usage

In addition to the Gradio UI, you can also run the tool directly from the command line with cli.py:

List chapters in an EPUB:

python cli.py 5200.epub --list-chapters

Convert to M4B, selecting only chapters II and III:

python cli.py 5200.epub --format M4B --chapters 3,4 --out audiobooks

Sample Output

sun_also_sample.mp4

Related Projects

If you're exploring other ebook-to-audio solutions, you might also check out:

  • readest - modern e-reader with Edge TTS (22 voices)
  • audiblez — CLI tool for converting text to audiobooks.
  • ebook2audiobook — Simple Python-based ebook-to-audio converter.

License

MIT License. See LICENSE.md.

Contributing

📌 See CONTRIBUTING.md if you'd like to contribute.

About

converts EPUBs to MP3s/M4Bs using kokoro tts

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages