StreamLogic
The race engineer. Reference laps and the live delta, the page's tabs, readouts, blocks and key pages, the Director's beats, the wheel rim, the engineer overlay over the game, and rules.
StreamLogic is the engineering layer of SimDeckOS. It records your reference laps, works out a live delta, and runs the Director, which puts the one number that matters right now on your keys, dials, strip, rim or overlay. The StreamLogic page shows what it does; this guide is the reference.
Plans. StreamLogic is part of Pro. On Club, every tab shows what it does, dimmed. Your laps record on every plan, and each track’s best lap is free in Garage ▸ Laps. The Shift light and Beacon keys are free.
No setup
Your fastest valid lap on each car and track becomes the reference by itself. There is nothing to record and nothing to choose. To compare against another lap, pick it as the Benchmark on Tracks.
A lap that ran off track or through the pits is not banked. While you are on one, the live delta dims and says why. Tracks lists what counts as a lap.
One reference per track
The same circuit often reaches your sim more than once. In Assetto Corsa especially, mod versions of one layout come in their own folders, with their own skins. StreamLogic knows they are one track and files your reference under it, by the circuit’s real name. One lap on any version gives you the reference and the live delta on every version of it.
- Nothing to sort. The SimDeckOS team maps the versions, and the map arrives with content updates. A track that isn’t mapped yet works exactly as before, on its own.
- Laps you already drove fold in. Laps banked on a version before it was mapped join the track by themselves. The best reference stays, and the lap counts add up.
- What stays apart:
- A different layout is a different circuit, so the GP track and the Nordschleife never share a lap.
- The two directions of a track never share one.
- Two sims never share one.
- A reference is always for the car you drove it in.
The Tracks page lists every track by that real name, not by its folder.
The StreamLogic page
The page head shows the game, car and track, and the engine’s chain: Drive · Bench · Compare · React. Under THE ENGINEER SAYS is its latest line, and EDGES THIS SESSION lists a personal best, a new benchmark, a cut lap or the low-fuel line as it happens.
- Overlay opens the engineer overlay.
- Demo values animates the strip, dials and keys with made-up values while no game is running, for setup and screenshots. Real telemetry always wins.
The page has these tabs:
| Tab | What it holds |
|---|---|
| Engineer | The engineer’s read: Losing it here, Consistency, Tyre trend. Below it, Session laps, the timing tower of this session with the benchmark on top. Export CSV saves the laps. |
| Readouts | Every readout, with its key and its strip twin, and their options. |
| Strip | The Stream Deck + touch strip: which screens rotate, and how. |
| Director | The beats, and the screen for each session type. |
| Overlay | The engineer overlay over the game. |
| Rules | Your own rules: watch a value, then act. |
| Settings | The timing model, inputs, tyre and brake windows, fuel and pit. |
Readouts
A readout is one instrument that runs on a key, a dial, the Stream Deck + strip and the wheel dash alike. There are 18:
- Delta, Predict, Sectors, Inputs, Fuel, Tyres
- Brakes, Corners, Radar, Relative, Pit, Wear
- Gforce, RPM, Lap, Grid, Speed, Weather
Options sit with the readouts they change. Examples:
- Compare to optimal lap: a predictive delta against your theoretical best, the fastest of every mini-sector.
- Last-lap sector replay.
- Say why there is no delta: shows LEARNING, OFF or WAIT.
- Show clutch on the input graph, and a benchmark pedal ghost.
- Show last lap vs best.
- Flash the whole strip on the radar.
- The G-force ring’s scale: 3 g suits GT cars; a formula car wants 5 to 6.
On your keys: fields, blocks and pages
- Fields. A key or dial can show any of 61 StreamLogic fields, from Delta and Predicted lap to tyre temperatures, gaps, fuel to add, weather and Race engineer. Pick them in the key’s editor.
- Blocks. One instrument spread over several keys, placed as one: Sectors, Tyre block, Radar, Suspension and Corners.
- Key pages. Ready-made pages sized to your device: Everything, Shift lights, Predictive delta, Fuel & strategy, Inputs, Tyres & brakes and Traffic.
Place blocks and pages from the Layouts page, with Add StreamLogic or a key’s Place a StreamLogic block here…. They go on screen keys only.
The strip
On a Stream Deck +, the touch strip rotates through the screens you switch on. Drag them to reorder. A tap on the strip steps to the next screen.
- Show the strip: the engine runs either way.
- Dial hints over the strip.
- Strip moments: a short moment for a personal best, a best-ever sector, the fuel window, traffic, an invalid lap and the debrief.
- RPM bar on Grid / Speed.
The Director’s beats
The Director watches the session and decides what belongs on screen. Short moments hold the display while they last, then hand it back. The session’s state nudges it once and leaves you alone.
| Beat | When it fires | Holds or nudges |
|---|---|---|
| In pit lane | You are in the pit lane. | Holds |
| Car alongside | A car is alongside, plus a 1.5 s tail. Never fires in sims that don’t publish a spotter. | Holds |
| Fuel critical | Once a lap, when fuel drops below the margin, for 4 seconds. | Holds |
| No benchmark yet | No reference yet for this car and track: it says “Learning”. | Nudges once |
| Coaching | You have a reference here. | Nudges once |
| Debrief | After a lap, with Last-lap sector replay on. | Holds |
For each beat, pick the readout it Shows. Leave the pick blank and the beat still reports on SimHub, but leaves the display alone.
A beat only fires when the sim reports what it needs. A sim with no spotter data never has a Car alongside moment.
- Conduct the session turns the Director on. Off, the strip stays on whatever screen you last tapped.
- A tap holds the strip for sets how long a tap stands the Director down, from 1 second to 10 minutes (20 seconds at first). Changing the dash screen by hand stands it down too.
- Let it switch the wheel dash too lets the MOZA wheel’s dash follow the beat. It is off at first.
- Session-aware auto screen picks a screen for practice, qualifying and race.
What wins, in order:
- Your tap, while it holds.
- A beat, while it lasts.
- The screen picked for this session.
Any session that isn’t qualifying or a race counts as practice.
A key set to the Race engineer field shows what the Director just picked.
The wheel rim
In a car whose own dash already shows the revs, your wheel’s rev lights repeat it. StreamLogic can hand the rim LED strip a different scene instead. You choose it per car, under Strip shows (Pro) in the Garage, because whether the revs are already in front of you depends on the car you climbed into.
| Scene | What the rim draws |
|---|---|
| Shift lights | The car’s own shift lights. |
| Delta | A centre-out bar: zero in the middle, faster grows left, slower grows right. |
| Sectors | Your mini-sectors against the reference. |
| Gaps | The cars ahead and behind, placed by gap. |
| Fuel | Laps of fuel as a lit run, amber near your warning and red when critical. |
| Strip screen | Whatever the Stream Deck + strip shows, which means whatever the Director decided. |
| Auto | SimDeckOS picks. |
What gets the rim, in order
When two things want the rim at once, the one higher in this list wins:
- A cue or animation set to play on the strip, for its moment. The spotter is a cue: a car alongside lights the side it is on.
- A beacon from the car’s settings that uses the strip.
- Shift lights, past 85% of the rev range.
- Your scene.
- Shift lights again, whenever the scene has no data yet, instead of a dark rim.
The engineer overlay
The same engineer as a small window that stays on top of the game, so the delta and what the engineer says are where you are already looking.
The overlay is a window that stays on top, so the game has to run windowed or borderless. In exclusive fullscreen there is nothing for it to sit over. It shows only while a game runs, or while Demo values is on.
Shapes
There are four shapes, and each one remembers its own position:
- Card: a small panel out of the racing line.
- Bar: one line across the top.
- Corner: the smallest, tucked into a corner.
- Strip: the same screens as your Stream Deck + touch strip. It can follow the strip, stack up to three screens, or pin the ones you choose.
Cells
For the Card and Bar shapes, pick what it shows:
- the beat, what the engineer says, and the last thing it said
- delta, losing it in, consistency, tyre trend
- laps of fuel, fuel left
- gap behind, gap ahead, position
- last and best, the benchmark
- the frame rate, in Assetto Corsa and iRacing
Staying out of the way
- Click-through lets clicks pass through to the game.
- Scale goes from 0.5 to 2.5.
- Reset position moves it back to the top centre.
- Open with the session opens it by itself when a game starts. If you close it, it stays closed until the next session.
Plugin: Toggle Engineer overlay and Toggle Engineer overlay shape are controls you can put on a key or wheel button. The engineer overlay is also a plugin control, and the SimHub actions ToggleEngineerOverlay and EngineerOverlayNextShape do the same.
Rules
A rule watches one value and acts on it. New rule builds one:
- When a value meets a condition, for a hold time…
- Then fire a control, show a strip screen, or show a message.
For example: when laps of fuel are below 3, show the Fuel screen.
While a rule holds, a key’s status or a page trigger can follow it by name. Switching pages is a page trigger’s job, not a rule’s.
Settings
- Timing model, shared by every surface:
- the delta bar’s scale,
- the close-gap window,
- the number of mini-sectors (4 to 64),
- the main sectors to use when a track has none.
- Inputs: how many seconds the input history keeps.
- Tyres & brakes: the cold and hot fallbacks in °C. A car’s own window wins when its sim or its car settings state one.
- Fuel & pit:
- Fuel unit.
- Low-fuel line: it turns amber at the line and red at half of it.
- Pit margin.
The coaching numbers
| Number | What it means |
|---|---|
| Delta | The live gap to your reference lap. |
| Predicted lap | The lap time your current pace projects. |
| Losing it here | The part of the lap where you are giving away the most time against your reference. |
| Consistency | The spread of your last five valid laps, in seconds. Lower is better. |
| Tyre trend | Pace falloff per lap over the stint. Wear shows as a rising number. |