Configuring the Wheel

Configuring the Wheel

Everything G HUB configures on Windows, this project configures on Linux: rotation range, force-feedback strength and filters, TrueForce level, LIGHTSYNC LEDs, onboard profiles, and per-pedal / steering / handbrake response curves. Two apps share the same feature set:

• logi-dd-gui: the desktop app (Slint), installed by the logi-dd-gui package with a menu entry.
• logi-dd: the terminal app, for headless boxes, SSH sessions and terminal fans.

Both find the wheel automatically and edit settings live. Writing settings needs your user in the input group (sudo usermod -aG input "$USER", then log out and back in). Underneath, everything they set is a plain sysfs file you can also script directly; see the Sysfs API Reference.

The desktop app: logi-dd-gui

Every wheel setting on one page, grouped by category, with live values read from the wheel:

Highlights:

• G HUB-style curve editor for the pedal, steering and handbrake response curves: drag control points, set deadzones, watch the composed curve, then upload it.

  

• LIGHTSYNC editor with per-slot colors (HSV picker), effect, brightness and animation direction. Changes apply to the wheel immediately.

• Info / Testing doubles as a live input tester: a rotating wheel diagram, button and pedal readouts (does this button reach the computer?), plus guarded, cancelable force simulations.

  

• Setup manages the game helpers: per-game TrueForce shim install/remove over Steam/Proton game discovery, an SDK directory picker, and the simulated-TrueForce daemon with per-game enables.

  

• Profiles: onboard mode shows the wheel's five named slots (renameable); desktop mode manages computer-side presets you can save, apply and delete.

The terminal app: logi-dd

The TUI is a sidebar of views plus a content pane; the number keys jump straight to a view. Values are typed and validated before they reach the wheel, so an out-of-range value is rejected in the UI instead of erroring at the device.

Settings that only apply in desktop or onboard mode are flagged, and the app can switch the wheel between the two (the d key). A write that needs the other mode tells you so instead of failing silently.

Keys

Press ? at any time for the complete key list of the current context; the in-app overlay and the footer render from the same table, so they are the authoritative reference.

Global (whenever no text entry is open)

Key	Action
1-7	Jump straight to that sidebar view
Tab	Switch focus between the sidebar and the content pane
Esc	Close the topmost editor / overlay, else back to the sidebar
?	The full key list for the current context
q	Quit

Settings views (content focus): Up/Down select, Enter edits (or runs an action), i explains the selected setting, a toggles sensitivity / full curve for an axis, d toggles desktop / onboard mode, r re-reads all values from the wheel.

Editing a value: Left/Right nudge the value (or type, for text fields), Enter commits, Esc cancels.

The curve editor

Opens on any curve setting (steering, per-pedal, handbrake). Up/Down move between fields (point, input, output, lower deadzone, upper deadzone), Left/Right adjust, +/- add or delete a point, Enter uploads the curve:

LIGHTSYNC

The LIGHTSYNC view composes each custom slot: colors per LED, effect, brightness, animation direction. The strip preview mirrors what the wheel shows, and changes apply live:

The color picker paints individual LEDs from a palette or hex entry. Tab switches between the strip and the palette, Enter paints the selected LED, a paints all, p paints the LED and its mirror pair (for the symmetric directions), x opens hex entry, and w writes the strip to the wheel:

Info / Testing

Serial, firmware, app and driver versions (copyable with c, handy for bug reports), a live input monitor, and guarded force simulations (f for a force-feedback sim, t for a TrueForce texture sim, both consent-gated):

Setup

The Setup view manages the game helpers: logi-ffb hints, per-game TrueForce shim install/remove over the discovered Proton games, the SDK directory, a game compatibility table, and the simulated-TrueForce daemon controls:

Scripting and other tools

Everything the apps set is also available as plain sysfs attributes under /sys/class/hidraw/hidrawX/device/wheel_*:

H=$(ls -d /sys/class/hidraw/*/device/wheel_range | head -1 | xargs dirname)
echo 0   > "$H/wheel_profile"    # desktop mode
echo 900 > "$H/wheel_range"      # lock-to-lock degrees
echo 65  > "$H/wheel_strength"   # overall FFB strength, percent

The GUI tool Oversteer also recognizes many of them through the driver's compatibility aliases. The complete attribute reference is the Sysfs API Reference.