Flags

Flags available across DemoVoice commands.

Global Flags

These flags are accepted by every subcommand.

Flag	Description	Default
--config	Path to a config file. Overrides directory discovery.	—
--dir	Project directory. Accepts either the project root containing `.demovoice/` or the `.demovoice/` directory itself.	.demovoice
--profile	Profile name from the config's `profiles:` map.	value of `profile:` in config (default `default`)
--verbose	Enable verbose logging on stderr.	false
--glossary	Extra glossary file path. Repeatable — pass once per file.	—
-h, --help	Show help for the command.	—

render Flags

Flags specific to the render command:

Flag	Description
-o, --output	Output MP4 path (required).
--preview-duration	Render only the first N of the source, e.g. `20s`, `1m`.
--script	Read an editable script YAML instead of transcribing.

inspect Flags

Flags specific to the inspect command:

Flag	Description
--output-script	Write an editable script YAML for later use with `render --script`.

Environment Variables

App-level config values can also be set via environment variables with the DEMOVOICE_ prefix (dots in YAML keys become underscores). Provider API keys are not stored in config — they always come from the environment.

Variable	Purpose
OPENAI_API_KEY	Required. Used for Whisper transcription and OpenAI TTS.
DEMOVOICE_PROFILE	Override the active profile.
DEMOVOICE_PROVIDERS_TTS_VOICE	Override the TTS voice.
DEMOVOICE_PROVIDERS_TTS_MODEL	Override the TTS model.

Any nested config key follows the same pattern: providers.stt.model becomesDEMOVOICE_PROVIDERS_STT_MODEL.