Skip to content

Godmouse 0.1.0

Choose a tag to compare

@Malik1942 Malik1942 released this 19 Aug 07:08
· 21 commits to main since this release

First public release.

The Magic Mouse's top shell stays touch-sensitive while you click, so every click is also a tiny swipe — the page jumps, dragged windows scroll out from under you, links move as you aim at them. macOS has no setting for it. Godmouse is that setting, plus the rest of the Magic Mouse's rough edges.

What's in it

  • Block scroll while clicked — scrolling is swallowed while a Magic Mouse button is held, with an adjustable grace period after release to catch the trailing scroll your finger makes coming off the shell
  • Dead zone — ignore micro-jitter from a finger resting on the shell
  • Axis lock — once a scroll commits to one axis, kill drift on the other
  • Momentum toggle — drop the coasting tail, for the Magic Mouse only
  • Per-app rules — different behaviour per application (no scrolling in Figma, no horizontal in Excel, …)
  • Modifier actions — ⌘/⌥/⌃/⇧ + scroll → horizontal, invert, zoom, or nothing
  • Battery warning — a nudge before the mouse dies

Only the Magic Mouse is affected; trackpads and other mice pass through untouched.

Install

Download Godmouse.zip, unzip, drag Godmouse.app to /Applications, then:

xattr -dr com.apple.quarantine /Applications/Godmouse.app
open /Applications/Godmouse.app

This build is unsigned (no paid Apple Developer membership behind the project), which is what the xattr line is for — or right-click the app → Open. If you'd rather not run an unsigned binary, build from source with ./install.sh; it's a two-minute build.

Then grant System Settings → Privacy & Security → Accessibility → Godmouse. The app starts working within two seconds, no relaunch.

Updating

Because the release is unsigned, macOS sees each new version as a different app and quietly stops honouring your existing Accessibility grant. If the toggle looks ON but Godmouse says it has no permission, use Settings → General → Reset grant…, or run tccutil reset Accessibility com.godmouse.app.

Requires macOS 13 or later. Tested on macOS 26 with a Magic Mouse 2.