XIL(1)

NAME
xil - unified dispatcher for xil-pipeline podcast production commands

SYNOPSIS
xil <command> [args...]
xil {-h|--help}
xil {-V|--version}

DESCRIPTION

xil is the unified entry point for the xil-pipeline audio production pipeline. It dispatches to one of the subcommands listed below, passing all remaining arguments through to the subcommand unchanged.

All subcommands are also available as standalone xil-* commands (e.g. xil-parse, xil-produce), which are installed alongside xil. The two interfaces are equivalent; use whichever you prefer.

PIPELINE STAGES
Run these in order for a typical episode:

init
    Workspace scaffolding — create project.json, speakers.json, sample script, and empty subdirectories. See xil-init(1).

scan
    Pre-flight script scanner — check a production script for unknown speakers and sections before parsing. See xil-scan(1).

parse
    Script parser — convert a markdown production script into structured JSON. See xil-parse(1).

cues
    Cues sheet ingestion — parse a sound cues markdown file into an asset manifest, audit the SFX library, and optionally generate assets. See xil-cues(1).

produce
    Voice stem generation — call the ElevenLabs TTS API to generate one MP3 stem per dialogue line. See xil-produce(1).

assemble
    Master audio assembly — two-pass multi-track mix of voice and SFX stems into a master MP3. See xil-assemble(1).

daw DAW layer export — export four isolated WAV layers for Audacity mixing. See xil-daw(1).

migrate
    Stem migration — diff old and new parsed JSON, copy unchanged stems, report what needs regeneration. See xil-migrate(1).

cleanup
    Stale stem cleanup — remove stems whose sequence number no longer matches the current parsed JSON. See xil-cleanup(1).

import
    Studio export import — extract dialogue stems from an ElevenLabs Studio export ZIP and rename them to pipeline convention. See xil-import(1).

regen
    Script regeneration — reconstruct a production script markdown from a parsed JSON. See xil-regen(1).

master
    Final master MP3 export — overlay the four DAW layer WAVs into a single podcast-ready MP3. See xil-master(1).

UTILITIES
Run these as needed at any stage:

voices
    Voice discovery — list ElevenLabs voices with enriched metadata; optionally back-fill cast JSON. Best run before parse/produce. See xil-voices(1).

csv-join
    CSV + SFX/cast annotation join — annotate a parsed episode CSV with SFX prompts and cast metadata. Best run after parse. See xil-csv-join(1).

sfx Standalone SFX generation — generate sound-effect stems independently of voice generation. Best run after cues/parse. See xil-sfx(1).

sample
    Voice sample generation — generate a short TTS sample for each cast member to audition voice assignments. Best run after voices/cast config. See xil-sample(1).

sfx-lib
    SFX library discovery — list and search the local shared SFX asset library. See xil-sfx-lib(1).

splice
    Parsed JSON splice utility — insert or delete entries with automatic seq renumbering. Advanced use. See xil-splice(1).

mp3-hash
    Recursive MP3 SHA-256 hash log — hash MP3 files for integrity auditing. See xil-mp3-hash(1).

OPTIONS

-h, --help
    Print help listing all subcommands and exit.

-V, --version
    Print the installed version and exit.

EXAMPLES
Scaffold a new workspace, then run the pipeline:

    xil init my-show --show "Night Owls"
    cd my-show
    xil scan scripts/sample_S01E01.md
    xil parse scripts/sample_S01E01.md --episode S01E01
    xil produce --episode S01E01 --dry-run
    xil produce --episode S01E01
    xil assemble --episode S01E01

FILES

project.json
    Show name declaration in the current working directory. Overridable with --show on most subcommands.

speakers.json
    Speaker definitions. Auto-detected in the current directory; override with --speakers on xil-scan and xil-parse.

ENVIRONMENT

ELEVENLABS_API_KEY
    API key for ElevenLabs TTS and sound-effect generation. Required by xil-produce, xil-sfx, xil-cues, xil-sample, and xil-voices when not using --dry-run.

SEE ALSO
xil-init(1), xil-scan(1), xil-parse(1), xil-cues(1), xil-produce(1), xil-assemble(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)

AUTHOR
John Brissette <xilcmd@gmail.com>