CLI
genart render
Render a .genart sketch to an image
Render a .genart sketch to a PNG, JPEG, or WebP image. The sketch is loaded in a headless browser, rendered at the specified size and seed, then captured to a file.
Usage
genart render <file> [options]Arguments
| Argument | Required | Description |
|---|---|---|
<file> | Yes | Path to a .genart sketch file |
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--wait | string | 500ms | Time to wait after page load before capture (e.g. 1s, 200ms) |
--seed | number | Seed value for the random number generator | |
--params | JSON | Parameter overrides as a JSON string | |
--colors | JSON | Color palette override as a JSON array | |
--width | number | Canvas width in pixels | |
--height | number | Canvas height in pixels | |
--preset | string | Canvas size preset name (e.g. square-600) | |
--format | png | jpeg | webp | png | Output image format |
--quality | 0-100 | 80 | Image quality (JPEG/WebP only) |
--scale | number | 1 | Device pixel ratio for rendering |
-o, --output | path | Output file path (defaults to <name>.<format>) |
Examples
Render with default settings:
genart render my-sketch.genartRender at a specific seed and size:
genart render my-sketch.genart --seed 42 --width 1920 --height 1080Render as JPEG with custom quality:
genart render my-sketch.genart --format jpeg --quality 95 -o output.jpgOverride parameters and colors:
genart render my-sketch.genart \
--params '{"density": 0.8, "speed": 1.5}' \
--colors '["#FF0000", "#00FF00", "#0000FF"]'Render at 2x scale for high-DPI output:
genart render my-sketch.genart --scale 2 -o hi-res.pngWait longer for complex animations to settle:
genart render my-sketch.genart --wait 3s