Skip to content

Building from Source

soifaxa edited this page Oct 22, 2026 · 1 revision

Building from Source

Requirements

  • macOS 13 or later
  • Xcode Command Line Tools (xcode-select --install)
  • Swift compiler (swiftc)

Build

From the repository root:

./build.sh

This produces build/MagicMouseTap.app, ad-hoc signed for Accessibility identity stability.

Architecture

By default the script builds for the host CPU (uname -m). Override with:

ARCH=arm64 ./build.sh      # Apple silicon
ARCH=x86_64 ./build.sh     # Intel
ARCH=universal ./build.sh  # both (lipo)

Run

open build/MagicMouseTap.app

Or install:

cp -R build/MagicMouseTap.app /Applications/

Then grant Accessibility access.

How it works (overview)

The app links against Apple’s private MultitouchSupport.framework, watches short finger contacts on the Magic Mouse surface, and posts CGEvent mouse clicks via Accessibility APIs.

Not App Store eligible; may need updates after major macOS releases.

Clone this wiki locally