mactap-app README

The project's README from github.com/jaskirat1616/mactap-app. As one markdown file: README.md.

MacTap app icon

MacTap

Knock the MacBook. The app does the rest.
mactap.vercel.app · Download · GitHub

MacTap lives in the menu bar and turns taps on the chassis — or the desk underneath a still laptop — into shortcuts. One, two, or three knocks. Copy, paste, Accept, screenshots, media, or whatever you map.

Requires a MacBook whose motion sensor is exposed as an SPU HID device: M2 and later, or M1 Pro / Max / Ultra. The original M1 Air (MacBookAir10,1) and some other M1 models do not publish the accelerometer HID report MacTap reads, so knocks cannot be detected. macOS 14.6 or later.

MacTap does not fall back to rebinding arrow keys when the sensor is missing.

Install

  1. Get 2.1.2 from the website or the latest GitHub release.
  2. Prefer MacTap-2.1.2.zip. Unzip and drag MacTap.app into /Applications.
  3. Or open MacTap-2.1.2.dmg and drag MacTap into Applications — do not run it from the disk image.
  4. Open MacTap from Applications (or Spotlight).
  5. Turn on Accessibility when asked, so knocks can send shortcuts.

Detection itself does not need Accessibility. Actions do.

macOS signature check

The app is Developer ID signed and notarized. Gatekeeper evaluates MacTap.app, not the .dmg wrapper. A codesign --verify on the disk image itself will say it is unsigned even when the build is good.

After you copy the app into Applications:

spctl --assess --type execute --verbose /Applications/MacTap.app

You want accepted and source=Notarized Developer ID. If a tool blocks the .dmg, install from the zip instead.

MacTap hero Knock shortcuts Presets

Use

Open Settings from the menu extra to change layout, actions, and sensitivity.

Build from source

brew install xcodegen
xcodegen generate
xcodebuild -project MacTap.xcodeproj -scheme MacTap -configuration Debug \
  CONFIGURATION_BUILD_DIR=/Applications
open /Applications/MacTap.app

A signed, notarized build:

./Scripts/ship.sh

That writes dist/MacTap-<version>.dmg. Notarization uses Xcode’s Developer ID export. Signing the disk image (not just the app) also needs App Store Connect API credentials: APP_STORE_CONNECT_KEY_ID, APP_STORE_CONNECT_ISSUER_ID, and APP_STORE_CONNECT_API_KEY_P8 (or AuthKey_*.p8).

Privacy

Taps are classified on-device. Nothing is uploaded. Gesture maps live in local defaults.

License

MIT

mactap-app (jaskirat1616/mactap-app)

sensors
Searching Database…

What is this?MacTap lets you knock on your MacBook's chassis (or the desk under it) to trigger shortcuts like copy, paste, Accept, screenshots, or media controls.
Is this a background app or does it have a window?It is a macOS menu bar app with no main window; you configure layouts, actions, and sensitivity from Settings opened via the menu extra.
Does my Mac's hardware support this?You need an M2-or-later Mac, or an M1 Pro/Max/Ultra, running macOS 14.6 or later, because the motion sensor has to be exposed as an SPU HID device.
Will knock detection work on any M1 MacBook?No — the original M1 Air (MacBookAir10,1) and some other M1 models don't publish the accelerometer HID report MacTap reads, and there's no fallback to rebinding arrow keys for those devices.
Do I need to grant any special permission?Yes — Accessibility must be enabled so MacTap can send the mapped shortcuts; detecting the knocks itself doesn't require it.
Is this available outside macOS?No, it's a macOS-only menu bar app tied to Apple Silicon motion sensors.
Where does my tap data go?Taps are classified entirely on-device and nothing is uploaded; gesture maps are stored only in local defaults.
Why does a signed .dmg sometimes show as unsigned?Gatekeeper evaluates MacTap.app, not the .dmg wrapper, so running codesign --verify on the disk image itself can report unsigned even when the build is good; install from the zip if a tool blocks the dmg.
Can different apps or screen areas trigger different actions?Yes — left and right edges of the chassis can map to different action sets, and per-app overrides exist, for example Cursor can get Accept/Reject/Save while other apps stay on the Daily preset.
What built-in presets come with MacTap?It ships with Daily, Coding, Capture, Media, and Focus presets that you can assign globally, per edge, or per app.
How many knocks does it recognize?MacTap distinguishes one, two, or three knocks, each of which can be mapped to a different shortcut.
Size
1.7 MB
Stars
701
Age
1mo
Commits · 90 Days