📚 ebook2audiobook (E2A)

CPU/GPU Converter from E-Book to audiobook with chapters and metadata
using advanced TTS engines and much more.
Supports voice cloning and 1158 languages!

[!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.
Use this tool responsibly and in accordance with all applicable laws.

Thanks to support ebook2audiobook developers!

Run locally

Run Remotely

GUI Interface

Click to see images of Web GUI

Demos

New Default Voice Demo

https://github.com/user-attachments/assets/750035dc-e355-46f1-9286-05c1d9e88cea

README.md

Table of Contents

• ebook2audiobook
• Features
• GUI Interface
• Demos
• Supported Languages
• Minimum Requirements
• Usage
• Run Locally
  • Launching Gradio Web Interface
  • Basic Headless Usage
  • Headless Custom XTTS Model Usage
  • Help command output
• Run Remotely

• Docker

  • Steps to Run

• Cloned Voices

• Fine Tuned TTS models
• Collection of Fine-Tuned TTS Models
• Train TTS Model
• Supported eBook Formats
• Output Formats
• Revert to older Version
• Common Issues
• Special Thanks
• Table of Contents

Features

• 🔧 TTS Engines supported: XTTSv2, Bark, Fairseq, VITS, Tacotron2, Tortoise, GlowTTS, YourTTS
• 📚 Convert multiple file formats: .epub, .mobi, .azw3, .fb2, .lrf, .rb, .snb, .tcr, .pdf, .txt, .rtf, .doc, .docx, .html, .odt, .azw, .tiff, .tif, .png, .jpg, .jpeg, .bmp, .zip
• 💻 TextArea to convert directly a short text in audio
• 🔍 OCR scanning for files with text pages as images
• 🔊 High-quality text-to-speech from near realtime to near real voice
• 🗣️ Optional voice cloning using your own voice file
• 🌐 Supports 1158 languages (supported languages list)
• 💻 Low-resource friendly — runs on 2 GB RAM / 1 GB VRAM (minimum)
• 🎵 Audiobook output formats: mono or stereo aac, flac, mp3, m4b, m4a, mp4, mov, ogg, wav, webm
• 🧠 SML tags supported — fine-grained control of breaks, pauses, voice switching and more (see below)
• 🧩 Optional custom model using your own trained model (XTTSv2, VITS, FAIRSEQ, PIPER, others on request)
• 🎛️ Fine-tuned preset models trained by the E2A Team
  (Contact us if you need additional fine-tuned models, or if you’d like to share yours to the official preset list)

Hardware Requirements

• 2GB RAM min, 8GB recommended.
• 1GB VRAM min, 4GB recommended.
• Virtualization enabled if running on windows (Docker only).
• CPU, XPU (intel, AMD, ARM)*.
• CUDA, ROCm, JETSON
• MPS (Apple Silicon CPU)

* Modern TTS engines are very slow on CPU, so use lower quality TTS like YourTTS, Tacotron2 etc..

Supported Languages

Supported eBook Formats

• .epub, .pdf, .mobi, .txt, .html, .rtf, .chm, .lit, .pdb, .fb2, .odt, .cbr, .cbz, .prc, .lrf, .pml, .snb, .cbc, .rb, .tcr
• Best results: .epub or .mobi for automatic chapter detection

Output and process Formats

• .m4b, .m4a, .mp4, .webm, .mov, .mp3, .flac, .wav, .ogg, .aac
• Process format can be changed in lib/conf.py

SML tags available

• [break] — silence (random range 0.3–0.6 sec.)
• [pause] — silence (random range 1.0–1.6 sec.)
• [pause:N] — fixed pause (N sec.)
• [voice:/path/to/voice/file]...[/voice] — switch voice from default or selected voice from GUI/CLI

Check our other repo dedicated to add SML automatically in your ebook -> E2A-SML

[!IMPORTANT] Before to post an install or bug issue search carefully to the opened and closed issues TAB
to be sure your issue does not exist already.

[!NOTE] EPUB format lacks any standard structure like what is a chapter, paragraph, preface etc.
So you should first remove manually any text you don't want to be converted in audio.

Instructions

1. Clone repo bash git clone https://github.com/DrewThomasson/ebook2audiobook.git cd ebook2audiobook

2. Install / Run ebook2audiobook:

• Linux/MacOS
  bash ./ebook2audiobook.command Note for MacOS users: homebrew is installed to install missing programs.

• Mac Launcher
  Double click Mac Ebook2Audiobook Launcher.command

• Windows
  bash ebook2audiobook.cmd or Double click ebook2audiobook.cmd

  Note for Windows users: scoop is installed to install missing programs without administrator privileges.

1. Open the Web App: Click the URL provided in the terminal to access the web app and convert eBooks. http://localhost:7860/
2. For Public Link: ./ebook2audiobook.command --share (Linux/MacOS) ebook2audiobook.cmd --share (Windows) python app.py --share (all OS)

[!IMPORTANT] If the script is stopped and run again, you need to refresh your gradio GUI interface
to let the web page reconnect to the new connection socket.

Basic Usage

• Linux/MacOS: bash ./ebook2audiobook.command --headless --ebook <path_to_ebook_file> --voice <path_to_voice_file> --language <language_code>

• Windows bash ebook2audiobook.cmd --headless --ebook <path_to_ebook_file> --voice <path_to_voice_file> --language <language_code>

• [--ebook]: Path to your eBook file

• [--voice]: Voice cloning file path (optional)
• [--language]: Language code in ISO-639-3 (i.e.: ita for italian, eng for english, deu for german...).
  Default language is eng and --language is optional for default language set in ./lib/lang.py.
  The ISO-639-1 2 letters codes are also supported.

Example of Custom Model Zip Upload

(must be a .zip file containing the mandatory model files. Example for XTTSv2: config.json, model.pth, vocab.json and ref.wav) - Linux/MacOS bash ./ebook2audiobook.command --headless --ebook <ebook_file_path> --language <language> --custom_model <custom_model_path> - Windows ```bash ebook2audiobook.cmd --headless --ebook --language --custom_model <cust