Home
Native Linux configurator for Logitech HID++ peripherals
Logitune is a native Linux configurator for Logitech HID++ peripherals, starting with the MX Master 3S. It communicates directly with the device over hidraw using the HID++ 2.0 protocol — no Solaar, no logiops, no daemon. Just a Qt 6 / QML desktop application with a system tray icon.
Buttons page — interactive device render with hotspot callouts for each button
| Feature | Description |
|---|---|
| 🎯 Per-application profiles | DPI, SmartShift, scroll, button assignments, and gestures switch automatically when you change window focus |
| 🔀 Button remapping | Assign keystrokes, app launches, gesture triggers, or SmartShift toggle to any configurable button |
| 🖐️ Gesture system | Hold the gesture button and swipe up/down/left/right or click for five independent actions |
| 🔄 Thumb wheel modes | Horizontal scroll, zoom (Ctrl+scroll), or volume control |
| ⚙️ SmartShift control | Toggle ratchet/freespin mode and adjust the auto-disengage threshold |
| 📜 Hi-res scroll | Toggle high-resolution scrolling and natural (inverted) direction |
| 🎚️ DPI slider | 200 to 8000 DPI in 50-step increments |
| 🔋 Battery monitoring | Real-time level and charging status in the system tray |
| 🔌 Easy-Switch | View paired hosts and active slot |
| 🔃 Transport failover | Seamlessly switch between Bolt receiver and Bluetooth connections |
| 🐛 Crash reporting | Built-in crash handler with one-click GitHub issue filing |
Tip
The UI is modeled after Logitech's Options+ application — a sidebar navigation with pages for Point & Scroll, Buttons, Easy-Switch, and Settings, plus a profile bar at the bottom.
| Page | Description |
|---|---|
| 📚 Getting Started | Installation, first run, permissions, UI overview |
| 🔨 Building | Build from source, Flatpak, devcontainer, CI |
| 🏗️ Architecture | System design, signal flow, MVVM, HID++ protocol layer |
| 🖱️ Adding a Device | Step-by-step guide to adding support for a new Logitech device |
| 🖥️ Adding a Desktop Environment | How to add GNOME, Hyprland, or other DE support |
| 🧪 Testing | Test philosophy, tiers, infrastructure, how to write tests |
| 🤝 Contributing | Fork workflow, code style, commit format, PR checklist |
| 🔌 HID++ Protocol | Deep dive into HID++ 2.0, feature discovery, report format |
Note
Logitune is in early development. The MX Master 3S is the first and currently only supported device. The architecture is designed to make adding new devices straightforward — see Adding a Device.
| Device | PID | Connection | Status |
|---|---|---|---|
| ✅ MX Master 3S | 0xb034 |
Bolt / Bluetooth | Fully supported |
| Feature | KDE Plasma 6 | GNOME | XFCE / Cinnamon | Hyprland / Sway | Other |
|---|---|---|---|---|---|
| Button remapping | ✅ | ✅ | ✅ | ✅ | ✅ |
| DPI / SmartShift / Scroll | ✅ | ✅ | ✅ | ✅ | ✅ |
| Thumb wheel modes | ✅ | ✅ | ✅ | ✅ | ✅ |
| Gesture actions | ✅ | ✅ | ✅ | ✅ | ✅ |
| Per-app profiles | ✅ | 🔜 Planned | ❌ | ❌ | ❌ |
| Auto profile switching | ✅ | 🔜 Planned | ❌ | ❌ | ❌ |
| Block shortcuts during capture | ✅ | 🔜 Planned | ❌ | ❌ | ❌ |
| System tray | ✅ | ✅ | ✅ | ✅ | ✅ |
Note
All device configuration works on every DE — it's pure HID++ over hidraw. Per-app profile switching requires desktop-specific integration for window focus tracking.
Important
Want to add support for your device or desktop environment? Check out Adding a Device and Adding a Desktop Environment for step-by-step guides.
Buttons page — interactive device render with labeled hotspots for each configurable button
Buttons page — Actions panel showing the full list of assignable actions
Point & Scroll page — DPI slider, SmartShift toggle, hi-res scroll, and thumb wheel mode
Point & Scroll — scroll wheel detail panel with per-setting controls
Settings page — device info, debug logging toggle, and bug report button
Easy-Switch page — back view of device with paired host channel list