Cues

A cue is a lighting state with timing. It contains references to presets and the fixtures they apply to, along with fade times and optional delay times.

Adding a cue to a sequence

seq 1 cue 1 "Intro" fade 3seq 1 cue 2 "Verse" fade 2seq 1 cue 2.5 "Bridge" fade 1.5   -- decimal cue numbers are allowed

Cue numbers can be integers or decimals. Decimal cue numbers let you insert cues between existing ones without renumbering.

Cue content

A cue is built from CueItems — each item references a preset and a fixture selection. Multiple cue items can be combined in a single cue to build complex looks.

Add a preset item to a cue:

seq 1 cue 1 item add preset 3.1 group 1    -- apply color preset 3.1 to group 1seq 1 cue 1 item add preset 1.1 group 1    -- also apply dimmer preset 1.1seq 1 cue 1 item add effect 1.1 group 2    -- add effect 1.1 on group 2

Remove an item:

seq 1 cue 1 item remove 0    -- remove item at index 0

List items in a cue:

seq 1 cue 1 items

Cue timing

Each cue has a fade time (how long values take to reach their target) and an optional delay time (how long to wait before the fade starts).

seq 1 cue 2 time fade 2 delay 0.5

Cue follow types:

Type	Description
go	Wait for manual Go command (default)
follow	Automatically go to the next cue when fade completes
time 3.0	Automatically go after 3.0 seconds

seq 1 cue 2 type follow     -- auto-follow when fade completesseq 1 cue 3 type time 5.0   -- auto-go after 5 secondsseq 1 cue 4 type go         -- manual go (default)

Spatial timing

Spatial timing distributes fade and delay times across fixture positions in a group's grid layout. Instead of all fixtures fading at once, they cascade in a wave from one side to the other.

Example — fan a 0.5-second delay across the X axis of group 1:

seq 1 cue 2 item 0 timing delay_x 0 0.5

This causes fixtures on the left side of the group to start their fade 0 seconds late, and fixtures on the right side to start 0.5 seconds late — creating a left-to-right wave effect.

You can control X and Y axes independently. This requires a Grid Layout on the group.

Updating a running cue

While a cue is playing on an executor, you can merge changes from the programmer into it:

update 1    -- merge programmer into the current cue on executor 1

Deleting a cue

seq 1 cue 2 delete

Cue release

A cue release makes the executor release (go dark or hand back control) at the end of the last cue:

seq 1 cue 10 release on fade 3    -- release after cue 10 with a 3-second fade