General

Interface preferences.

Theme Switch between light and dark interface. Saved instantly.

Language Interface language. Saved instantly — the app reloads to apply.

Default Seed Finder text Custom test sentence used when opening the Seed Finder.

Payloads

Extra JSON fields sent alongside each backend request. Usually only needed for advanced tuning.

Voice Clone / Base params Extra fields for the 8020 WAV voice clone/base model.

Streaming params Extra fields for the 8023 streaming model.

CustomVoice params Extra fields for the CustomVoice backend.

Voice Design params (creating a new voice) Only the one-time call that designs a brand-new voice. Left unconstrained by default so different characters actually sound different — pinning temperature/seed here flattens that variety.

Voice Design params (reading a line) Every ONGOING line spoken by an already-designed voice — same stability as Voice Clone, since this is a fixed identity being read from, not a fresh design.

NVIDIA Magpie params Usually empty. Magpie accepts fixed speakers: sofia, aria, jason, leo, john.

NVIDIA Zeroshot params Optional multipart fields. The app supplies text, language, audio_prompt.

NVIDIA Flow params Optional multipart fields. The app also sends the saved reference transcript.

Kokoro FastAPI params Extra JSON fields for Kokoro. Usually empty — voice is selected from the dropdown.

VibeVoice params Extra JSON fields for VibeVoice. Usually empty — service only requires text.

Storage

Container paths for voice files. Match these to your Portainer volume mounts.

Voice scan directory

Contains active_voices, hidden_voices, sounds, and metadata.

Active voices directory

New cloned/exported voices are saved here.

Seed Finder Sample Files

Directory containing generated seed finder samples.

PT Files

Directory for saved embedding models (.pt files).

API Keys

Usually empty for local containers. Set a dummy value like sk-local if a backend requires an Authorization header.

TTS API key (optional)

Voice Design API key (optional)

Whisper API key (optional)

External API Access

The app's own key — required for anything calling its /api/* or /mcp routes from outside the browser (scripts, MCP clients, AI agents). The app's own UI never needs this; it's same-origin.

API key

Pass as header X-API-Key: <key> (or Authorization: Bearer <key>). Regenerating instantly invalidates the old key.

Require this key for external callers Off by default. When off, /api/* and /mcp are reachable by anyone who can reach this container — fine on a trusted local network, not for exposing beyond it. Turning this on does not affect the app's own UI.

Backup & restore

Export all voices and settings as a ZIP for backup or migration. API keys are excluded from exports.

Export voices Import voices

Logs

Recent server activity. Useful for debugging backend connections and API errors.

Click Refresh to load logs

About

TTS Voice Creator

Clone, design, and deploy custom voices using local AI backends. Compatible with Qwen3-TTS, Kokoro FastAPI, NVIDIA Magpie, and any OpenAI-compatible TTS/STT endpoint.

FastAPI Vanilla JS WaveSurfer.js v7 MDI v7.4.47

Releases & Changelog GitHub

MCP server, REST /speak endpoint, and global hotkey daemon are documented under Connect Apps.

Changelog

Settings