-
Notifications
You must be signed in to change notification settings - Fork 4
Home
Welcome to the Audiobook Studio documentation.
This wiki is meant to help both new users and contributors understand how the app works, how to get started, and what has changed across release lines.
Choose the setup path that matches your comfort level:
Use Audiobook Studio on Pinokio
Pinokio handles setup and launch for you, and can optionally install demo content for a faster first look.
Open the Live Demo / Showcase
Hear samples, review features, and see how the workflow works before installing anything.
Use the Main GitHub Project
Best for developers and advanced users who want direct control over setup and files.
If you are new to GitHub or terminal setup, start with Pinokio.

For brand-new users, the current 1.8.x release line is the best place to begin. That release family is the first one intended to feel smooth across local XTTS production and optional Voxtral support:
- first-run setup
- launcher scripts
- voice portability
- engine-per-voice assignment
- chapter generation
- rebuild and queue UX
- audiobook download flow
- Pinokio Install - Easiest install path
- Live Demo / Showcase - Hear examples and preview the app
- Getting Started - Recommended setup and first run
- Concepts - Core architecture and terminology
- Library and Projects - Managing books and assemblies
- Voices and Voice Profiles - AI Voice Lab guide
- Queue and Jobs - Monitoring generation and repair work
- Comparison and Cost - Hosted vs local tradeoffs
- Recording Guide - Best practices for clean voice samples
- Troubleshooting and FAQ - Help when something acts possessed
- Run
./run.shon macOS/Linux orrun.ps1on Windows. - Open
http://127.0.0.1:8123. - Create a project from the Library.
- Add a chapter and paste or import text.
- Build or import a voice profile.
- Assign narration and character voices.
- Generate chapter audio and assemble the audiobook.
If you want a simple onboarding project, create a short 2-3 chapter sample and assign:
- one narrator voice
- one younger dialogue voice
- one older or contrasting dialogue voice
That gives you the clearest first impression of:
- chapter editing
- segment repair
- multi-voice assignment
- final audiobook export
To preview these docs locally before pushing to GitHub:
- Open this folder in VS Code.
- Open
Home.md. - Press
Cmd+Shift+Von Mac orCtrl+Shift+Von Windows to open Markdown Preview.