Metadata-Version: 2.2
Name: autiobooks
Version: 1.0.6
Summary: Automatically convert epubs to audiobooks
Home-page: https://github.com/plusuncold/autiobooks
Author: David Nesbitt
Project-URL: Homepage, https://github.com/plusuncold/autiobooks
Project-URL: Documentation, https://github.com/plusuncold/autiobooks
Project-URL: Repository, https://github.com/plusuncold/autiobooks
Project-URL: Issues, https://github.com/plusuncold/autiobooks/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pillow>=10.0.0
Requires-Dist: tk>=0.1.0
Requires-Dist: kokoro<0.3.0,>=0.2.3
Requires-Dist: ebooklib<0.19,>=0.18
Requires-Dist: soundfile<0.14.0,>=0.13.1
Requires-Dist: pygame<3.0.0,>=2.0.1
Requires-Dist: bs4<0.0.3,>=0.0.2
Requires-Dist: pydub<0.26.0,>=0.25.1
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# Autiobooks: Automatically convert epubs to audiobooks
[![Installing via pip and running](https://github.com/plusuncold/autiobooks/actions/workflows/pip-install.yaml/badge.svg)](https://github.com/plusuncold/autiobooks/actions/workflows/pip-install.yaml)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/autiobooks)
![PyPI - Version](https://img.shields.io/pypi/v/autiobooks)

Autiobooks generates `.m4b` audiobooks from regular `.epub` e-books, using Kokoro's high-quality speech synthesis.

![Demo of Autiobooks in action](rec.gif)

[Kokoro](https://huggingface.co/hexgrad/Kokoro-82M) is an open-weight text-to-speech model with 82 million parameters. It yields natural sounding output while being able to run on consumer hardware.

It supports American, British English, French, Korean, Japanese and Mandarin (though we only-support English, for now) and a wide range of different voices with different accents and prosody.

PRs are welcome!

## Changelog

#### 1.0.6

- Fix chapter index - @tomhense

#### 1.0.5
- Fix pip installs

#### 1.0.3
- Fix bug causing errors on some linux installs
- Read epub files with chapters not marked as ITEM_DOCUMENT
- Select all chapters if none are selected

#### 1.0.2
- Window can be resized

#### 1.0.1
- Initial release


## How to install and run

(Note that pip installs are currently not working - we are looking
into the cause of this, but in the meantime, please download the 
repo and run directly)

If you have Python 3 on your computer, you can install it with pip.
Be aware that it won't work with Python 3.13.

```bash
pip install autiobooks
```

You will require `ffmpeg` and `tkinter` installed:

Linux:
```bash
sudo apt install ffmpeg python3-tkinter
```
MacOS:
```bash
brew install ffmpeg python-tk
```

To start the program, run:

```bash
python3 -m autiobooks
```

The program creates .wav files for each chapter, then combines them into a .m4b file for playing using an audiobook player.

## Author
by David Nesbitt, distributed under MIT license.
