Voices and discovery

List voices

ttsforge voices
ttsforge voices --language en-us
ttsforge voices --engine kokoro
ttsforge voices --engine piper --model MODEL_ID

Filters include --engine, --language, --model, and --gender. Use --offline to avoid network discovery and --refresh to refresh cached catalog data. --json returns catalog items together with discovery information.

Human-readable output shows the canonical Readio voice ID (VoiceInfo.id) as the primary name, with the stable selector as a secondary alias when available. If a selector is not available, the qualified voice ID is shown instead. Voice listings may also include language/locale, model, engine, status, and runtime availability. Readio owns these identities; do not assume legacy Kokoro IDs or language-prefix conventions apply to every engine.

Inspect models and engines

ttsforge models
ttsforge models --engine kokoro --language en-us
ttsforge engines
ttsforge doctor

models reports Readio model/synthesis targets and their status. engines lists registered synthesis engines and their installed/runnable state. doctor includes missing runtime dependencies and format availability.

Use a discovered voice

For explicit --voice values, use the canonical voice ID or selector reported by Readio:

ttsforge convert novel.epub --engine kokoro --voice af_heart
ttsforge preview novel.epub --engine kokoro --voice af_heart

Guided selection during conversion

ttsforge convert uses the same Readio discovery services interactively on a TTY. It displays filtered engine, model, voice, and lexicon choices as compact vertical lists where selection is needed. Enter a row number or exact identifier. Voice entries show the canonical Readio voice ID first and the stable selector as an alias. Guided voice prompts accept a row number, canonical voice ID, selector, or qualified ID, then keep the selected row’s canonical ID. The catalog is filtered by the chosen language and engine, and by model for voices. ttsforge voices remains available for independent discovery, while explicit --model and --voice options bypass the matching prompts. Voice and model details are engine-specific. TTSForge does not implement voice blending, maintain voice recommendations, or promise that a voice selector will be available for every engine. See Readio’s catalog documentation for the public discovery contract.