General Introduction
Audiblez is an open source project designed to convert eBooks (e.g. .epub format) to audiobooks (e.g. .m4b format). The project utilizes Kokoro Audiblez is a high-quality speech synthesis technology that supports multiple languages and multiple voices. Users can convert eBooks to audiobooks for easy listening on a variety of devices with a simple command line operation.Audiblez was developed by Claudio Santini and is available on GitHub under the MIT license.
Function List
- eBook conversion: Convert eBooks in .epub format to audiobooks in .m4b format.
- Multi-language support: American English, British English, French, Korean, Japanese and Mandarin are supported.
- Multiple sound options: Provides a wide selection of naturalistic and realistic voices.
- Efficient conversion: Fast conversion process on modern computers.
- open source project: The code is publicly available and can be freely modified and distributed by users.
Using Help
Installation process
- Make sure Python 3 is installed on your computer (Python 3.13 is not supported).
- Install Audiblez using pip:
pip install audiblez
- Download the necessary files (approx. 360MB):
wget https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files/kokoro-v0_19.onnx
wget https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files/voices.json
- Make sure ffmpeg is installed to generate .m4b files.
Usage Process
- Convert .epub files to audiobooks:
audiblez book.epub -l en-gb -v af_sky
This command generates several .wav files in the same directory, and finally a .m4b file that can be played using VLC or any audiobook player.
Detailed steps
- Select Language: Use
-l
option specifies the language code, e.g.en-us
(American English),en-gb
(British English),fr-fr
(in French),ja
(Japanese),kr
(Korean) andcmn
(Mandarin). - Selecting a sound: Use
-v
option specifies the sound, e.g.af_sky
,am_adam
,bf_emma
etc. It can be found in the Kokoro-TTS On the audition. - conversion process: After running the conversion command, Audiblez will first split the .wav files into multiple chapters, and then merge them into a single .m4b file.
typical example
Suppose there is a book called example.epub
eBooks that want to be converted to British English audiobooks and use the af_sky
sound, the command is as follows:
audiblez example.epub -l en-gb -v af_sky
When the conversion is complete, it generates the following in the same directory example.m4b
Documentation.