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…

691 ·GitHub
Mactap-app
Что это?MacTap позволяет постучать по корпусу MacBook (или по столу под ним), чтобы запустить шорткаты вроде копирования, вставки, Accept, скриншотов или управления медиа.
Это фоновое приложение или у него есть окно?Это приложение в строке меню macOS без главного окна; раскладки, действия и чувствительность настраиваются в Settings, открывающемся через значок в строке меню.
Поддерживает ли железо моего Mac это?Нужен Mac на M2 или новее, либо M1 Pro/Max/Ultra, с macOS 14.6 или выше, поскольку датчик движения должен быть доступен как HID-устройство SPU.
Будет ли детект стука работать на любом MacBook M1?Нет — оригинальный M1 Air (MacBookAir10,1) и некоторые другие модели M1 не отдают HID-отчёт акселерометра, который читает MacTap, и запасного варианта с перепривязкой стрелок для этих устройств нет.
Нужно ли выдавать какое-то особое разрешение?Да — должен быть включён Accessibility, чтобы MacTap мог отправлять назначенные шорткаты; сам детект стука этого не требует.
Доступно ли это вне macOS?Нет, это приложение только для macOS в строке меню, привязанное к датчикам движения Apple Silicon.
Куда уходят мои данные о стуках?Стуки распознаются полностью на устройстве, и ничего не выгружается; карты жестов хранятся только в локальных настройках.
Почему подписанный .dmg иногда отображается как неподписанный?Gatekeeper проверяет MacTap.app, а не оболочку .dmg, поэтому codesign --verify на самом образе диска может показать «unsigned», даже если сборка в порядке; устанавливайте из zip, если какой-то инструмент блокирует dmg.
Могут ли разные приложения или зоны экрана запускать разные действия?Да — левому и правому краю корпуса можно назначить разные наборы действий, есть переопределения по приложениям: например, 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
691
Updated
CommitSep 10Releasev2.1.2Sep 10
Age
1mo
Commits · 90 Days