-
Notifications
You must be signed in to change notification settings - Fork 37
Home
Logitune icon
Native Linux configurator for Logitech HID++ peripherals
CI License Qt C++
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.
Logitune Settings page
Settings page β debug logging, bug report, about info
| 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 |
| DE | Compositor | Focus Tracking | Status |
|---|---|---|---|
| β KDE Plasma 6 | KWin | KWin script via D-Bus | Fully supported |
| Any | Polling fallback | Basic support |
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.