-
Notifications
You must be signed in to change notification settings - Fork 5
Home
A Linux kernel driver and userspace tools for Logitech's direct-drive racing wheels: the RS50 and the G PRO Racing Wheel. It brings force feedback, TrueForce haptics (built in where a game supports it, and a simulated version built from a game's live data for titles without it), a live RPM rev-light display, LIGHTSYNC LED control, and G HUB-equivalent wheel settings to Linux, including in Proton/Wine games, all managed from a desktop app (logi-dd-gui) or a terminal one (logi-dd).
Quick start: paru -S logi-dd-gui on Arch and friends, or see
Installation for your distribution. Then plug in the wheel and race.

Not a direct-drive wheel? The belt-driven G920 / G923 are already served by the in-tree
hid-logitech-hidppdriver and do not need this one.
The RS50 is the development hardware and is verified directly; the G PRO runs the same code path and is expected to work, with a few items awaiting an owner's confirmation.
Legend: ✅ verified on hardware · 🟢 shares the verified code path, expected to work · 🟡 needs a tester
| Capability | RS50 | G PRO |
|---|---|---|
| Steering, pedals, buttons, D-pad | ✅ | 🟢 |
| Force feedback (works like a normal Linux wheel, full effect suite) | ✅ | 🟢 |
Force feedback in DirectInput games (the older force-feedback method, via logi-ffb) |
🟡 | 🟡 |
| TrueForce haptics (Proton, using Logitech's TrueForce files) | ✅ | 🟢 |
| Rotation range (90 to 2700°), strength, damping, filters | ✅ | 🟢 |
| Pedal response curves, sensitivity, deadzones, combined pedals | ✅ | 🟢 |
| RS Shifter & Handbrake (shift, digital + analog handbrake) | ✅ | 🟢 |
| LIGHTSYNC RGB LEDs (slots, colors, direction; edits apply live) | ✅ (faceplate strip) | 🟡 (rev lights) |
| RPM rev-light display (level fill, direction-aware) | ✅ | 🟡 |
Simulated TrueForce from a game's live data (logi-tf-sim) |
✅ (sweep-verified) | 🟢 |
| Centre calibration, mode / profile switching, computer-side profiles | ✅ | 🟢 |
USB IDs covered: RS50 (046d:c276 native, 046d:c272 compatibility mode) and
G PRO Racing Wheel (046d:c272 Xbox/PC, 046d:c268 PS/PC).
Start here if you own one of these wheels and want it working:
- Installation: per-distro packages, from source, atomic distros.
- Force Feedback in Games: out of the box, in Proton, the TrueForce setup, and DirectInput games.
- Configuring the Wheel: a tour of logi-dd-gui and the logi-dd terminal app.
- Simulated TrueForce: engine haptics and rev lights for games without native TrueForce.
- Troubleshooting: symptoms, fixes, and how to report a bug.
- Button Reference: which button index is which physical control.
Start here if you want to understand or extend the stack:
- Architecture: how the kernel driver and the userspace pieces fit together.
-
Sysfs API Reference: every
wheel_*attribute. - Protocol Specification: the USB and HID++ protocol, with sub-pages for Protocol Force Feedback and Protocol LIGHTSYNC.
- TrueForce Protocol: the audio-haptic stream format.
- libtrueforce: the native C implementation of the TrueForce SDK.
- logi-ffb: the DirectInput force-feedback proxy.
- Simulated TrueForce Internals: telemetry parsers, synthesis, rev LEDs.
- Building and Contributing: building, testing, and contributing captures.
The kernel driver and tooling are GPL-2.0-only; libtrueforce is LGPL-2.1-or-later so native Linux apps may link it. Logitech's TrueForce files are not part of this project and are not redistributed; you supply them from your own Windows G HUB installation.