Scrolling
Configure app-wide wheel handling, per-device main-wheel controls, momentum scrolling, thumb-wheel presets, and hold-to-scroll sideways.
OpenLogi separates app-wide wheel handling from each mouse's wheel settings. Open Settings → General for host-side controls. Open a mouse's Pointer tab for controls that use its current connection. For ratchet and free-spin mode, see SmartShift.
App-wide wheel settings
Smooth scrolling replaces eligible traditional mouse-wheel ticks with finite eased motion. It is off by default. Continuous trackpad input stays native.
Vertical Scroll Sensitivity scales traditional vertical wheel distance from 1 through 100.
The default 14 is 1×.
It does not scale trackpad input.
Thumb Wheel Sensitivity uses the same 1 through 100 range.
The default 14 is 1×.
It sets the app-wide default for a thumb wheel's scroll speed and discrete-action threshold.
A device can override it in its configuration.
Per-device main wheel
Select a mouse and open Pointer. The following controls depend on the wheel capabilities of its current connection.
- Invert scroll direction reverses this mouse's vertical wheel direction. The trackpad keeps the system direction. OpenLogi uses native HID++ inversion when the wheel reports it. Otherwise, OpenLogi reverses the wheel while it captures the event.
- Wheel resolution offers Device default, Standard, and High resolution. Device default leaves the wheel unchanged. Standard scrolls once per physical ratchet step. High resolution detects movement between ratchet steps.
- Smooth wheel is a per-device switch for a main wheel with HID++
0x2121. OpenLogi diverts every wheel report and posts eased scrolling. This happens even when Smooth scrolling is off. The result still uses this mouse's inversion and Vertical Scroll Sensitivity.
Smooth wheel needs input-hook access and capture_mouse_events = true.
On macOS, the hook needs Accessibility access.
Without either condition, the wheel stays native.
When you turn Smooth wheel off, disable the mouse, or exit the agent, OpenLogi returns the wheel to native reporting. If the agent stops first, the wheel remains diverted until the agent runs again or the mouse reconnects. A reconnect drops the diversion.
The Smooth wheel card appears when the current connection reports 0x2121.
A wheel enabled on another connection remains visible as an other-connection state.
You can turn it off there, but cannot turn it on without 0x2121 on the current connection.
Momentum scrolling
Momentum scrolling keeps the page gliding after you spin the wheel freely. It works on a mouse whose Smooth wheel is on. When SmartShift lets the wheel spin freely, the page glides off at the speed you spun it. The glide slows down and stops the moment you touch the wheel. Ratchet scrolling keeps its steps. It is off by default. OpenLogi has tested it only on macOS.
Open Settings → General to set the default for every mouse. That card also shows how many mice have their own settings. Open a mouse's Pointer tab to give that mouse its own settings. The card there says whether the mouse follows Settings → General. Use General settings removes the mouse's own settings. Settings that match Settings → General also remove them.
On the Pointer tab, turning on Glide on free spin offers to turn on Smooth wheel too. Turning off Smooth wheel while the glide is on offers to turn off both. Both dialogs change only the selected mouse.
| Control | What it does | Config key |
|---|---|---|
| Glide on free spin | Turns momentum scrolling on. | enabled |
| Distance per notch | Sets how far one wheel notch scrolls, from 10 to 60 reference pixels. The default is 28. It also sets the speed at which a spin starts the glide. | pixels_per_notch |
| Glide shape | Selects Sharp, Linear, Smooth (default), or Floaty. Every shape covers the same distance. A smoother shape brakes earlier and has a longer tail. | glide_shape |
| Max glide speed | Sets the fastest glide from one spin, from 2000 to 15000 px/s. The default is 8000. | max_glide_speed |
| Glide length | Sets the glide's time constant, from 150 to 1200 ms. The default is 400. | glide_ms |
| Repeat speed-up | Multiplies the glide by this percentage each time you spin again in the same direction, up to 3× past Max glide speed. The range is 100 to 200, and the default is 135. 100 turns it off. | repeat_boost |
Reset to defaults restores the sliders and the shape, and leaves the switch as it is. macOS receives pixel events. Windows and Linux scale native wheel ticks against the default distance, so an application can change the final distance.
Thumb wheel
A supported Thumb Wheel uses HID++ 0x2150.
Its two directions are stored as ThumbwheelScrollUp and ThumbwheelScrollDown bindings.
OpenLogi diverts it when the sensitivity differs from 14 or a direction differs from its native binding.
The GUI recognizes these exact direction pairs as presets:
- Back / Forward, Undo / Redo, Browser Back / Forward, and Previous / Next Tab.
- Previous / Next Desktop, Next / Previous Desktop, and Previous / Next Track.
- Volume Up / Down, Volume Down / Up, and Cycle DPI Presets.
- Vertical Scroll, Vertical Scroll (Reversed), Horizontal Scroll, and Horizontal Scroll (Reversed).
Volume Down / Up reverses Volume Up / Down. Horizontal Scroll preserves the native direction and does not divert the wheel. Horizontal Scroll (Reversed) swaps the directions and diverts the wheel. A thumb-wheel swipe can fire a discrete action more than once, including volume changes.
With Smooth scrolling off, diverted horizontal thumb-wheel input remains a phased gesture.
The gesture ends after 120 ms without another tick.
This keeps horizontal swipe-aware applications responsive.
Thumbwheel is the capacitive tap report, not a mechanical click.
Its default is Do Nothing.
The GUI has no control for it because incidental thumb contact can produce a tap.
Bind it in the configuration only when that behavior is acceptable.
Hold to scroll sideways
On a mouse without a thumb wheel, hold Back or Forward and turn the main wheel. The held wheel becomes a virtual horizontal thumb wheel. Turning away from you scrolls left, and turning toward you scrolls right. Invert scroll direction reverses those directions.
A release without turning the wheel runs the button's click action.
A press that turns the wheel runs no other action.
The feature is off until you add the wheel-hold binding.
Wheel hold needs raw-wheel reporting for that button through HID++ 0x1b04.
Only some firmware exposes this capability.
It also needs the mouse hook and capture_mouse_events = true.
On macOS, that means Accessibility access.
Without raw-wheel reporting or the hook, OpenLogi captures the button only for click.
The main wheel then stays native.
When mouse capture is off, the button keeps its native function.
OpenLogi returns the button and wheel to firmware when the binding changes, the mouse disconnects, or the agent exits. It does not set the firmware's persistent flag. A power cycle also clears the diversion.
In the default profile, select Back or Forward and enable Hold to scroll sideways.
The switch appears only when that button reports raw-wheel support.
A carried-over binding remains visible, so you can turn it off on an unsupported mouse.
Changing the button action preserves its wheel hold and changes click.
Enabling wheel hold on a gesture button leaves gesture mode and keeps the gesture map's Click action. Enabling gestures again restores the saved gesture directions. Wheel hold is per device, not per application. An app profile action for that button replaces wheel hold in that application.
In the config
The settings below combine app-wide scroll handling, per-device wheel controls, momentum scrolling, thumb-wheel bindings, and a Back wheel hold.
A device's momentum_scrolling table is complete on its own.
Keys it omits take their defaults, not the Settings → General values.
See Configuration for the full reference.
schema_version = 9
[app_settings]
capture_mouse_events = true
smooth_scroll = true
vertical_scroll_sensitivity = 20 # 1–100; 14 is 1×
thumbwheel_sensitivity = 14 # App-wide thumb-wheel default
[app_settings.momentum_scrolling]
enabled = true
glide_shape = "smooth" # "sharp", "linear", "smooth", or "floaty"
[devices."unit:6be9d300"]
invert_scroll = true
scroll_resolution = "high" # "low", "high", or omit for the device default
smooth_wheel = true
thumbwheel_sensitivity = 30 # Per-device override
[devices."unit:6be9d300".bindings]
ThumbwheelScrollUp = "HorizontalScrollLeft"
ThumbwheelScrollDown = "HorizontalScrollRight"
Back = { click = "BrowserBack", wheel = "HorizontalScroll" }
[devices."unit:6be9d300".momentum_scrolling]
enabled = true
glide_ms = 600 # This mouse glides longerStatus: macOS, Linux, and Windows. Per-device controls require the matching device capability on its current connection. See 0x2121 hiResWheel, 0x2150 thumbwheel, and 0x1b04 specialKeysMSEButtons.