Race flags and an RPM bar from your sim, on a WLED light strip — over Wi-Fi, no USB, no soldering.
License: MIT Platform SimHub WLED
A SimHub plugin that pushes live telemetry to a WLED device using the DRGB realtime UDP protocol (port 21324). Your ESP32 strip stays exactly where it is — the plugin just borrows it while you drive.
| Game state | Strip |
|---|---|
| Yellow flag | Whole strip flashes amber (~1.25 Hz) |
| Blue flag | Whole strip flashes blue |
| Checkered flag | Scrolling black/white pattern |
| Normal driving | RPM bar, green → orange → red, left to right |
| Redline (≥ 95 %) | Whole strip flashes red (~8 Hz) |
| Game paused | Strip goes dark |
| Game closed | Plugin stops sending; WLED returns to its normal mode within 2 s |
- Windows with SimHub installed
- A WLED device on the same LAN, with Realtime UDP enabled (WLED default)
- .NET Framework 4.x (already present on Windows 10/11)
No SimHub needed — this talks to the strip directly:
.\tools\wled-test.ps1 -WledHost wled.local -Leds 60 -Pattern sweep
If the bar sweeps across the strip, the network path and LED count are right.
Add -Pattern flag or -Pattern checker to preview the flag effects.
.\build.ps1
The script finds SimHub, compiles the plugin with the .NET Framework compiler (no Visual Studio needed) and copies the DLL into the SimHub folder. Then: start SimHub → enable WLED Flags & RPM in Settings → Plugins → restart SimHub.
Prefer not to build? Grab SimHubWledFlags.dll from the
latest release and drop it
into your SimHub folder.
%APPDATA%\SimHubWledFlags.cfg, created on first run:
host=wled.local # hostname or IPv4 address of the WLED device port=21324 # WLED realtime UDP port leds=60 # number of LEDs (max 490 per DRGB packet) reverse=false # true flips the RPM bar direction testmode=false # true plays a demo animation without a running game redline=95 # redline threshold, percent of max RPM brightness=1.0 # 0.0 - 1.0
Restart SimHub after editing.
Ambilight tools (Prismatik, Hyperion, ...) write to the same WLED realtime input: the last sender wins. Close the ambilight before a session so telemetry gets the strip, and it comes back on its own once you quit the game. Running both at once causes flicker.
Each frame is a single UDP datagram: [2][2][R,G,B] ×ばつ n.
Byte 0 selects the DRGB protocol, byte 1 tells WLED how many seconds to hold realtime mode
after the last packet — which is why the strip recovers by itself when you close the game.
Frames are capped at ~40 Hz.
- Pit limiter and DRS indicators
- Per-game colour profiles
- Configuration UI inside SimHub instead of the cfg file
- Multi-segment support (separate RPM bar and flag zones)
See CONTRIBUTING.md. Bug reports with your sim, WLED version and LED count are welcome.
MIT — see LICENSE. Not affiliated with SimHub or the WLED project.
🇹🇷 Türkçe: README.tr.md