How elmatthe/audiobook-creation-tool works
Audiobook Creation Tool is a Windows/macOS desktop app for turning PDF/TXT books into narrated audio, then preparing audiobook files and cover art. The main user journey is launch the app, choose a voice and source, synthesize speech, and export audio; users can also combine, convert, and tag existing audio. Voice installation and platform-specific engine availability are distinct setup stages. The graph includes major README capabilities and a shared runtime layer. Several implementation links are unverified because the relevant source was not excerpted, so they are dashed rather than asserted as observed calls.
Main entry points: epub2tts_gui.py TTS Audiobook · pipeline.py Speech preparation · launcher.py App launcher · kokoro_synth.py Kokoro synthesis
Components 22
Desktop app
- App launcher
scripts/launcher.py - TTS Audiobook
scripts/tts/epub2tts_gui.py
Narration
- PDF extraction
scripts/tts/pdf_extractor.py - Speech document
scripts/tts/speech/document.py - Speech preparation
scripts/tts/speech/pipeline.py - Voice registry
scripts/tts/voice_registry.py - Engine policy
scripts/shared/engine_policy.py - Kokoro synthesis
scripts/tts/kokoro_synth.py - Chatterbox synthesis
scripts/tts/chatterbox_synth.py - Qwen3 runtime
scripts/tts/qwen3_runtime.py - OmniVoice synthesis
scripts/tts/omnivoice_synth.py - Audio publication
scripts/tts/publication.py
Voice setup
- Optional voice setup
scripts/tts/optional_setup.py
Audiobook tools
- MP3 tools
scripts/mp3/mp3_tool.py - M4B maker
scripts/m4b/maker/m4b_maker.py - M4B converter
scripts/m4b/converter/m4b_converter.py - Metadata editor
scripts/m4b/metadata/m4b_metadata_editor.py - Cover artwork
scripts/artwork/m4b_artwork_ui.py
Shared runtime
- FFmpeg integration
scripts/shared/ffmpeg_utils.py - Book workspace
scripts/shared/book_workspace.py - Configuration
scripts/shared/config.py
Other components
- Reader
Connections 24
- Reader → App launcher: starts
README.md - App launcher → TTS Audiobook: opens
- Reader → TTS Audiobook: chooses source
README.md - TTS Audiobook → PDF extraction: loads PDF
- PDF extraction → Speech document: provides text
- Speech document → Speech preparation: prepares text
scripts/tts/speech/pipeline.py - TTS Audiobook → Voice registry: selects voice
- TTS Audiobook → Engine policy: checks availability
- Speech preparation → Kokoro synthesis: prepares route text
scripts/tts/kokoro_synth.py - Speech preparation → Chatterbox synthesis: prepares route text
scripts/tts/chatterbox_synth.py - Speech preparation → Qwen3 runtime: prepares route text
- Speech preparation → OmniVoice synthesis: prepares route text
- TTS Audiobook → Optional voice setup: installs on demand
README.md - Kokoro synthesis → Audio publication: exports audio
- Chatterbox synthesis → Audio publication: exports audio
- Reader → M4B maker: combines audio
README.md - Reader → M4B converter: converts audio
README.md - Reader → Metadata editor: edits tags
README.md - Reader → Cover artwork: prepares covers
README.md - Reader → MP3 tools: works with MP3
- Kokoro synthesis → FFmpeg integration: exports via
scripts/tts/kokoro_synth.py - Chatterbox synthesis → FFmpeg integration: uses audio tools
scripts/tts/chatterbox_synth.py - TTS Audiobook → Book workspace: uses workspace
- App launcher → Configuration: loads settings