Commands

Complete reference for all DemoVoice CLI commands.

demovoice init

Initialize a new DemoVoice project in the current directory.

demovoice init

Creates, inside the project directory (defaults to .demovoice/):

demovoice.yaml — main configuration
glossary.yaml — term pronunciation guide

If the config file already exists, init fails rather than overwriting it. Use --dir to target a different project directory or--config to write to a specific path.

demovoice inspect

Transcribe a video and report the detected narration segments without rendering. Use this to verify transcription before committing to a full render.

demovoice inspect input.mp4 [flags]

Options

Flag	Description
--output-script	Write an editable script YAML (segments, timings, text) you can later pass to `render --script`

Plus all global flags.

Example Output

$ demovoice inspect demo.mp4
config: /Users/you/work/demo/.demovoice/demovoice.yaml
preset: tech-demo
glossary: /Users/you/work/demo/.demovoice/glossary.yaml

00  0.000s -> 4.380s  (4.380s)  risk=low
Welcome to the product demo.

01  4.520s -> 8.460s  (3.940s)  risk=low
The next thing I'm going to do is actually create the factory.

02  8.600s -> 12.200s  (3.600s)  risk=medium
We'll wire up the OAuth flow and verify the webhook.

Export an Editable Script

If transcription gets a sentence wrong, export the timed script, edit it, and feed it back into render:

demovoice inspect demo.mp4 --output-script .demovoice/script.yaml

demovoice render

Re-voice a video with AI-generated speech, fitting each segment into the original timing window.

demovoice render input.mp4 --output output.mp4 [flags]

Options

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

Plus all global flags. To change voice, edit providers.tts.voice in your config or switch profiles with --profile.

Examples

# Basic render
demovoice render demo.mp4 --output demo.demovoice.mp4

# Render just the first 20 seconds while tuning settings
demovoice render demo.mp4 --preview-duration 20s --output preview.mp4

# Use a specific profile
demovoice render demo.mp4 --profile production --output demo.demovoice.mp4

# Render from a corrected script
demovoice render demo.mp4 --script .demovoice/script.yaml --output demo.demovoice.mp4

# Point at a project directory other than the current one
demovoice render demo.mp4 --dir ../my-project --output demo.demovoice.mp4

demovoice version

Print the current DemoVoice version.

$ demovoice version
0.1.0

See also: Global Flags for options available across all commands.