跳至主要内容

Button & Side-Button Mapping

macOS treats most extra mouse buttons as dead weight. Mouse+ turns side buttons, wheel tilt, and thumb buttons into real actions — back/forward, app launches, window controls, media keys, or any shortcut you record.

Mappable buttons​

Depending on your device, Mouse+ exposes:

  • Left, Right, Middle
  • Button 4, Button 5 (side buttons)
  • MR / ML — wheel tilt right / left
  • Thumb button (the SM key on MX Master and MX Anywhere models)

For recognized mice, side buttons are mapped automatically after detection, so there is less manual setup.

Action types​

Each button (and gesture) can trigger:

  • App launch — open a specific application.
  • System controls — window controls, Mission Control, Switch Space Left/Right, Control Center, Notification Center, screenshots, Finder actions, and developer workflows.
  • Media — playback and volume, grouped under a dedicated Media Control category.
  • Shortcuts — record any key combination, including plain single keys and system-reserved keys, with the built-in shortcut recorder.
  • Custom scripts — run AppleScript, with built-in templates such as toggle dark mode, system mute, or restart Dock. See Shortcuts & Hotkeys.

Modifier-hold​

A button can hold a modifier key for as long as you press it, releasing the instant you let go. This is the foundation for push-to-talk: hold a side button to keep a voice tool listening, release to stop. See Push-to-Talk Voice Typing with a Mouse Button.