SCRIPTVOX  /  OPERATION MANUAL  /  VERSION 0.1.0

A script goes in.
A narrated, captioned video comes out.

ScriptVox is a command-line tool. You can use it directly, or a coding agent such as Claude Code can operate it for you.

you     make a 30 s vertical short in Arabic about dates, free tools only
agent   scriptvox plan, make --detach, wait, snapshot
result  scriptvox-out/r_7f3c9a.mp4, 30.0 s, $0, -14 LUFS, all gates passed

1Description

LicenceApache-2.0
PlatformsLinux and Windows. There is no macOS build at this time
FormOne binary. No account and no telemetry
Cost controlA plan that costs money stops until you approve it
RecoveryA run that stops continues from its last finished chunk
LanguagesEnglish and Arabic with no key. Arabic is shaped and right-to-left

2Examples

ScriptVox made each video on this page. The copies here have their recipe data removed.

English. 24 s, 9:16.
Arabic. 23 s, 9:16.

Stop and resume

A real session. A 30 s render is stopped with SIGKILL. The same command then continues from the finished chunks.

Terminal session: a render is killed, then the same command resumes from the finished chunks

3Functions

Self-checkEach video goes through gates over each frame: black stretches, slideshow risk, silence, loudness (-14 LUFS) and audio/video drift
Captions that fitLine breaks are measured with real text shaping, within 0.5% of the renderer
Target length--duration 30 fits the voice before the render starts. A script that cannot fit stops with "cut about N words"
Your clipsPoint --media at a folder of clips and photos. Shots cut on the rhythm of the speech
CardsTitle, stat, list, bars, line, plot, donut, timeline, compare, quote, formula and code, drawn in the same pass as the captions
Money controlA plan lists stages, cost and downloads. A plan that costs more than $0 needs --approve <plan_id>
Recipe in each videoThe MP4 metadata holds the brief and the plan, and no keys. explain, replay and remake use it
KeysArguments, logs, results and the MP4 contain no key

4Installation

NOTE: There is no published release at this time. The commands below become available at the first release.

  1. Install ScriptVox.
  2. Run the test. It renders a video of 8 seconds with no keys, no Python and no Node. 
    scriptvox demo
  3. Make your first video. 
    echo "ScriptVox turns a script into a video." > script.txt
scriptvox make --script script.txt --music calm

On first use, ScriptVox downloads a pinned FFmpeg build into its data folder and checks its sha256. The installation runs without sudo and makes no change to your shell profile.

5Operation by an agent

With --json, each command prints one JSON document with fixed exit codes and a fix line. Most commands are also available as MCP tools.

1scriptvox plan --brief brief.json --jsonThe cost and a plan_id. Nothing runs
2scriptvox make --brief brief.json --detach --jsonA run_id. The run continues in the background
3scriptvox wait <run_id> --jsonThe result, with the path of the video
4scriptvox check <run_id> --jsonOne row for each quality gate

CAUTION: An agent must not approve a plan by itself. The approval belongs to the person.