Cues
A show is a list of cues. Each one does a single thing when it is fired — play a sound, put a picture on an output, send a message, stop something else — and each has its own page here.
| Cue | What it does |
|---|---|
| Audio | Plays a sound file |
| Image | Puts a still picture on a video output |
| Video | Plays a video file on a video output |
| Text | Puts words on a video output |
| HTML | Embeds a web page on a video output |
| YouTube | Embeds a YouTube video on a video output |
| Webcam | Puts a camera on a video output |
| Visio | Puts a remote guest’s camera on a video output |
| Screen | Puts a shared screen on a video output |
| Multilaunch | Fires the cues it holds, all at once |
| Playlist | Fires the cues it holds, one after another |
| Fade | Fades another cue to a level |
| Fade all | Fades everything out |
| Start | Starts another cue |
| Stop | Stops another cue |
| Stop all | Stops everything |
| Load show | Opens another show |
| OSC | Sends an OSC message |
| MIDI | Sends a MIDI message |
| MQTT | Publishes an MQTT message |
| HTTP | Calls an HTTP endpoint |
What every cue has
Whatever its type, a cue carries:
| Setting | What it does |
|---|---|
| Number | How you refer to it — also what OSC control uses to fire it |
| Name | Free text, for you |
| Comment | Free text, shown in the cue list |
| Enabled | An unticked cue is skipped: GO passes over it, a group does not fire it |
| Colour | A tag colour in the cue list |
| Delay | Seconds between firing the cue and it actually starting |
| Fade in | Seconds to ramp up to level, for the cues that carry one |
| Auto follow | When it ends, fire the next playable cue |
| Script | JavaScript that runs with the cue — see scripting |
How a cue runs
Three shapes, which decide what “finished” means:
- Stays up — image, text, html, youtube, webcam, visio, screen, and the two group types. Runs until something stops it.
- Has a length — audio, video, fade, fade all. Ends on its own, and an auto-follow fires then.
- Fire and forget — osc, midi, mqtt, http, start, stop, stop all, load show. Does its thing and is gone.
Invalid cues
A cue the engine cannot play is marked Invalid in the list and is skipped: an audio cue with no file, a video cue with no output picked, a YouTube cue with no connection, a cue whose script is enabled but does not compile. The reason shows on the row.