Set up your mouse the way you work

Three things it does

1. 01

   Smooth Scrolling

   Turns the discrete steps a scroll wheel sends into smooth, pixel-level inertial scrolling. The Scroll Curve (minimum step, velocity gain, duration, decay) is edited visually with a live preview, and can be overridden per app.

   Wheel events, untouched

   56 px

   one jump per detent, no frames in between

   Through the Standard Scroll Curve

   56 px · 320 ms

   most of the distance lands in the first few frames

2. 02

   Button Mapping

   A button holds a list of Triggers, and each Trigger points at exactly one Action. Here, click sends a keyboard shortcut and long press holds a modifier down. Triggers go up to a four-way drag, a Chord, or Hold + Scroll; Actions go up to an AppleScript or a shell command. Both can be overridden per app.

   Wheel Mode Button

   Click

   Keyboard shortcut

   fn⌃⌥⇧⌘Space

   Long press

   Hold modifier

   fn⌃⌥⇧⌘

   Held only while the mouse button is down.

3. 03

   DPI, SmartShift and battery

   On a Logitech mouse MouseTuner recognizes, these settings are read and changed from the Device panel. Any other mouse still gets Smooth Scrolling and Button Mapping.

   MX Master 3S Bluetooth

   DPI1000

   SmartShiftFollow deviceRatchetFree spin

   Auto-disengage threshold10

   Only used while SmartShift follows the device.

   Battery85%

   Buttons7 buttons

Hold a side button, talk, let go

Modifier Hold is the one Action with a beginning and an end. Map it to Fn and any push-to-talk dictation tool starts and stops with your thumb.

MouseTunerFileEditViewWindowHelp

A

Recordingsnotes.md

Notes — team update

Shipping notes for this week:

SM

Click the Wheel Mode Button to start talking, or press and hold it.fn up · 0.00 s

1. 01Map a side button's long press to Hold modifier → Fn.
2. 02Hold the button and speak. The tool records for exactly as long as you hold.
3. 03Let go. The modifier is released and the button goes back to doing nothing.

Works with anything that listens for a held key: Typeless, Wispr Flow, superwhisper, macOS Dictation.

A modifier stuck in the down position is the worst thing this app could do to you, so the Buttons panel always carries a “Release Held Modifiers” button, and the engine releases on app switch, on permission loss, and on tap failure.

One less thing to switch by hand

Rules pick your input source by front app, or by the domain of the browser tab you are on. Matching falls back from the exact host to its parent domain and ignores a www. prefix. Reading a browser's URL needs Accessibility; switching by app does not.

Palms resting on the trackpad stop counting

Type on a MacBook with a mouse beside it and your palms end up on the trackpad. The Trackpad panel ignores those touches one of two ways: switch the built-in trackpad off whenever a mouse is connected, or shade bands along its edges, so a touch that lands there counts as a palm wherever it slides next.

Two things it cannot stop. Without a mouse connected, the pointer still follows a palm: the only way to hold it still is to switch the built-in trackpad off, and macOS does that only while a mouse is present. And a palm plus a real finger reaches the driver as a two-finger gesture, which cannot be pulled apart.

What's different

Unmapped keys behave like MouseTuner isn't installed

That is the default. Anything without a mapping, any device without a profile, any feature without permission: the behavior stays identical to not having the app, and the interface explains why.

MSMS2WS1T

Wheel Mode Button

0x00C4 → Hold modifier · fn

The one button on this mouse with a mapping. Hold it and Fn stays down for exactly as long as you hold it.

Questions