Command line

The rot command loads a trusted project file, inspects media, checks dependencies, parses a draft with OpenRouter, finds source highlights, and publishes completed MP4s.

Command	Purpose
rot render FILE.py[:object] -o OUTPUT.mp4	Render a Project; -f permits replacing an existing output.
rot doctor	Verify FFmpeg, FFprobe, libass, H.264, AAC, and optional integrations.
rot probe ASSET [--json]	Print duration, streams, codecs, dimensions, and color metadata.
rot parse INPUT --model MODEL --speaker NAME	Convert a free-form draft to a validated .rot script.
rot clips TARGET [options]	Rank and export clips from a YouTube URL, a video file, or a folder.
rot publish VIDEO --config FILE.toml	Preflight and publish an existing MP4 through configured official APIs.

Use -v for diagnostic logs, -vv for source locations in tracebacks, and --json-logs for machine-readable logging. The renderer shows progress by default; pass --no-progress for non-interactive environments.

Outputs are written atomically. Existing files remain protected unless you pass --force.

See clip discovery for the clips options and OpenRouter parsing for parse. See publishing for TOML fields, environment variables, consent, and platform setup.