search

thealpa / SaneSideButtons

A macOS menu bar app that enables system-wide navigation functionality for side buttons on third-party mice.
https://janhuelsmann.com/sanesidebuttons
GNU General Public License v2.0
362 stars 15 forks source link
macos mouse-events objective-c

readme

SaneSideButtons

macOS mostly ignores the M4/M5 mouse buttons, commonly used for navigation. Third-party apps can bind them to ⌘+[ and ⌘+], but this only works in a small number of apps and feels janky. With this tool, your side buttons will simulate 3-finger swipes, allowing you to navigate almost any window with a history. As seen in the Logitech MX Master!

About SaneSideButtons

SaneSideButtons is a fork of the abandoned SensibleSideButtons by Alexei Baboulevitch. More information about SensibleSideButtons can be found on his website. Please consider using his Amazon affiliate link when making any purchase.

Starting with version 1.0.7 SaneSideButtons is maintained by Jan Hülsmann and offers native Apple Silicon support.

Installation

Download SaneSideButtons from here or install using Homebrew:

brew install --cask sanesidebuttons

Compatibility

Automatic launch

To launch SaneSideButtons automatically when you log in on your Mac:

  1. Click the System Preferences icon in the Dock or choose Apple menu  > System Preferences.
  2. Open the General preference pane.
  3. Click on Login Items in the right preference pane.
  4. Click on the plus button at the bottom of the Open at Login pane.
  5. Navigate to your Applications folder (or wherever you put the app) and double-click SaneSideButtons.