Troubleshooting
Fixes for a deck that stays dark, a wheel that doesn't react, values that stay blank, a profile that doesn't switch, a cue that doesn't play, or Pro that doesn't show.
Start with the Dashboard
Open SimDeckOS in SimHub and go to the Dashboard. The sentence at the top and the Devices card say, in words, what works and what needs a look. Each device’s page on Devices gives the reason and a button that fixes it. Most problems below show up there first.
The Stream Deck stays dark
- Is Drive on? With DRIVE off in the status bar, nothing is driven.
- Is the Stream Deck app running? SimDeckOS reaches your deck through its companion inside that app.
- Does the deck read “The SimDeckOS plugin isn’t in the Stream Deck app”? You installed the Stream Deck app after SimDeckOS. Run the SimDeckOS installer again so it can add the companion.
- Does it read “The deck shows another profile”? Choose Install to Stream Deck again, or pick the SimDeckOS profile on the deck.
- Does the Dashboard say another SimHub is driving your rig? A second copy of SimHub is running. Close one of them.
A Ulanzi deck stays blank
Start Ulanzi Studio. Check that every key has a SimDeckOS Key action and every knob a SimDeckOS Dial.
A wheel doesn’t react
- Does it read “Not mapped yet”? Map it: Devices ▸ Inputs ▸ Map inputs.
- Does the map window find no inputs? Enable the wheel under SimHub ▸ Controllers so its inputs show as properties.
- Do the encoders stop working after an update or a firmware change? Use Re-map encoders.
- MOZA: does it read “Port busy”? Close MOZA Pit House. Only one app can hold the wheel’s port.
- MOZA: does it read “Display not answering”? Power-cycle the wheelbase, then choose Reconnect now. The lights keep working meanwhile.
- MOZA: does the display stay on Pit House’s dash? Import the SimDeckOS dash in Pit House once. The display needs Pro.
- PXN: do the lights flicker? Turn off any SimHub RGB LEDs profile for the wheel.
Values show blank or zero
- Get on track. Many values only fill once a session is live.
- Check that the game selected in SimHub is the one you are running.
- See Notes for each sim for the one-time steps in Assetto Corsa, Le Mans Ultimate, rFactor 2 and Automobilista 2.
- On the Parameters page, a red dot marks a parameter with no source. Use its fix button.
- In a sim SimDeckOS doesn’t read itself, values only SimDeckOS’s own readers provide stay empty.
The key pictures are sideways
The deck is mounted turned. Set Mounting ▸ Turned on Devices. Also set the same Device Orientation in the Stream Deck app, under Preferences ▸ Devices.
A profile didn’t switch
- Check that Auto-switch is on, in Settings ▸ General.
- A profile tied to specific cars only matches those cars. Open it on the Profiles page and check its game, class and car list. A rule with Only these cars on and no car listed never switches in.
- While you are editing a layout, auto-switch waits until you are done.
- Settings ▸ Diagnostics ▸ Auto-switch resolver shows what SimHub reports, which profile would be picked and why.
- On Club, every profile plays the same layout per device, so a switch can look like nothing changed.
A cue doesn’t play
- In game, the cold start, your start and stop cues and the Cockpit moments play on every plan. Every other cue, the spotter included, needs Pro in game. Previews are free.
- Check Plays on on the Cues page. Stream Decks sit cues out until you turn them on.
- Check the moment’s switch on its card.
- A cockpit style on the Cockpit page can turn moments on or off. Custom keeps your own switches.
- The moment needs data from the sim. A spotter cue never fires in a sim with no spotter, and there is no final-lap cue in a timed race.
Pro doesn’t show
- Pro belongs to your account. Open the account badge and check that you are signed in with the account that has Pro.
- The plugin checks your plan when it starts. If you bought Pro while SimHub was running, sign out and in again, or restart SimHub.
- Without an internet connection the check can’t go through. Nothing you built is taken away; the Pro features return once the check succeeds.
A setting seems to have been lost
- Settings ▸ Account & backup restores a cloud backup (Pro) or a Back up all… file from this PC.
- Laps you deleted can come back with Restore from backup under Settings ▸ General ▸ Lap recording.
Still stuck?
Settings ▸ Diagnostics ▸ Report a bug sends a report straight to us, with the end of the log if you leave it ticked.
You can also use Export diagnostics… to save the log and email it to support@simdeckos.com. Say what you expected and what happened.