JuhRadial MX Wiki
The ultimate Logitech MX Master experience on Linux
Radial Menu · Thumb-Wheel · Per-App Profiles · Haptics · Easy-Switch · Flow
Welcome. JuhRadial MX brings the full Logitech MX Master experience to Linux, native on Wayland: a radial gesture menu, haptic feedback, button and thumb-wheel remapping, per-application profiles, Easy-Switch, and cross-computer Flow. This wiki is the complete guide.
Quick install¶
The installer detects your distro, installs dependencies, builds from source, and sets up autostart. Full steps and per-distro notes: Installation.
Explore¶
| Page | What's there |
|---|---|
| Installation | One-line install, per-distro steps, build from source, updating |
| Features | Radial menu, remapping, thumb-wheel, haptics, Easy-Switch, Flow, gaming, macros |
| Configuration | config.json reference, themes, per-application profiles |
| [Compositor Support](compositor-support.md) | GNOME, KDE Plasma 6, Hyprland, COSMIC, Sway, niri, X11 |
| Troubleshooting | Common problems and how to fix them |
| Architecture | How it works, for contributors |
| FAQ | Quick answers to common questions |
What is new in v0.4.4¶
SmartShift and hi-res scroll settings now really program the mouse. Earlier builds spoke the wrong HID++ dialect to the SmartShift feature the MX Master 3/3S/4 expose, so wheel-mode and threshold changes reported success while changing nothing, and toggling smooth scrolling could silently rewrite the ratchet mode. v0.4.4 fixes the protocol, makes all three wheel modes (SmartShift, ratchet, free-spin) stick on the hardware, primes the Settings wheel and battery readouts on open, and reports the real connection type (Bolt, Unifying, or Bluetooth). See the Changelog.
A look at it¶
New here? Start with Installation, then skim Features. Stuck? See Troubleshooting or open an issue.