CLI
genart batch
Generate many renders — seed ranges, parameter sweeps
Generate multiple renders from one or more sketches by iterating over seed ranges, sweeping parameters, or sampling random configurations.
Usage
genart batch <files...> [options]Arguments
| Argument | Required | Description |
|---|---|---|
<files...> | Yes | One or more .genart sketch files |
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--seeds | range | Seed range to iterate (e.g. 1-100, 1,5,10) | |
--sweep | string | Parameter sweep definition (repeatable, e.g. density=0:1:0.1) | |
--random | number | Number of random configurations to generate | |
--matrix | boolean | Generate all combinations of sweep values | |
--concurrency | number | 4 | Number of parallel renders |
--naming | pattern | {id}-{seed} | Output file naming pattern |
--manifest | boolean | Write a JSON manifest of all renders | |
--wait | string | 500ms | Time to wait before capture |
--params | JSON | Base parameter overrides | |
--colors | JSON | Color palette override | |
--width | number | Canvas width | |
--height | number | Canvas height | |
--preset | string | Canvas size preset | |
--format | png | jpeg | webp | png | Image format |
--quality | 0-100 | 80 | Image quality |
--scale | number | 1 | Device pixel ratio |
-o, --output-dir | path | Output directory |
Examples
Render seeds 1 through 50:
genart batch my-sketch.genart --seeds 1-50Sweep a parameter across a range:
genart batch my-sketch.genart --sweep "density=0:1:0.1"Combine multiple sweeps as a full matrix:
genart batch my-sketch.genart \
--sweep "density=0:1:0.5" \
--sweep "speed=1:5:1" \
--matrixGenerate 20 random variations:
genart batch my-sketch.genart --random 20Batch multiple files with custom naming and manifest:
genart batch sketches/*.genart \
--seeds 1-10 \
--naming "{title}-{seed}" \
--manifest \
-o renders/Render at high resolution with parallelism:
genart batch my-sketch.genart \
--seeds 1-100 \
--width 3840 --height 2160 \
--concurrency 8 \
--format jpeg --quality 95