lakreet-swarm render
Render a batch of videos from a template and data file.
Synopsis
bash
lakreet-swarm render --template T.ectemplate --data D.csv [options]Options
| Option | Type | Default | Description |
|---|---|---|---|
--template | string | FILE EffectCraft template (.ectemplate) | |
--data | string | FILE Data file (.csv/.tsv/.json/.jsonl) | |
--out | string | out | DIR Output folder (default: out) |
--cli | string | PATH Path to effectcraft-cli | |
--config | string | lakreet.config.json | FILE Config file (default: lakreet.config.json) |
--name | string | {index}- | PATTERN Output name pattern (default: {index}-{first}) |
--only | string | LIST Select rows, e.g. 1,3,5-8 | |
--limit | string | N Process only the first N rows | |
--skip-existing | string | Skip rows whose output already exists | |
--retries | string | N Extra attempts for a failed render | |
--fail-fast | string | Stop at the first failure | |
--timeout | string | SEC Per-render timeout | |
--format | string | F h264 | |
--resolution | string | R full | |
--quality | string | Q best | |
--fps | string | N Frame rate | |
--bitrate | string | KBPS Video bitrate | |
--audio | string | MODE auto | |
--media-dir | string | DIR Base folder for relative media paths | |
--keep-values | string | Keep per-row values JSON files | |
--empty-as-default | string | Treat empty text cells as template default | |
--dry-run | string | Validate without rendering | |
--json | string | Machine-readable NDJSON output | |
--quiet | string | ||
--no-color | string | Disable colour |
Exit codes
| Code | Meaning |
|---|---|
| 0 | OK |
| 1 | Render failed |
| 2 | Usage error |
| 3 | Invalid data |
| 4 | effectcraft-cli not found |
| 5 | Template unreadable |
| 130 | Interrupted (Ctrl+C) |
Examples
bash
# lakreet-swarm render --template template.ectemplate --data data.csv