CLI

vml Command Line

Generate assets, render frames, and encode MP4s from VideoML.

View page source GitHub repo NPM: @videoml/cli

Generate

Generates timing JSON and audio assets from a VideoML DSL file. Uses .videoml/config.yml (falls back to .babulus/config.yml).

vml generate content/intro.babulus.xml
vml generate --watch content/intro.babulus.xml

Render

Renders PNG frames + MP4 from a script.json. Accepts timeline and audio overrides.

vml render   --script src/videos/intro/intro.script.json   --timeline src/videos/intro/intro.timeline.json   --frames .videoml/out/intro/frames   --out public/videoml/intro.mp4

Pipeline

Runs generate + render in one command.

vml pipeline content/intro.babulus.xml --out public/videoml/intro.mp4

Tip: use --project-dir when running from outside the repo root.