XIL-SAMPLE(1)

NAME
xil-sample

SYNOPSIS
xil-sample [-h] (--episode TAG | --cast PATH) [--show SHOW] [--backend {elevenlabs,gtts,chatterbox}] [--chatterbox-python PATH] [--voice-refs DIR] [--exaggeration FLOAT] [--sample-text TEXT] [--dry-run] [--force]

DESCRIPTION
Generate a voice sample MP3 for each cast member via the chosen TTS backend.

OPTIONS

--episode TAG
    Episode tag (e.g. S02E03); derives cast config path

--cast PATH
    Explicit path to cast JSON file

--show SHOW
    Show name override (default: from project.json)

--backend {elevenlabs,gtts,chatterbox}
    TTS backend for sample generation. 'elevenlabs' (default) calls the ElevenLabs API and uses the voice_id from the cast config. 'gtts' generates a flat-voice draft via Google Translate TTS at no cost (ignores voice_id). 'chatterbox' uses local GPU TTS with zero-shot voice cloning from voice_refs/<key>.wav clips. Output lands in voice_samples/<TAG>/<backend>/ for side-by-side comparison.

--chatterbox-python PATH
    Path to the chatterbox venv Python (default: auto-detect ./venv- chatterbox/bin/python3). Used only with --backend chatterbox.

--voice-refs DIR
    Directory containing <speaker_key>.wav reference clips for Chatterbox zero- shot voice cloning (default: voice_refs/). Used only with --backend chatterbox.

--exaggeration FLOAT
    Chatterbox emotion exaggeration level: 0.0 = flat, 1.0 = dramatic (default: 0.5). Used only with --backend chatterbox.

--sample-text TEXT
    Override the sample text spoken by each voice. Use {name} as a placeholder for the speaker's full name. Default: "I am {name} not yo momma"

--dry-run
    Print what would be generated without calling any TTS API

--force
    Regenerate samples even if files already exist on disk

SEE ALSO
xil(1), xil-scan(1), xil-parse(1), xil-cues(1), xil-produce(1), xil-assemble(1), xil-studio-onboard(1), xil-daw(1), xil-migrate(1), xil-cleanup(1), xil-import(1), xil-regen(1), xil-master(1), xil-voices(1), xil-csv-join(1), xil-sfx(1), xil-sample(1), xil-sfx-lib(1), xil-splice(1), xil-mp3-hash(1), xil-migrate-workspace(1), xil-init(1)

AUTHOR
John Brissette <xilcmd@gmail.com>