SkillAgentSearch skills...

SaneSideButtons

A macOS menu bar app that enables system-wide navigation functionality for side buttons on third-party mice.

Install / Use

/learn @thealpa/SaneSideButtons
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

SaneSideButtons

<p align="center"> <img src="icon.png" width=150 /> </p>

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 2-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

  • macOS Ventura (13.0) and above
  • Intel and Apple Silicon

Automatic launch

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

  1. Click the System Settings icon in the Dock or choose Apple menu  > System Settings.
  2. Open the General preference pane.
  3. Click on Login Items & Extensions 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.

Related Skills

View on GitHub
GitHub Stars658
CategoryDevelopment
Updated1d ago
Forks29

Languages

Swift

Security Score

100/100

Audited on Mar 27, 2026

No findings