# miragea-audiobook

> Open-source CLI that turns an EPUB, Markdown or text file into a chaptered M4B audiobook narrated by a cloned or saved voice through the Miragea API. No GPU. MIT licence.

## Docs
- [README](https://codeberg.org/miragea-voice/miragea-audiobook/src/branch/main/README.md): quick start, options, comparison, FAQ
- [Changelog](https://codeberg.org/miragea-voice/miragea-audiobook/src/branch/main/CHANGELOG.md)
- [Miragea API keys](https://miragea.ai/workspace/api)

## Usage
- `pipx install miragea-audiobook`; needs ffmpeg and MIRAGEA_API_KEY
- `miragea-audiobook chapters book.epub` | `plan book.epub` | `make book.epub --voice 'https://.../sample.wav|exact words' --split`
- Outputs: .m4b with chapter markers, .cue, .chapters.txt, .json manifest, optional per-chapter MP3
- Agents: add --json; install the Miragea skill with "Install https://miragea.ai/skills/miragea-audio/install.md"
