CLI
genart video
Render video from an animated sketch
Render an animated .genart sketch to video. Captures frames over a specified duration and encodes them to MP4, WebM, or GIF.
Usage
genart video <file> [options]Arguments
| Argument | Required | Description |
|---|---|---|
<file> | Yes | Path to a .genart sketch file |
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--duration | number | required | Video duration in seconds |
--fps | number | 30 | Frames per second |
--format | mp4 | webm | gif | mp4 | Output video format |
--codec | h264 | h265 | vp9 | Video codec (format-dependent) | |
--quality | 0-100 | 75 | Encoding quality |
--animate | string | Animate a parameter over time (repeatable, e.g. speed=0:10) | |
--easing | string | linear | Easing function: linear, ease-in, ease-out, ease-in-out |
--loop | number | 0 | Number of loops (0 = no loop, GIF only) |
--concurrency | number | 4 | Number of parallel frame renders |
--wait | string | 500ms | Time to wait before each frame capture |
--seed | number | Seed value | |
--params | JSON | Base parameter overrides | |
--colors | JSON | Color palette override | |
--width | number | Canvas width | |
--height | number | Canvas height | |
--preset | string | Canvas size preset | |
--scale | number | 1 | Device pixel ratio |
-o, --output | path | Output file path |
Examples
Render a 10-second MP4:
genart video my-sketch.genart --duration 10Render a high-quality 4K video:
genart video my-sketch.genart \
--duration 30 \
--width 3840 --height 2160 \
--codec h265 --quality 95 \
-o output-4k.mp4Animate a parameter over time with easing:
genart video my-sketch.genart \
--duration 5 \
--animate "density=0:1" \
--easing ease-in-outAnimate multiple parameters simultaneously:
genart video my-sketch.genart \
--duration 10 \
--animate "density=0:1" \
--animate "speed=1:5"Create a looping GIF:
genart video my-sketch.genart \
--duration 3 \
--format gif \
--loop 0 \
--width 400 --height 400 \
-o animation.gifRender at 60fps with parallel frame capture:
genart video my-sketch.genart \
--duration 15 \
--fps 60 \
--concurrency 8