Create setlist runner
create_setlist_runnerBuilds a wall-clock setlist player for VJ shows, auto-advancing through sequenced visuals with crossfades or hard cuts, and optional HUD overlay.
Instructions
Layer-1 wall-clock setlist player for rehearsed VJ shows. Pass rows[] of (source TOP, duration_seconds, transition_seconds) and the tool builds a baseCOMP containing N Select TOPs (one per row), a Switch TOP, a Cross TOP for crossfaded boundaries (hard cut when transition_seconds=0), an optional NOW/NEXT/remaining Text TOP HUD composited over the program, a Timer CHOP + CHOP Execute engine that auto-advances rows on wall-clock time, and live custom params Play/Row/Skip/Prev/Loop/Defaulttransition for stage overrides. Output is a Null TOP at <parent>/<name>/out. Fills the gap between create_clip_launcher (manual grid) and create_cue_sequencer (musical bars).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | Yes | Ordered setlist rows. Each row: { source, duration_seconds, transition_seconds }. | |
| sources_map | No | Optional `{ logical → TOP path }` to allow human-readable row sources like 'actA' instead of an absolute path. | |
| default_transition | No | Fallback `transition_seconds` (in seconds) for rows that omit it. | |
| loop | No | When the last row ends: wrap to row 0 (true) or stop (false). | |
| autostart | No | Start playing immediately on build. | |
| show_hud | No | Build the NOW/NEXT/remaining Text TOP HUD as a child output. | |
| name | No | Engine container name. | setlist |
| parent_path | No | Parent COMP path where the engine COMP is created (e.g. '/project1'). | /project1 |