https://github.com/zefir1990/epub2mp3
Yet another epub2mp3
https://github.com/zefir1990/epub2mp3
epub2mp3
Last synced: 6 days ago
JSON representation
Yet another epub2mp3
- Host: GitHub
- URL: https://github.com/zefir1990/epub2mp3
- Owner: zefir1990
- License: mit
- Created: 2025-09-18T07:45:25.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-09-21T08:18:19.000Z (8 months ago)
- Last Synced: 2026-02-21T21:20:27.988Z (3 months ago)
- Topics: epub2mp3
- Language: Python
- Homepage: https://demensdeum.com
- Size: 16.6 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EPUB to Audiobook Converter
[](https://opensource.org/licenses/MIT)
A simple Python command-line tool to convert `.epub` files into `.mp3` audiobooks. 🔊
---
## 📖 Table of Contents
- [About the Project](#-about-the-project)
- [Getting Started](#-getting-started)
- [Usage](#-usage)
- [License](#-license)
---
## 🎯 About The Project
This script provides a quick and easy way to turn your e-books into audio files. It uses `epub2txt` to extract the text content from an EPUB file and then leverages `pyttsx3` to synthesize that text into speech, saving it as an MP3 file.
**Built With:**
* [Python](https://www.python.org/)
* [epub2txt](https://pypi.org/project/epub2txt/)
* [pyttsx3](https://pypi.org/project/pyttsx3/)
* [FFmpeg](https://ffmpeg.org/)
* [mutagen](https://pypi.org/project/mutagen/)
* [Gradio](https://www.gradio.app/)
---
## 🚀 Getting Started
Follow these steps to get the script running on your local machine.
### **Prerequisites**
You need to have **Python** and **pip** installed. You will also need to install the required Python libraries.
### **Installation**
1. Clone the repository or download the script to a local directory.
2. Install the required packages using pip:
```sh
pip install epub2txt pyttsx3 mutagen
```
3. Install FFmpeg and add to PATH
---
## 💻 Usage
Run the script from your terminal, providing the path to the input `.epub` file and the desired name for the output `.mp3` file.
**Command:**
```sh
python your_script_name.py
```
---
**Example:**
The following source code is an **example** command. For full **license** details, please see the `LICENSE` file.
```sh
# This is an example command.
python epub_converter.py "example_book.epub" "example_audiobook.mp3"
```
---
**Web Interface:**
```sh
python web.py
```
Open browser at [http://127.0.0.1:7860/](http://127.0.0.1:7860/)
---
## 📜 License
Distributed under the MIT License. See the `LICENSE` file for more information. This **license** permits reuse, modification, and distribution, making this an open-source **example** of an EPUB converter.