Cues
The moments your cockpit answers by itself, such as the cold start, the engine firing, a flag, a personal best or a car alongside. What each one does, where it plays, and what is free.
A cue is a short light show that your rig plays at a moment of the session. The cockpit stays dark until you start the car. The lights sweep up as the engine fires. The rig floods yellow when a yellow flag comes out, and it blooms purple on a personal best.
You don’t build cues. The Cues page is a fixed list of 26 moments, and each one has a card. You decide which moments play and which devices they play on.
Plans. Every preview is free, both in the plugin and on your devices. In game, the Cold start with your start and stop cues, and the Cockpit moments (Boot, Game start and quit, Profile switch), play on every plan, Club included. Every other cue plays in game with Pro: the race, flag, spotter and car moments, and the idle cues. Flag information is never part of this: on every plan, flag keys, the Flags animation and the Flags message keep showing the flag that is out.
The Cues page
The page has seven tabs. The count beside a tab shows how many of its moments are on.
| Tab | What it covers |
|---|---|
| Cockpit | The rig itself: SimDeckOS starting, a sim connecting, a profile change. |
| Cold start | The cockpit stays dark until the car is live, then wakes in the order you start it. |
| Start & stop | One choreography as the engine fires, and its twin as it stops. |
| Race | A best lap, the pits, the last lap, places, sectors, push-to-pass. |
| Flags | A flag coming out, held quietly until it clears. |
| Spotter | A car alongside, three wide, a side clearing, a car closing fast. This is the only place the spotter lives. |
| Car & track | Fuel running out, a hit, rain arriving. |
Each card has these parts:
- The moment’s name and its trigger. The trigger is plain text; you can’t edit it.
- A switch. It turns the moment on or off.
- A ▶ button. It plays the moment on your devices.
- The cue’s tiles. Hover over a tile to watch it in the plugin. Click a tile to play it on your rig.
A tile that a device can’t show is dimmed, with the reason (for example Needs an RPM strip).
The Preview on menu at the right of the tabs chooses which of your devices the tiles are drawn on. It only changes what you see in the plugin, never what plays on the rig.
Plays on: which devices take part
The Plays on row above the tabs has one switch for each of your devices. A cue plays on whole devices; you can’t aim it at single keys or LEDs.
- Wheels play cues by default.
- Stream Decks and other screen decks sit cues out until you turn them on. On a deck, the cue washes over each key’s border and content.
The same list decides which devices take part in the cold start.
One wave across the rig
If you have placed at least two of your cue-playing devices on a rig photo on the Cockpit page, cues no longer play on each device separately. The start, stop, cockpit and race cues travel across the whole rig as one wave, following where each device really sits.
Some cues still play on each device on its own. These are the held flags, the spotter, Prime & Fire, Rev Blip, Strip Drain, Last Ember and the black flag.
Turned decks
A deck that is mounted turned plays its cues the way you see it. Set the turn under Mounting on the Devices page.
Cold start
While the car is cold, every control on the cue devices goes unlit: dim and colourless, but never blank. As you start the car, only the controls you reach for next light up.
- Open Cues, then the Cold start tab.
- Choose Add your first control and pick the parameter you press first, for example Ignition.
- Use Add control to add the next one, for example Engine. Order the rows the way you actually start the car.
- Turn the card on with the switch in its header.
The first row is lit while the car is cold. Each later row lights once the row before it reads 1. The last row is what “the car is live” means: when it reads 1, the whole cockpit wakes.
Each row shows a live reading:
- 1 or 0: the value the row reads now.
- NO SIGNAL: the game is running, but this value doesn’t read in it.
- WAITING FOR A SIM: no game is running yet.
Under Stays lit, choose what stays lit while the car is cold. You can keep app launchers, plugin controls, page and navigation keys, volume and audio, StreamLogic readouts and the info screen lit.
Cold start has no preview button, because it follows your ignition. To see it, switch the ignition off and on in the car. Cold start runs in game on every plan.
Start & stop
Start & stop is the one moment where you choose the cue yourself. Your start and stop cues play in game on every plan, together with the cold start.
- Start cues: Cascade Wake, Ignition Sweep, Fuel Pump, Systems Check, Breath In, Cold Bloom, Crank Pulse, Prime & Fire, Rev Blip, Spark.
- Stop cues: Cascade Sleep, Shutdown Sweep, Blink Goodbye, Flicker Off, Breath Out, Cool Down, Power Drain, Strip Drain, Collapse to Centre, Last Ember.
To choose one:
- Click a tile to watch it on your devices.
- Choose Use on a tile to make it your start cue.
The shutdown follows the start cue’s twin. To pick a different shutdown, choose Choose separately. Match the start cue puts the twin back.
More options on the same card:
- Finish with a shift-light check adds one sweep up the RPM strip in the car’s own shift colours. It needs a device with an RPM strip. Shift check over sets how long the sweep takes.
- Also when the car changes plays the start cue when you switch cars.
- Shutdown runs over sets the length of the stop cue, from 0.2 to 4 seconds.
The start cue follows the game’s starter in sims that report one. Elsewhere it runs on a clock, and the card says which applies to the game you are running.
The moments
| Moment | When it plays |
|---|---|
| Boot | SimDeckOS starts. |
| Game start | A sim connects. Quitting plays its twin. |
| Profile switch | The active profile changes. |
| Personal best | You set a new best lap. The first lap of a session only sets the mark. |
| Pit entry / exit | You enter or leave the pit lane. |
| Final lap | The last lap of a lap-counted race begins. Timed races don’t have one. |
| Position gained | You gain a place in a race and hold it for 2 seconds. |
| Position lost | You lose a place. Off at first. |
| Purple sector | A sector beats your own best. |
| Overtake ready | Push-to-pass becomes available, in cars that have it. |
| Car alongside | A car is beside you. It stays lit on that side while the car is there. |
| Three wide | Cars on both sides. |
| Clear | A side clears. |
| Closing fast | The car behind is within 1.2 s and gaining quickly. Off at first. |
| Fuel critical | Under two laps of fuel, then “box this lap”. |
| Damage taken | An impact. |
| Rain starting | The track turns wet. |
| Green flag | The race goes green. |
| Yellow, blue, white, black, chequered and red flag | The flag comes out. With Keep playing while it’s out on, it holds quietly until the flag clears. |
Every moment plays in the colour SimDeckOS already uses for that fact:
- Purple for a personal best or a purple sector.
- The flag’s own colour for a flag.
- Blue for the pit lane.
- Warning red for fuel and damage.
A moment only plays when your sim reports the data behind it. A sim that has no spotter never shows a car alongside, for example.
What wins when two things happen at once
- Shift lights always win.
- The engine cue outranks the other moments.
- The spotter never gives way. A car alongside stays lit on its side over any other cue.
- Held flags give way to any other cue, then come back.
- Final lap, fuel and rain wait up to 3 seconds for the rig to be free. A position change that can’t play right away is dropped.
The Flags animation and flag cues
The free Flags animation on the Animations page shows the flag that is out on every plan. With Pro, when a flag cue is on, that flag’s cue plays instead, and the Flags animation sits that flag out on the devices that play cues. Flag keys and the Flags message are never touched.
Cockpit styles can change these switches
A cockpit style on the Cockpit page (Pro) can turn moments on or off for you:
- Authentic plays the engine start and stop only.
- Race adds flags, the spotter, and the race and car moments.
- Showtime plays every cue.
Custom leaves your switches exactly as you set them. The Cues page doesn’t show when a style is overriding a switch, so check the Cockpit page if a cue doesn’t play as you set it.
Idle cues
Idle cues are the light shows your idle screen can play while no car is live. They are on the Idle page, not here.