HID-Fanatecff-GUI (Fanatec Tuning)

English · Deutsch

Graphical interface for the tuning menu of Fanatec wheel bases on Linux, built on the kernel driver hid-fanatecff. Steering angle, force feedback, damping, smoothing etc. can be set with sliders, plus profiles that are loaded automatically when a game starts.

The interface follows the system language: German on German systems, English otherwise.

Features

• All tuning values of the base (SEN, FF, FFS, FUL, FEI, FOR, SPR, DPR, SHO, NDP, NFR, NIN, INT, slot, …) with readable names and recommendations. Changes go straight into the base's current slot.
• Profiles to save and load. Included: Empfohlen (recommended), GT, Rally, Drift.
• Automatic game detection: a background service detects running games (also under Proton) by their .exe and applies the assigned profile. Optionally a different profile after the game exits.
• Switch profiles in game with a keyboard shortcut bound to fanatec-tuning --next.
• Tray icon of the background service: switch profiles, open the window.
• A single program (Rust, ~3 MB), no dependencies besides the driver. The window only runs while it is open.

Installation

One click: download Fanatec-Tuning.desktop and double-click it (on KDE you may have to "allow executing" first). The file downloads the current release from GitHub, installs it to ~/.local/bin, adds a start menu entry and autostart, and launches it. Every further double-click fetches the newest version. Without internet it simply starts the installed version.

Or from source (needs cargo, Arch/CachyOS: sudo pacman -S rust):

git clone https://github.com/ProfessorTee/HID-Fanatecff-GUI.git
cd HID-Fanatecff-GUI
cargo build --release
./target/release/fanatec-tuning --install

Write permissions (once): so normal users may change the values, add a udev rule and then switch the base off and on again:

sudo ~/.local/bin/fanatec-tuning --udev

Remove: fanatec-tuning --uninstall (profiles in ~/.config/fanatec-tuning are kept).

Commands

Command	Effect
fanatec-tuning	open the desktop app
fanatec-tuning --daemon	game detection + tray icon in the background (autostart)
fanatec-tuning --next	next profile of the running game
fanatec-tuning --apply NAME	apply profile NAME
fanatec-tuning --install / --uninstall	install / remove
sudo fanatec-tuning --udev	set up write permissions

Requirements

• Linux with the driver hid-fanatecff (provides /sys/class/ftec_tuning/)
• Developed and tested with a Fanatec CSL DD (Boost Kit) on KDE Plasma 6 (CachyOS)

Development

Rust program in src/main.rs (egui window with CPU rendering, ksni for the tray). A v* tag builds it via GitHub Actions on Ubuntu 22.04 (so it runs on glibc ≥ 2.35) and attaches it to the release that the one-click launcher downloads.

License

MIT. hid-fanatecff is a separate project (gotzl) and not part of this repo.