Skip to content

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

License

Notifications You must be signed in to change notification settings

pakerwreah/SaneSideButtonsDebounced

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

82 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Why this fork? 🤔

I needed something to fix my Razer Orochi v2 which started to double click basically every button after a year of use (shame on you Razer).

I was already using SensibleSideButtons by Alexei Baboulevitch and I wanted to add debouncing to it, but the project is abandoned for a while and I didn't want to maintain it in Objective-C.

I thought about rewriting the parts I was interested in but then I found SaneSideButtons by Jan Hülsmann which had already done the hardest part.

This fork is for my personal use, but if you have the same problem and don't want to compile it yourself, feel free to open an issue on this repository and I can provide you a working build.

SaneSideButtons (original)

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

  • 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.
  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.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • Swift 99.9%
  • Ruby 0.1%