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)

Searching Database…

698 ·GitHub
Mactap-app
这是什么？MacTap 让你敲一敲 MacBook 的机身（或它底下的桌面）来触发拷贝、粘贴、Accept、截屏或媒体控制等快捷操作。
这是个后台应用，还是有窗口的？它是一个没有主窗口的 macOS 菜单栏应用；你通过菜单栏图标打开的 Settings 来配置布局、动作和灵敏度。
我的 Mac 硬件支持吗？你需要 M2 或更新机型的 Mac，或 M1 Pro/Max/Ultra，并运行 macOS 14.6 或更高版本，因为运动传感器必须以 SPU HID 设备的形式暴露出来。
敲击检测在所有 M1 MacBook 上都管用吗？不行——初代 M1 Air（MacBookAir10,1）和另外一些 M1 机型不会广播 MacTap 所读取的加速度计 HID 报告，而且这些设备也没有改绑方向键的备选方案。
我需要授予什么特殊权限吗？需要——必须启用辅助功能（Accessibility），MacTap 才能发送映射的快捷键；检测敲击本身不需要这个权限。
macOS 之外能用吗？不能，这是一个只支持 macOS 的菜单栏应用，依赖 Apple Silicon 的运动传感器。
我的敲击数据都去哪儿了？敲击完全在设备本地分类，什么都不上传；手势映射只存在本地偏好设置里。
为什么签名过的 .dmg 有时会显示成未签名？Gatekeeper 检查的是 MacTap.app，不是 .dmg 外壳，所以对磁盘镜像本身运行 codesign --verify 可能报告未签名，即使构建本身没问题；如果哪个工具拦截了 dmg，就用 zip 安装。
不同的应用或屏幕区域能触发不同的动作吗？能——机身左右两边可以映射到不同的动作集合，还支持按应用覆盖，比如 Cursor 可以用 Accept/Reject/Save，其他应用保持 Daily 预设。
MacTap 自带哪些内置预设？它自带 Daily、Coding、Capture、Media 和 Focus 预设，可以全局分配，也可以按边缘或按应用分配。
它能识别几次敲击？MacTap 能区分一次、两次或三次敲击，每一种都可以映射到不同的快捷键。
What are similar projects?kinesis, OpenYoink, Sapphire, rooms, BetterDisplay, Mouser, Thaw, boring.notch
Which topics is it in?gesture-control, sensors, menubar-app, menu-bar, privacy-first, accessibility, apple, macos-app, hardware, apple-silicon, swift, utility
Creator
jaskirat1616
Size
1.7 MB
Stars
698
Updated
CommitSep 10Releasev2.1.2Sep 10
Age
1mo
Commits · 90 Days