Logitune

A Linux configurator for Logitech peripherals — per-application profiles, gesture mapping, thumb wheel modes, and a dark-themed Qt Quick UI matching Logitech Options+.

✨ Features

• 🖱️ Per-app profiles — automatic button/scroll/DPI switching on window focus
• ⌨️ Button remapping — keystrokes, media controls, app launch, gestures, SmartShift toggle
• 🎛️ Thumb wheel modes — volume, zoom, horizontal scroll with invert control
• 👆 Gesture support — hold + swipe for desktop switching, task view, custom keystrokes
• ⚡ DPI / SmartShift / Scroll — full control with live preview
• 🔋 System tray — battery status, minimize to tray
• 📡 HID++ 2.0 — direct communication via Bolt receiver, no daemon needed
• 🔄 Disconnect/reconnect — automatic re-enumeration and profile reapplication
• 🖥️ KDE + GNOME — native focus tracking on both desktops
• 🛠️ In-app descriptor editor: launch with --edit to position hotspots, upload images, and tune labels without hand-editing JSON. Learn more

📸 Screenshots

Action selection panel

More screenshots

Scroll, thumb wheel & pointer speed

Scroll direction, SmartShift, smooth scrolling

Easy-Switch channel management

Device info, dark mode, debug logging

🚀 Install

Ubuntu 24.04 (via OBS repo):

echo 'deb http://download.opensuse.org/repositories/home:/mmaher88:/logitune/xUbuntu_24.04/ /' | sudo tee /etc/apt/sources.list.d/logitune.list
wget -qO- https://download.opensuse.org/repositories/home:mmaher88:logitune/xUbuntu_24.04/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/logitune.gpg > /dev/null
sudo apt update && sudo apt install logitune

Fedora 42 (via OBS repo):

sudo dnf config-manager addrepo --from-repofile=https://download.opensuse.org/repositories/home:mmaher88:logitune/Fedora_42/home:mmaher88:logitune.repo
sudo dnf install logitune

Arch Linux (AUR):

yay -S logitune

From source:

cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
cmake --build build
sudo cmake --install build
logitune

📚 Documentation

🖱️ Supported Devices

MX Master 4 smooth scrolling is disabled in the shipped descriptor: the hardware does not respond correctly to the HID++ configuration used on MX Master 2S / 3S. Regular scroll wheel and SmartShift work normally; only sub-tick smoothing is unavailable. Re-enable yourself by setting "smoothScroll": true in devices/mx-master-4/descriptor.json if your unit behaves differently; if it works we will promote the default.

The four MX Anywhere family descriptors ship as 🧪 Beta pending hardware confirmation. Issue #46 tracks the verification.

Other Logitech HID++ 2.0 devices can be added by contributing a device descriptor. See Device Support Status for what the badges mean.

🖥️ Desktop Environment Support

Note: All device configuration (buttons, DPI, scroll, gestures, thumb wheel) works on every DE — it's pure HID++ over hidraw. Per-app profile switching requires desktop-specific focus tracking. KDE uses a KWin script, GNOME uses a Shell extension (auto-installed on first run), and Hyprland subscribes to the compositor's event socket. Hyprland has no stable compositor-wide shortcut-blocking API, so global bindings may still fire while capturing a keystroke — capture itself works. See Adding a Desktop Environment to contribute support for other DEs.

🛠️ Tech Stack

C++20 · Qt 6 Quick · CMake · HID++ 2.0 · GTest

📄 License

GPL-3.0-only