Kokoro TTS GUI · text-based audio editor

Edit the words.
The audio follows.

KokoroGUI is a text to speech editor where the transcript is the project. Every line belongs to a character, every character has a voice, and the timeline underneath is generated from the text. Change a word and only that clip generates again. Everything runs on your machine, free and open source.

the-house.tbaw1 clip stale
Narrator
The house at the end of the lane had been empty for years.
Marta
Then why is the kitchen light on?
Narrator
She pushed the door. It didn't creak. [pause:0.8]
TomasFX: Radio
Marta, come in. Marta?
KokoroGUI: the transcript with its character gutter and the settings tabs above a timeline with waveforms, a playhead and the transport
The Advanced workspace as it opens the first time.Every panel docks, stacks into tabs or floats wherever you put it, and each workspace remembers your layout.
How it works

Four moves, and the text stays in charge

01 Write
Type, paste or import a .txt, .pdf, .epub or subtitle file. Or import a recording: Whisper writes its words into the transcript and each word stays tied to where it was said.
02 Assign
Select a line and give it a character. Or type [Marta]: in front of it. Each character has a voice, an engine and an FX, and its text is tinted in its color.
03 Generate
Press Generate and only the stale lines generate. Each clip is keyed by its text, voice, speed, language and engine version. Change one of those and the clip is stale. Change anything else and it isn't.
04 Mix
Play it, drag it, fade it, duck it, export it. FX, volume and pitch are applied when a clip plays, so moving a slider never costs a regenerate. Export writes one file, with subtitles and a cue sheet if you want them.
Why it's different

A TTS editor built on the script, and the only one built this way

Text to speech apps give you a text box and a file. Audio editors give you a timeline and no text. KokoroGUI joins the two at the clip: the words decide what each clip says, and the timeline decides where it plays. Edit either one and the other keeps up.

Typical TTS app Typical audio editor KokoroGUI
Where you workA text boxWaveforms on a timelineThe script, with a multitrack timeline built from it
Change one wordGenerate the whole file againRe-record it, or splice by handThat line regenerates. Nothing else does
Several speakersOne voice per run, stitched by handOne track per recordingA character per line, each with its own voice and engine
EffectsBaked into the outputNon-destructiveApplied at playback, so a slider move never costs a regenerate
VersionsOverwrittenSaved copiesTakes per clip, with review status and notes
The projectLoose audio filesA session folderOne .tbaw file holding text, audio, voices and presets
Workflows

One project format, four kinds of work

Pick what you're making. The same transcript, timeline and .tbaw file handle all of them; what changes is which tools you reach for.

Drop in an EPUB and get one subproject per chapter, with the same cast reading every one.

the-long-road.tbaw › Chapter 314 clips · 11:52
Narrator
Chapter Three. The rain had not stopped for a week, and Dr. Ellery had stopped pretending not to notice.
Ellery
"We leave at first light," he said.
  • A book is a project, a chapter is a subprojectFile menuNew from text file splits an EPUB, or a PDF with a table of contents, at its chapters. Generate works through every stale chapter in turn.
  • One cast for the whole seriesCharactersThe character library holds the narrator and every regular. Change a voice there and every book that uses it follows.
  • Sentence-sized piecesSettingsText is generated about 40 words at a time and cut at paragraph, sentence or pause boundaries, never mid-word, and never after "Dr.".
  • Names said rightLexiconFind-and-replace rules fix a name everywhere it appears, and mark only the clips they change as stale.
  • Chapter files and subtitlesExportExport a file per chapter, or just the stretch between two markers, with an .srt timed to the audio.
Features

Everything is a layer on the text

Voices, clips, takes, FX and word timings all hang off the transcript. Edit it however you like and the layers keep up.

Transcript

MSAD

Each run of text is tinted by its character. The gutter names the speaker when it changes and puts a play button beside every stale clip, so you can regenerate one line without touching the rest. During playback the spoken word lights up; Ctrl+click a word to jump there.

Transcript reference →

Timeline

MSAD

Clips follow the text in order with a pause between them, or sit where you drag them. When a regenerated clip comes back longer, the clips after it ripple. Markers, loops, timecode, and Shift+drag inside a clip to replace a few words with fresh speech.

Timeline reference →

Mixer

MSAD

Mute, solo, fader, pan, a volume automation lane and ducking on every track. Fades on every clip. Playback mixes in stereo in the audio callback, and export uses the same mixer, so what you hear is what you get.

Playback reference →

FX

MSAD

Seventeen Pedalboard effects, a convolution reverb among them, set for the project, a character or one clip. They're applied when a clip plays, so a slider move is heard on the next pass and never marks anything stale.

FX reference →

Characters

MSAD

A character is a name, a color, a voice, an engine and an FX. Keep them in a library every project shares, or local to one file. Kokoro and Audio8 characters can talk to each other in the same scene.

Characters reference →

Tags

MSAD

Type [Marta]: at the start of a line and the line is Marta's when you press Enter. [pause:1.5] puts a second and a half before the next clip. Auto-split turns a whole tagged transcript into clips in one go.

Tags guide →
Engines

Two local engines, picked per character

Each character chooses its engine in Edit > Characters, so a Kokoro narrator can introduce an Audio8 clone. The Settings and Voices tabs follow whichever character's clip you've selected.

Kokoro hexgrad/kokoro · default Audio8 Audio8-TTS-Preview-0.6b
VoicesBuilt-in voices, plus your own Mixes from the Voices tabCloned from a Reference: a short WAV and its transcript
LanguagesAmerican and British English, Spanish, French, Italian, Portuguese, Japanese, ChineseWhatever the reference speaks
Speed0.5x to 2x, and Fit to slot regenerates at a new speedIts own pace; Fit to slot time-stretches instead
Word timingReported by the engine in EnglishFrom a Whisper pass after generating
Sample rate24,000 Hz44,100 Hz
Parallel generationOne pipeline per threadOne shared model, one segment at a time
LicensingApache-2.0Check the model card. Transcribing a reference uses Whisper (MIT) by default; Vosk is the offline Apache-2.0 option
Signal chain

Raw on disk, FX on the way out

A generated clip is saved as the model made it. These six steps run, in this order, whenever it's played, drawn on the timeline or exported.

INSERT 1

Trim

Leading and trailing silence, if on

INSERT 2

Volume

A plain gain

INSERT 3

Pitch

By resampling, so length changes too

INSERT 4

Stretch

Only when Fit to slot set one

INSERT 5

FX chain

Every enabled Pedalboard effect

INSERT 6

Normalize

Peak to 98% of full scale

The file

The format is named after the idea

.tbaw stands for text-based audio workflow. It's a zip with a manifest: the text, the clips, every generated segment, and the voices and presets the project uses.

  • Opens on another machine. Mixes, References, saved FX and impulse responses ride inside it.
  • Never half-written. Save runs in the background into a temp file and swaps it in. Autosave writes to a working copy, not your file.
  • Recovers after a crash. Reopen the project and it offers the unsaved session, even if the file was renamed or moved.
  • Small when you want it. Leave the generated audio out and the file is just text and settings; clips regenerate on open.
the-house.tbaw
manifest.json        format, version, stats, hashes
document.json        text, clips, tracks, characters
project.json         export and bundle options
audio/generated/
  3f9a…c2_0.wav      one file per segment
audio/imported/
  9b1e…04.flac       music beds, recordings
fx/
  Radio.json         saved FX
  ir/kitchen.wav     impulse responses
projects/
  chapter-2.tbaw     embedded subprojects
engines/kokoro/voices/
  narrator_mix.pt    Kokoro Mixes
engines/audio8/refs/
  marta.wav          Audio8 Reference
  marta.txt          and its transcript
What's new

The latest release

The short version. Every change in full, back to 3.1, is on the changes page.

4.0.0-beta.2 LATEST RELEASE

Dubbing, a mixer and a shared cast

Import subtitles as clips locked to their cues, fit each line to its slot, and dub against the original dialogue with a reference video playing along. Tracks get mute, solo, faders, pan, automation and fades; clips get takes, pauses between them and ripple on regenerate. Characters can live in a library every project shares and pick their own engine, and a project can hold subprojects.

Also new: music beds with ducking, editing a recording by editing its text, convolution reverb, word-level highlighting, markers, loops and timecode, Whisper as the default transcriber, and a Settings window under Options that holds the program and project settings. FX changes now render in the background, so a long project no longer freezes.

4.0.0-beta.1

A document, not a text box

The rebuild: a PySide6 app over a document with clips, tracks and characters, a timeline in seconds, non-destructive FX, undo and redo, projects in one .tbaw file, and Audio8 voice cloning beside Kokoro.

FAQ

Questions people ask first

What is KokoroGUI?

A free, open-source desktop app for text to speech that works as a text-based audio editor. You write or import a script, assign each line to a character, and KokoroGUI generates the audio onto a multitrack timeline you can mix and export. It started as a GUI for the Kokoro TTS model and now runs Audio8 voice cloning beside it.

Is there a GUI for Kokoro TTS?

Yes, this is one. KokoroGUI runs hexgrad/kokoro locally with every built-in voice, voice mixing, speed and language settings, and a full editor around it. You don't need to write Python to use it.

What is a text-based audio editor?

An editor where you change audio by changing its words. In KokoroGUI that goes both ways: edit the script and the changed lines regenerate; import a recording and Whisper puts its words in the transcript, so deleting a word cuts it from the audio.

Is it free? Does it run offline?

It's free under Apache-2.0. The models download from Hugging Face the first time you use them, and after that generation runs on your own CPU or GPU with no account and no upload.

Can it clone a voice?

Yes. The Audio8 engine clones a voice from a short WAV and its transcript, and KokoroGUI can transcribe the WAV for you. A Kokoro character and an Audio8 character can speak in the same scene.

What can I make with it?

Audiobooks from EPUB or PDF, dubbed video from subtitle files, podcasts and radio drama with music beds, and game or animation dialogue with takes and a cue sheet. See the workflows.

Which systems does it run on?

Windows, macOS and Linux, anywhere Python 3.11 and eSpeak NG install. A GPU speeds things up but isn't required.

Install

From clone to first line

Python 3.11 or newer and eSpeak NG. Models download from Hugging Face the first time you use them.

4.0 is a beta. 4.0.0-beta.2 is the latest release tag. --branch takes a tag name, and dropping it gets the default branch. The aim is for every 4.x release to open a .tbaw from any earlier 4.x.

Looking for 3.2.0, the old one-text-box app? It's frozen. Clone the 3.2.0 tag with --branch 3.2.0 and follow its own README. Only presets/ and custom_voices/ carry over.

Terminal
# clone the latest beta tag
git clone --branch 4.0.0-beta.2 --depth 1 https://github.com/CoffeeMethod/KokoroGUI.git
cd KokoroGUI

# virtual environment
python -m venv .venv
.venv\Scripts\activate       # Windows
source .venv/bin/activate    # macOS / Linux

# install and run
pip install -r requirements.txt
python main.py               # or run.bat on Windows
eSpeak NG
# Windows: run the installer from
https://github.com/espeak-ng/espeak-ng/releases

# macOS
brew install espeak-ng

# Debian / Ubuntu
sudo apt install espeak-ng

# Fedora
sudo dnf install espeak-ng

Python 3.11+

The only hard version requirement.

eSpeak NG

Kokoro needs it to turn text into phonemes. Install it before the first run.

A GPU is optional

Everything runs on the CPU. Options > Device picks CUDA when PyTorch finds one.

First use downloads models

Kokoro and Audio8 come from Hugging Face; Audio8 loads with trust_remote_code=True. Whisper is about 1.6 GB and asks before it downloads.

Smaller or offline transcription

Copy .env.example to .env. Set WHISPER_MODEL to small, base or tiny, or VOSK_MODEL_PATH to use Vosk.

Trouble with torch?

Follow pytorch.org for your OS and GPU before pip install -r requirements.txt.