XIL-PRODUCE(1)

NAME
xil-produce

SYNOPSIS
xil-produce [-h] (--episode EPISODE | --tag TAG) [--show SHOW] [--script SCRIPT] [--dry-run] [--start-from START_FROM] [--stop-at STOP_AT] [--terse] [--gen-sfx] [--gen-music] [--gen-ambience] [--sfx-music] [--local-only] [--backend BACKEND] [--chatterbox-python PATH] [--voice-refs DIR] [--exaggeration FLOAT]

DESCRIPTION
Voice Generation — generate voice stems via ElevenLabs

OPTIONS

--episode EPISODE
    Episode tag (e.g. S01E01) — derives cast and SFX config paths

--tag TAG
    Raw tag for non-episodic content (e.g. V01C03, D01)

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

--script SCRIPT
    Path to parsed script JSON (default: derived from cast config)

--dry-run
    Preview all lines and TTS cost without API calls

--start-from START_FROM
    Start generation from sequence number N (for resuming)

--stop-at STOP_AT
    Stop generation at sequence number N, inclusive (for previewing a section)

--terse
    Truncate each line to 3 words to minimize TTS character cost

--gen-sfx
    Generate SFX and BEAT stems

--gen-music
    Generate music stems

--gen-ambience
    Generate ambience stems

--sfx-music
    (deprecated) shorthand for --gen-sfx --gen-music --gen-ambience

--local-only
    Only place stems for effects already present in SFX/; skip API generation

--backend BACKEND
    TTS backend for dialogue voice stems. 'elevenlabs' (default) calls the ElevenLabs API. 'gtts' generates a flat-voice draft via Google Translate TTS at no cost — all characters sound the same, useful for checking episode duration before spending API credits. 'chatterbox' uses local Chatterbox TTS with per-character voice cloning from voice_refs/<key>.wav reference clips — near-production quality, free, GPU-accelerated. Requires: pip install xil- pipeline[tts-alt] (gtts) or a configured venv-chatterbox (chatterbox).

--chatterbox-python PATH
    Path to the Python executable in the chatterbox venv (default: auto-detect

--voice-refs DIR
    Directory of <speaker_key>.wav reference clips for Chatterbox zero-shot voice cloning (default: voice_refs/). Missing refs fall back to Chatterbox's default voice.

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

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>