https://github.com/thealpa/SaneSideButtons

A macOS menu bar app that enables system-wide navigation functionality for side buttons on third-party mice.
https://github.com/thealpa/SaneSideButtons

macos mouse-events objective-c

Last synced: 1 day ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/thealpa/SaneSideButtons
• Owner: thealpa
• License: gpl-2.0
• Created: 2021-05-15T11:36:24.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2024-08-01T22:30:35.000Z (3 months ago)
• Last Synced: 2024-08-03T15:11:34.537Z (3 months ago)
• Topics: macos, mouse-events, objective-c
• Language: Swift
• Homepage: https://janhuelsmann.com/sanesidebuttons
• Size: 9.32 MB
• Stars: 325
• Watchers: 12
• Forks: 14
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

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](https://github.com/archagon/sensible-side-buttons) by Alexei Baboulevitch. More information about SensibleSideButtons can be found on his [website](https://sensible-side-buttons.archagon.net/). Please consider using his [Amazon affiliate link](http://amzn.to/2tlwbAB) when making any purchase.

Starting with version 1.0.7 SaneSideButtons is maintained by [Jan Hülsmann](https://github.com/thealpa) and offers native Apple Silicon support.

## Installation

Download SaneSideButtons from [here](https://github.com/thealpa/SaneSideButtons/releases/download/1.1.0/SaneSideButtons.dmg) or install using Homebrew:

```bash

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 Preferences` icon in the Dock or choose Apple menu  > System Preferences.

1. Open the `General` preference pane.

1. Click on `Login Items` in the right preference pane.

1. Click on the plus button at the bottom of the `Open at Login` pane.

1. Navigate to your Applications folder (or wherever you put the app) and double-click `SaneSideButtons`.