Skip to content

lakreet-swarm preview ​

Render one PNG frame per row for visual checking.

Synopsis ​

bash
lakreet-swarm preview --template T.ectemplate --data D.csv [options]

Options ​

OptionTypeDefaultDescription
--templatestringFILE EffectCraft template (.ectemplate)
--datastringFILE Data file (.csv/.tsv/.json/.jsonl)
--outstringoutDIR Output folder (default: out)
--clistringPATH Path to effectcraft-cli
--configstringlakreet.config.jsonFILE Config file (default: lakreet.config.json)
--namestring{index}-PATTERN Output name pattern (default: {index}-{first})
--onlystringLIST Select rows, e.g. 1,3,5-8
--limitstringN Process only the first N rows
--skip-existingstringSkip rows whose output already exists
--retriesstringN Extra attempts for a failed render
--fail-faststringStop at the first failure
--timeoutstringSEC Per-render timeout
--formatstringF h264
--resolutionstringR full
--qualitystringQ best
--fpsstringN Frame rate
--bitratestringKBPS Video bitrate
--audiostringMODE auto
--media-dirstringDIR Base folder for relative media paths
--keep-valuesstringKeep per-row values JSON files
--empty-as-defaultstringTreat empty text cells as template default
--dry-runstringValidate without rendering
--jsonstringMachine-readable NDJSON output
--quietstring
--no-colorstringDisable colour

Exit codes ​

CodeMeaning
0OK
1Render failed
2Usage error
3Invalid data
4effectcraft-cli not found
5Template unreadable
130Interrupted (Ctrl+C)

Examples ​

bash
# lakreet-swarm preview --template template.ectemplate --data data.csv --time 2.5

Independent project. Not affiliated with the ArtCraft team or the EffectCraft project.