https://github.com/soft/epub2audio
Tool for automatically converting EPub ebooks to audiobooks using TTS.
https://github.com/soft/epub2audio
audiobook converter epub python text-to-speech tts
Last synced: 8 months ago
JSON representation
Tool for automatically converting EPub ebooks to audiobooks using TTS.
- Host: GitHub
- URL: https://github.com/soft/epub2audio
- Owner: Soft
- License: mit
- Created: 2023-08-20T19:47:45.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-12-31T14:12:08.000Z (over 2 years ago)
- Last Synced: 2025-03-23T01:18:29.749Z (about 1 year ago)
- Topics: audiobook, converter, epub, python, text-to-speech, tts
- Language: Python
- Homepage:
- Size: 9.77 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# epub2audio 📗🔊
Tool for automatically converting EPub ebooks to audio using
[TTS](https://github.com/coqui-ai/TTS).
## Usage
```
usage: epub2audio [-h] [-o DIR] [--model NAME] [--speaker-wav PATH] [--language LANG] [--on-error {ask,skip,edit}] [--log-level {debug,info,warning,error,critical}] PATH [PATH ...]
Convert EPub files to audiobooks.
positional arguments:
PATH input EPub files
options:
-h, --help show this help message and exit
-o DIR, --output DIR output directory
--model NAME model name
--speaker-wav PATH speaker wav file path
--language LANG language name
--on-error {ask,skip,edit}
strategy for handling synthesizer errors
--log-level {debug,info,warning,error,critical}
set log level
```
## Examples
The following command will convert `input.epub` into audio using the default
Tacotron2 synthesizer model:
```sh
epub2audio input.epub
```
The following command will convert `input.epub` into audio using
[XTTS2](https://huggingface.co/coqui/XTTS-v2) synthesizer model. This mode
requires a reference audio clip (supplied with the `--speaker-wav` command-line
option) for the synthesizer to imitate:
```sh
epub2audio --model 'tts_models/multilingual/multi-dataset/xtts_v2' \
--speaker-wav speaker.mp3 \
--language en \
input.epub
```