Docs

Accessibility is required for Smooth Scrolling, Button Mapping, trackpad edges, and Domain Rules (reading the active browser tab's URL). Without it, the relevant panels explain what's missing and link to System Settings.

Input Monitoring is not required. A Logitech mouse connected directly over Bluetooth triggers one extra Bluetooth pairing prompt; approving it needs a restart to take effect.

A Trigger is what you do to a button. Each one can carry its own Action, and the same button can hold several Triggers as long as no two are of the same kind.

• Click — a plain press and release.
• Double click. Mapping one makes the single click on that button wait for the second press; disable the mapping and the single click is immediate again.
• Long press — held past a threshold you set.
• Directional drag — hold the button and move the mouse up, down, left or right. The pointer stops while the direction is being judged, so focus does not wander to another window.
• Chord — this button while another one is already held.
• Hold + Scroll — hold the button and turn the wheel, in either direction.
• Scroll — the wheel on its own, without holding anything.

An Action is what the Trigger does. Two of them have a beginning and an end: they start when you press and finish when you let go. The rest fire once.

• Send a keyboard shortcut, with any modifiers.
• Run a system action: Mission Control, Application Windows, Show Desktop, move one Space left or right, screenshot the whole screen, screenshot a selection, or lock the screen.
• Press a media key: play/pause, next, previous, volume up, volume down, mute. These go through the system media path, so Apple Music, Spotify and video in a browser all respond.
• Open an application.
• Open a URL.
• Run an AppleScript.
• Run a shell script.
• Modifier Hold — press to hold a modifier key such as Fn, release to let it go. This is the mechanism behind push-to-talk dictation; MouseTuner holds the key, your dictation tool does the rest.
• Pan While Held — while the button is down, pointer movement becomes scrolling, like the hand tool in a map or a canvas. It does not judge a direction and does not fire once; every movement during the hold is converted. The speed is adjustable because the same wrist movement covers very different distances on an 800 DPI and a 3200 DPI mouse.
• Toggle the wheel between ratchet and free-spin. Once the wheel-mode button is mapped, the mouse no longer switches modes on its own, so this Action puts that behaviour back.