Struct Args 

struct Args {

    episode: Option<String>,
    tag: Option<String>,
    show: Option<String>,
    script: Option<String>,
    dry_run: bool,
    reconcile: bool,
    apply: bool,
    force: bool,
    start_from: i64,
    stop_at: Option<i64>,
    seq_list: Option<BTreeSet<i64>>,
    terse: bool,
    gen_sfx: bool,
    gen_music: bool,
    gen_ambience: bool,
    sfx_music: bool,
    local_only: bool,
    backend: String,
    chatterbox_python: Option<String>,
    voice_refs: Option<String>,
    device: String,
    sfx_backend: String,
    mmaudio_python: Option<String>,
    mmaudio_duration: f64,
    mmaudio_cfg: f64,
    mmaudio_steps: i64,
    mmaudio_negative_prompt: String,
    mmaudio_seed: Option<i64>,
    mmaudio_accept_noncommercial: bool,
}

Fields

episode: Option<String>

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

tag: Option<String>

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

show: Option<String>

Show name override (default: from project.json)

script: Option<String>

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

dry_run: bool

Preview all lines and TTS cost without API calls

reconcile: bool

Re-link existing stems to new seq filenames after a re-parse (reads stem manifest, proposes renames, no TTS calls). Add –apply to execute.

apply: bool

With –reconcile: execute the renames instead of dry-run preview.

force: bool

Overwrite existing stem files instead of skipping them. Use with –start-from/–stop-at or –seq-list to regenerate specific lines. WARNING: incurs ElevenLabs API cost for every stem in range.

start_from: i64

Start generation from sequence number N (for resuming)

stop_at: Option<i64>

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

seq_list: Option<BTreeSet<i64>>

Comma-separated list of exact sequence numbers to process (e.g. “12,45,88,203”), for regenerating a specific non-contiguous set of dialogue lines in one run — the TTS worker/subprocess is started once and reused across all listed seqs, instead of once per –start-from/–stop-at invocation. Takes precedence over –start-from/–stop-at when given. Dialogue only — does not affect –gen-sfx/–gen-music/–gen-ambience filtering. Combine with –force to actually overwrite stems that already exist on disk.

terse: bool

Truncate each line to 3 words to minimize TTS character cost

gen_sfx: bool

Generate SFX and BEAT stems

gen_music: bool

Generate music stems

gen_ambience: bool

Generate ambience stems

sfx_music: bool

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

local_only: bool

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

backend: String

TTS backend for dialogue voice stems.

chatterbox_python: Option<String>

Path to the Python executable in the chatterbox venv (default: auto-detect ./venv-chatterbox/bin/python3). Used with –backend chatterbox or chatterbox-turbo.

voice_refs: Option<String>

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.

device: String

Device for –backend chatterbox-turbo (default: cuda).

sfx_backend: String

Backend for SFX/music/ambience generation, independent of the dialogue –backend.

mmaudio_python: Option<String>

Path to the Python executable in the MMAudio venv (default: auto-detect ./venv-mmaudio/bin/python3). Used only with –sfx-backend mmaudio.

mmaudio_duration: f64

Generation length in seconds before trimming (default: 8.0, MMAudio’s training duration).

mmaudio_cfg: f64

MMAudio classifier-free guidance strength (default: 4.5).

mmaudio_steps: i64

MMAudio flow-matching sampling steps (default: 25).

mmaudio_negative_prompt: String

Optional MMAudio negative prompt (default: none).

mmaudio_seed: Option<i64>

MMAudio reproducibility seed (default: nondeterministic).

mmaudio_accept_noncommercial: bool

Acknowledge that MMAudio’s weights are CC BY-NC 4.0 (NON-COMMERCIAL USE ONLY) and that generated audio must not appear in a monetised production. Required for –sfx-backend mmaudio.

Trait Implementations

impl Args for Args

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::ArgGroup::id] for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

impl CommandFactory for Args

fn command<'b>() -> Command

Build a [Command] that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a [Command] that can update self.

impl FromArgMatches for Args

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for Args

fn parse() -> Self

Parse from std::env::args_os(), [exit][Error::exit] on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, [exit][Error::exit] on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, [exit][Error::exit] on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.