Abogen converts EPUB/PDF/text to audio with synchronized subtitles, offering a desktop PyQt6 and a web UI, plus subtitle and voice customization features.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Abogen is a Python tool that generates audio from ePub, PDF, text, Markdown, or subtitle files and produces matching subtitles. It supports Kokoro-82M voices and provides two interfaces: a PyQt6 desktop GUI and a Flask web UI with additional features.
How it works
The project exposes two interfaces:
- abogen (PyQt6 Desktop GUI) for core features
- abogen-web (Flask Web UI) for core features plus Supertonic TTS, LLM Normalization, Audiobookshelf Integration, and more Recent releases show enhancements to UI, subtitle generation, and multilingual subtitle timing. Commands and configuration are provided in the README for running and setup.
Getting started
Windows
"```bash
For Windows installer workflow
WINDOWS_INSTALL.bat "```
Alternative: uv (cross-platform)
"bash uv tool install --python 3.12 abogen[cuda] --extra-index-url https://download.pytorch.org/whl/cu128 --index-strategy unsafe-best-match "
Mac
"bash uv tool install --python 3.13 abogen --with \"kokoro @ git+https://github.com/hexgrad/kokoro.git,numpy<2\" "
Linux
"bash uv tool install --python 3.12 abogen "
Recent releases
- v1.3.1 (2026-02-06): Web UI, EPUB 3 pipeline, and related improvements (contributor acknowledged).
- v1.2.5 (2025-12-10): Install via uv for faster setup.
- v1.2.4 (2025-11-28): Subtitle generation now available for all languages with multiple modes.
- v1.2.3 (2025-11-18): Voice subtitle files support (.srt/.ass/.vtt) and timestamped text files.
- v1.2.1 (2025-10-27): Interface upgraded from PyQt5 to PyQt6.
Traction
5531 stars, 406 forks, 45 open issues.
Behind the repo
Not specified in the README beyond acknowledgments for contributions to the Web UI and subtitle features.
Caveats
MIT license. Created 2025-04-24. Last push 2026-07-30. Open issues: 45.