CLI Options

Exact command syntax for Rollberry's current capture and render subcommands.

Commands#

npx rollberry capture <url...> [options]
npx rollberry render <project.json> [options]

Option	Type	Default	Notes
`--out`	`string`	`./rollberry.mp4`	Output video path
`--viewport`	`string`	`1440x900`	`WIDTHxHEIGHT`
`--fps`	`number`	`60`	Maximum `120`
`--duration`	`number \| auto`	`auto`	Scroll duration
`--motion`	`ease-in-out-sine \| linear`	`ease-in-out-sine`	Scroll easing
`--timeout`	`number`	`30000`	Total navigation timeout in ms
`--wait-for`	`load \| selector:<css> \| ms:<n>`	`load`	Start condition
`--hide-selector`	`string`	none	Repeatable
`--force`	flag	`false`	Overwrite existing output
`--debug-frames-dir`	`string`	none	Save PNG frames
`--page-gap`	`number`	`0`	Pause between URLs
`--manifest`	`string`	`<out>.manifest.json`	Override manifest path
`--log-file`	`string`	`<out>.log.jsonl`	Override log path

Option	Type	Default	Notes
`--output`	`string`	all outputs	Repeatable named output filter
`--force`	flag	`false`	Overwrite configured output files

Most render behavior lives in the project JSON file, not on the command line.

npx rollberry capture https://example.com --out ./artifacts/example.mp4

npx rollberry capture \
  https://example.com \
  https://example.com/pricing \
  --page-gap 1.5 \
  --out ./artifacts/tour.mp4

npx rollberry capture http://localhost:3000 \
  --out ./artifacts/local.mp4 \
  --wait-for selector:#app

npx rollberry render ./rollberry.project.json

npx rollberry render ./rollberry.project.json --output desktop --output mobile