SimDeckOS
Installer soon Sign in Notify me
PluginRace ControlStudioLibraryPricingDocsFAQ Sign in Notify me

Docs

Every guide for the plugin, Race Control and Studio, in the app’s own words.

Docs › Plugin › Engineer

StreamLogic

Plugin

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:

TabWhat it holds
EngineerThe 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.
ReadoutsEvery readout, with its key and its strip twin, and their options.
StripThe Stream Deck + touch strip: which screens rotate, and how.
DirectorThe beats, and the screen for each session type.
OverlayThe engineer overlay over the game.
RulesYour own rules: watch a value, then act.
SettingsThe 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.

BeatWhen it firesHolds or nudges
In pit laneYou are in the pit lane.Holds
Car alongsideA car is alongside, plus a 1.5 s tail. Never fires in sims that don’t publish a spotter.Holds
Fuel criticalOnce a lap, when fuel drops below the margin, for 4 seconds.Holds
No benchmark yetNo reference yet for this car and track: it says “Learning”.Nudges once
CoachingYou have a reference here.Nudges once
DebriefAfter 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:

  1. Your tap, while it holds.
  2. A beat, while it lasts.
  3. 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.

SceneWhat the rim draws
Shift lightsThe car’s own shift lights.
DeltaA centre-out bar: zero in the middle, faster grows left, slower grows right.
SectorsYour mini-sectors against the reference.
GapsThe cars ahead and behind, placed by gap.
FuelLaps of fuel as a lit run, amber near your warning and red when critical.
Strip screenWhatever the Stream Deck + strip shows, which means whatever the Director decided.
AutoSimDeckOS picks.

What gets the rim, in order

When two things want the rim at once, the one higher in this list wins:

  1. 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.
  2. A beacon from the car’s settings that uses the strip.
  3. Shift lights, past 85% of the rev range.
  4. Your scene.
  5. 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

NumberWhat it means
DeltaThe live gap to your reference lap.
Predicted lapThe lap time your current pace projects.
Losing it hereThe part of the lap where you are giving away the most time against your reference.
ConsistencyThe spread of your last five valid laps, in seconds. Lower is better.
Tyre trendPace falloff per lap over the stint. Wear shows as a rising number.