otter-vox

​

Usage

printf 'Welcome to Otter Shell.' | otter-vox --no-play | pw-play -  # pipe to PipeWire
printf 'Welcome to Otter Shell.' | otter-vox -o speech.wav           # save to file
otter-vox --voice bm_lewis --play 'Welcome to Otter Shell.'          # speak with voice
otter-vox --check-model                                               # verify model
otter-vox --list-voices                                               # list all voices

​

Voices

​

Output Options

• Default: plays audio through your system audio output
• --no-play: writes a raw WAV stream to stdout for piping to another program
• -o PATH / --output PATH: saves audio to a file instead of (or alongside) playing it
• -o speech.wav with playback enabled: saves the file and plays it at the same time

​

Configuration

model_dir = ""
output_path = "-"
playback = true
voice = "bm_george"
cpu_threads = 4

• model_dir: empty uses the embedded model, extracted at runtime. Set a directory path to use your own Kokoro model and voice files
• output_path: output destination (- for stdout)
• playback: play audio after synthesis
• voice: default voice name
• cpu_threads: thread count for inference