amitportal/audiobook-creator

Convert Markdown books into high-quality MP3 audiobooks using Naturalistic TTS models with smartly added dynamic pauses.

0

stars

11

commits

Python

primary language

Dec 30, 2025

updated

amitportal.github.io/
audiobook
nlp-machine-learning
reading
speech-synthesis
tts
Browse cluster: Text-to-Speech and Voice Synthesis

README

Audiobook Creator

Version 1.2.0 - Convert Markdown books into high-quality MP3 audiobooks with state-of-the-art TTS models and hardware acceleration.

Software License Python 3.12+ Hardware Support

Features

  • Multi-Model Support:
    • Supertone Supertonic: Ultra-fast ONNX-based high-fidelity models.
    • Soprano-80M: Lightweight LLM-based TTS with Vocos decoder.
    • MiraTTS: High-quality 48kHz audio tokens with NCodec.
    • Kokoro: High-quality open-weight model for expressive speech.
    • Chatterbox: Paralinguistic support for natural sounding books.
  • Hardware Acceleration: Automatic detection of NVIDIA GPUs (CUDA), Intel NPUs/GPUs (OpenVINO), and DirectML.
  • Smart Parsing: Automatically handles Markdown structures, headers, and semantic pauses.
  • Dynamic Pauses: Uses semantic similarity to inject natural breathing room between sections.
  • One-Click Setup: Professional PowerShell script handles all dependencies, models, and FFmpeg automatically.
  • Modern GUI: dark-mode interface with real-time processing logs.

Quick Start (Windows)

  1. Clone/Download this repository.
  2. Right-click run_audiobook_creator.ps1 and select "Run with PowerShell".
  3. Wait for the automatic setup (Installs UV, FFmpeg, and Models).
  4. The GUI launches automatically!

Hardware Acceleration

Audiobook Creator automatically optimizes itself for your hardware:

Hardware DetectMethod UsedBenefit
NVIDIA GPUCUDA 12.xMaximum performance for all models.
Intel NPUOpenVINOEfficient background processing on modern laptops.
Intel GPUOpenVINOHigh-performance inference.
Old GPU/AMDDirectMLBasic hardware acceleration.
Generic CPUAVX/AVX2Optimized fallback for all systems.

Usage

GUI

Simply select your input file, choose a model, and click "Start".

Command Line

# Basic usage
uv run audiobook -i book.md -m soprano

# Specify voice and hardware
uv run audiobook -i book.md -m supertonic -v M2 --device cuda

Supported Models

ModelSample RateBest ForHardware
Supertonic44.1 kHzSpeed & StabilityONNX (All)
Soprano32.0 kHzEfficiency (80M params)Torch / CUDA
MiraTTS48.0 kHzUltra FidelityTorch / CUDA
Kokoro24.0 kHzQualityTorch / CPU
Chatterbox24.0 kHzExpressionONNX (All)

Technical Setup

Prerequisites

  • Python 3.12+
  • FFmpeg (Auto-installed by script)

Manual Installation

pip install uv
uv sync
uv pip install -e .
audiobook-gui

Troubleshooting

  • Security Policy: If PowerShell scripts are blocked, run: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  • Missing Models: Ensure you have ~2GB free space for one-time model downloads.
  • FFmpeg Output: If MP3 conversion fails, ensure FFmpeg is in your system PATH.

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

Credits

Built with ❤️ by Amit Kumar.

Contributions are welcome! Please open an issue or PR for new model integrations or hardware optimizations.

Contributors

amitportal

11 commits

amitportal/audiobook-creator

Convert Markdown books into high-quality MP3 audiobooks using Naturalistic TTS models with smartly added dynamic pauses.

0

stars

11

commits

Python

primary language

Dec 30, 2025

updated

amitportal.github.io/
audiobook
nlp-machine-learning
reading
speech-synthesis
tts
Browse cluster: Text-to-Speech and Voice Synthesis

README

Audiobook Creator

Version 1.2.0 - Convert Markdown books into high-quality MP3 audiobooks with state-of-the-art TTS models and hardware acceleration.

Software License Python 3.12+ Hardware Support

Features

  • Multi-Model Support:
    • Supertone Supertonic: Ultra-fast ONNX-based high-fidelity models.
    • Soprano-80M: Lightweight LLM-based TTS with Vocos decoder.
    • MiraTTS: High-quality 48kHz audio tokens with NCodec.
    • Kokoro: High-quality open-weight model for expressive speech.
    • Chatterbox: Paralinguistic support for natural sounding books.
  • Hardware Acceleration: Automatic detection of NVIDIA GPUs (CUDA), Intel NPUs/GPUs (OpenVINO), and DirectML.
  • Smart Parsing: Automatically handles Markdown structures, headers, and semantic pauses.
  • Dynamic Pauses: Uses semantic similarity to inject natural breathing room between sections.
  • One-Click Setup: Professional PowerShell script handles all dependencies, models, and FFmpeg automatically.
  • Modern GUI: dark-mode interface with real-time processing logs.

Quick Start (Windows)

  1. Clone/Download this repository.
  2. Right-click run_audiobook_creator.ps1 and select "Run with PowerShell".
  3. Wait for the automatic setup (Installs UV, FFmpeg, and Models).
  4. The GUI launches automatically!

Hardware Acceleration

Audiobook Creator automatically optimizes itself for your hardware:

Hardware DetectMethod UsedBenefit
NVIDIA GPUCUDA 12.xMaximum performance for all models.
Intel NPUOpenVINOEfficient background processing on modern laptops.
Intel GPUOpenVINOHigh-performance inference.
Old GPU/AMDDirectMLBasic hardware acceleration.
Generic CPUAVX/AVX2Optimized fallback for all systems.

Usage

GUI

Simply select your input file, choose a model, and click "Start".

Command Line

# Basic usage
uv run audiobook -i book.md -m soprano

# Specify voice and hardware
uv run audiobook -i book.md -m supertonic -v M2 --device cuda

Supported Models

ModelSample RateBest ForHardware
Supertonic44.1 kHzSpeed & StabilityONNX (All)
Soprano32.0 kHzEfficiency (80M params)Torch / CUDA
MiraTTS48.0 kHzUltra FidelityTorch / CUDA
Kokoro24.0 kHzQualityTorch / CPU
Chatterbox24.0 kHzExpressionONNX (All)

Technical Setup

Prerequisites

  • Python 3.12+
  • FFmpeg (Auto-installed by script)

Manual Installation

pip install uv
uv sync
uv pip install -e .
audiobook-gui

Troubleshooting

  • Security Policy: If PowerShell scripts are blocked, run: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  • Missing Models: Ensure you have ~2GB free space for one-time model downloads.
  • FFmpeg Output: If MP3 conversion fails, ensure FFmpeg is in your system PATH.

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

Credits

Built with ❤️ by Amit Kumar.

Contributions are welcome! Please open an issue or PR for new model integrations or hardware optimizations.

Contributors

amitportal

11 commits

Languages

Python

97.0%

PowerShell

3.0%