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-wheel-gui) or a terminal one (logi-wheel).
Quick start: paru -S logi-wheel-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 is already served by the in-tree
hid-logitech-hidppdriver and does not need this one. The G923 (all editions) gets its own feature set from this driver instead: see G923.
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),
G PRO Racing Wheel (046d:c272 Xbox/PC, 046d:c268 PS/PC), and the G923
(046d:c266/c267 PlayStation edition, 046d:c26d/c26e Xbox edition).
The belt-driven G923 gets a separate feature set: full classic force feedback (hardware-verified on the PlayStation edition), rev LEDs, simulated TrueForce, and a different in-game recipe (no launch options at all). It has its own page: G923.
Start here if you own one of these wheels and want it working. Most people
want the desktop app: install logi-wheel-gui (it pulls in everything) and do
the rest from the app, no terminal needed beyond one install command.
New here? In plain English: force feedback is the physical force you feel through the wheel (the weight of the car, kerbs, impacts); it works with no setup. TrueForce is Logitech's extra layer of fine, fast vibration and texture on top; some games build it in, and for the rest a background helper can simulate it. Full explainer in Force Feedback in Games.
- Installation: the desktop app (recommended), plus per-distro packages, from source and atomic distros.
- Force Feedback in Games: force feedback vs TrueForce explained, out of the box, in Proton, the TrueForce setup, and DirectInput games.
- Configuring the Wheel: a tour of logi-wheel-gui and the logi-wheel terminal app.
- Simulated TrueForce: engine haptics and rev lights for games without native TrueForce.
- G923: everything specific to the belt-driven G923 (both editions).
- Add a Game: capture a game's telemetry to help add simulated TrueForce support for it.
- 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.