FanaBridge

A SimHub plugin that provides native LED and display control for Fanatec steering wheels via HID.

This is beta software. Expect rough edges. Bug reports and feedback are welcome via Issues.

Features

• RGB button and encoder LEDs — Full RGB color and 8-level intensity per LED, including Rev/RPM and Flag/status LED strips where present
• 3-digit display — Wheels with a basic display show gear, speed, gear-then-speed overlay, or gear with upshift brackets
• Experimental: ITM telemetry display — Wheels/modules with a graphical ITM display (e.g. Button Module Endurance) show live SimHub telemetry across all pages — speed, gear, lap times, position, fuel/ERS/DRS, car settings, tire temps. Pages are selected with the wheel's display button
• SimHub LED profiles — Wheels appear in SimHub's Devices view with standard LED Editor support
• Compatible with LED profile plugins — Works with ATSR Hub EVO and other SimHub LED profile plugins
• Automatic detection — Detects connected wheels, hubs and button modules directly over HID and matches to a profile
• Hot-plug support — Reconnects gracefully when devices are plugged/unplugged or wheels are swapped
• Custom wheel profiles — JSON-based profiles mean unsupported wheels can be added without waiting for a plugin update
• Experimental: Control Mapper integration — Supplies FanaBridge's wheel identity to SimHub's Control Mapper so it can keep separate button mappings per Fanatec wheel, including bases and wheels SimHub can't identify on its own (Podium DD wheelbases, newer wheels such as the ClubSport Formula V3)
• Experimental: Encoder mode — Configure encoder behavior (relative, pulse, constant, auto) directly on supported devices

Planned

• Customizable telemetry display and arbitrary text/messages (e.g., function layer activation)

Supported Devices

Built-in profiles are included for 19 wheels and 2 hub + module combinations, covering most Fanatec steering wheels with LEDs or displays. See the full supported devices list for details.

If your wheel isn't listed, use the Wheel Profile Wizard (see Usage) to generate a profile. Created profiles can be shared on GitHub to benefit other users.

Requirements

• SimHub (latest version recommended)
• A Fanatec wheelbase connected via USB
• A supported Fanatec steering wheel

Installation

1. Download the latest release .zip from the Releases page
2. Close SimHub if it's running
3. Extract the archive directly into your SimHub installation directory (e.g., C:\Program Files (x86)\SimHub\)
   • FanaBridge.dll goes in the SimHub root
   • DevicesLogos\ files go into the DevicesLogos\ subdirectory
4. Start SimHub and enable the FanaBridge plugin

Usage

1. In the Fanatec software, set Fanatec App LED/Display output to Disabled (otherwise the Fanatec driver and FanaBridge will fight over control of the LEDs and display)
2. Connect your Fanatec wheelbase and attach a supported wheel
3. Add the wheel as a SimHub device — either:
   • Open the FanaBridge settings tab and click Add to SimHub on the prompt that appears when a detected wheel or hub hasn't been added yet, or
   • In SimHub, go to Devices, click Add (+), then Add New Device, and choose your wheel or hub/module combo
4. Configure LED profiles using SimHub's built-in LED Editor, or with a third-party LED profile plugin like ATSR Hub EVO

Adding an unsupported wheel

If your wheel doesn't appear in the Devices list, you can create a profile for it:

1. Open the FanaBridge plugin settings tab in SimHub
2. Connect your wheel — it will show as "connected" even without a profile
3. Click New Profile Wizard and follow the steps
   • The wizard sends test signals to your wheel (LEDs light up, display shows a test pattern) and asks what you observe
   • It uses your answers to build a profile describing the hardware layout
4. Once saved, restart SimHub so the new device appears in the Devices list
5. Optionally, share your profile via the Share it on GitHub link in the settings — this helps other users with the same wheel

Building from Source

Prerequisites

• .NET SDK (includes .NET Framework 4.8 targeting pack)
• SimHub installed (the project references DLLs from the SimHub directory)

Build

dotnet build src\FanaBridge\FanaBridge.csproj

To install directly to your local SimHub (for development):

dotnet build src\FanaBridge\FanaBridge.csproj -p:InstallToSimHub=true

The SimHubDir property defaults to C:\Program Files (x86)\SimHub\. Override it in Directory.Build.props.user if your install is elsewhere.

CI builds against the SimHub release pinned in .simhub-version; a weekly workflow opens a bump PR when SimHub publishes a new release. SimHubEnumSnapshotTests guards the public Fanatec enum metadata that FanaBridge's Control Mapper variant ids stay name-compatible with — after a SimHub update changes it, regenerate the snapshot with .\scripts\update-simhub-enum-snapshot.ps1.

Documentation

Project documentation lives in docs/:

• Supported Devices — Complete list of wheels and hub/module combos with built-in profiles
• docs/reference/ — Fanatec hardware and HID protocol reference
  • Devices — Hardware catalog (wheelbases, wheels, hubs, modules)
  • Protocol — HID protocol reference (col01, col03, tuning, ITM, LEDs)
• Terminology — Glossary of Fanatec ecosystem concepts

Disclaimer

FanaBridge is an independent, open-source project and is not affiliated with, endorsed by, or sponsored by Fanatec, Endor AG, Corsair, or any of their affiliated companies. The name “Fanatec” is used solely to describe hardware compatibility. Product images are used only for device identification purposes and remain the property of their respective owners. All trademarks and copyrights are the property of their respective owners. This software is provided “as is,” without warranty of any kind.

License

MIT