Home
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.
- 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
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, native packages, 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 | KDE + GNOME implementation details, how to add Hyprland or other DEs |
| 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 |
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 |
| GNOME 42+ (Wayland) | Mutter | Shell extension via D-Bus | Fully supported |
| Generic (X11/other) | Any | None (device config only) | Basic support |
