chatterbook 0.3.0

Convert EPUB books into chapter WAV audio with Chatterbox Multilingual TTS.

chatterbook

Convert EPUB books into M4B audiobooks with Chatterbox Multilingual TTS.

from chatterbook import convert_epub

convert_epub(
    "book.epub",
    language="ko",
    voice_path="voices/narrator.wav",
    style="warm",
    max_chars=300,
    speed=0.9,
    paragraph_pause_ms=600,
    dialogue_pause_ms=300,
)

By default, the output filename is read from the EPUB title metadata and written as Title.m4b in the current directory. You can also pass a path:

convert_epub("book.epub", "audiobooks/book.m4b", language="ko")

voice_path is an optional short WAV reference clip for voice cloning. If it is omitted, Chatterbox's bundled default conditionals are used.

Long chapters are split on EPUB paragraph boundaries. Paragraph pauses are preserved with inserted silence, and quoted dialogue is generated as separate, slightly more expressive audio segments.

The default audiobook pacing is intentionally slower than raw TTS:

• speed=0.9
• paragraph_pause_ms=600
• dialogue_pause_ms=300

M4B output requires ffmpeg on your PATH. During conversion, chatterbook shows one colored tqdm progress bar for the whole EPUB. Pass show_progress=False to disable it.

To export chapter WAV files instead of one M4B:

convert_epub(
    "book.epub",
    "audio",
    language="ko",
    output_format="wav",
)

Styles

• neutral: balanced default
• warm: slightly softer narration
• dramatic: more expressive narration

You can override a style with explicit generation values:

convert_epub(
    "book.epub",
    language="ko",
    exaggeration=0.7,
    cfg_weight=0.3,
)