CLI
genart montage
Compose a grid of images into a montage
Compose multiple rendered images into a single grid montage. Useful for visualizing seed ranges, parameter sweeps, or comparing variations side by side.
Usage
genart montage <source> [options]Arguments
| Argument | Required | Description |
|---|---|---|
<source> | Yes | Directory of images or glob pattern |
Options
| Flag | Type | Default | Description |
|---|---|---|---|
--columns | number | Number of columns in the grid | |
--rows | number | Number of rows in the grid | |
--tile-size | WxH | Size of each tile (e.g. 200x200) | |
--gap | px | 2 | Gap between tiles in pixels |
--padding | px | 0 | Padding around the entire montage |
--background | hex | #0A0A0A | Background color |
--label | string | Label each tile: seed, params, filename, index, or none | |
--label-color | hex | Label text color | |
--label-font-size | number | Label font size in pixels | |
--sort | string | Sort tiles by seed, name, or param:<key> | |
-o, --output | path | montage.png | Output file path |
Examples
Create a montage from a directory of renders:
genart montage renders/Specify grid dimensions and tile size:
genart montage renders/ --columns 10 --rows 5 --tile-size 200x200Add labels showing the seed for each tile:
genart montage renders/ --label seed --label-color "#FFFFFF"Sort by a parameter value:
genart montage renders/ --sort "param:density" --label paramsCustom styling with padding and background:
genart montage renders/ \
--columns 8 \
--gap 4 \
--padding 16 \
--background "#1A1A2E" \
-o gallery.pngCombine batch and montage in a pipeline:
genart batch my-sketch.genart --seeds 1-64 -o renders/
genart montage renders/ --columns 8 --label seed -o overview.png