SmartShift
Control scroll-wheel mode between ratchet and free-spin, set the auto-release threshold, and bind the toggle to a button.
Switch the scroll wheel between a clicky ratchet feel and frictionless
free-spin, set how hard you have to flick before it releases, and pin a
permanent ratchet that never lets go — backed by the HID++ 0x2111
smartShiftEnhanced feature (the variant on MX Master 3 / 3S / 4 and current
MX-line mice). Everything lives in the GUI's SmartShift panel, and the
mode toggle is also a bindable action.
From the GUI
Select the mouse in the device carousel; its detail panel has a SmartShift section with:
- Wheel mode — a two-pill segmented control, Free spin / Ratchet. Free spin lets the wheel coast for long-page scrolling; Ratchet gives the stepped, tactile clicks. The selected pill is highlighted.
- Sensitivity threshold — a
1–50slider (default16) that sets how fast you have to spin before the wheel auto-releases into free-spin. Higher keeps the ratchet engaged longer. The numeric label tracks your drag, but the value is pushed to the device only when you release the slider. It's greyed out unless you're in ratchet mode with permanent ratchet off. - Permanent ratchet — an On / Off toggle. On disables the auto-release entirely, so the wheel stays ratcheted no matter how fast you spin; Off restores your last threshold. It has no meaning under free spin and is disabled there.
The panel reads the wheel's current state the first time it's shown. If the device is asleep or offline you'll see an offline message with a line to click and retry; mice that don't expose the feature show This device does not support SmartShift.
As an action
ToggleSmartShift flips the wheel between free-spin and ratchet on a button
press, without opening the panel. Bind it from the GUI's action picker or by
hand in the config, and scope it per app with a
profile.
SmartShift mode, threshold, and wheel torque are not written to
config.toml — the mouse stores all three in its own non-volatile memory, so
the panel only reads and writes the hardware. Only the ToggleSmartShift
binding lives in the config. As always, quit Logi Options+ first so OpenLogi
can own the device.
Status: macOS + Linux — the side Back / Forward buttons are owned by
the OS hook; Windows is an untested preview. See the
roadmap for what's wired up. Protocol detail
is on 0x2111 smartShiftEnhanced.