musubipapi/airpointer

选用指南

AI 根据 README 整理 · 2026/11/6 14:52:20

使用方式

通过构建脚本生成应用，打开后按 fn 键连接，按提示完成设置。

查看 README 依据

## Requirements | Item | Status | |---|---| | AirPods Pro 3, macOS 26, Apple Silicon | Tested on one Mac with one pair | | AirPods Pro 2 | Recognized, not tested | | AirPods paired with your Mac | Required | | Xcode | Required to build | Normal connect and disconnect have run many times on that Mac and pair. These cases have not been tested on purpose: - Force quit during a session - Sleep and wake during a session - Bluetooth lost during a session - Calls and audio during and after a session ## Build and run ```sh zsh ./build.sh open AirPointer.app ```

The build also runs `--self-test` and the tap check. The other offline checks are under [For developers](#for-developers). Do not build during a pointer session. If AirPointer does not appear in the Accessibility list after a rebuild, run: ```sh tccutil reset Accessibility local.airpointer ``` ## Set it up The first time you open the app, setup has four steps. <p align="center"> <img src="Assets/Readme/setup.png" width="100%" alt="The four setup steps: Allow, Connect, Calibrate and Tap"> </p> 1. **Allow:** Drag AirPointer into the Accessibility list. This lets it move the

cursor and click. 2. **Connect:** Open the lid, close the lid, set the case down for a moment, and turn it upright. 3. **Calibrate:** Point at three dots to show the app where your screen is. 4. **Tap:** Tap the front of the case three times. ## Use it Press **fn ⌃** in any app to connect. Press it again to pause or resume. To use a different shortcut, go to Settings. <p align="center"> <img src="Assets/Readme/screens.png" width="100%" alt="The AirPointer window, the menu bar panel, and the notch while pointing"> </p>

部署要求

需要 AirPods Pro 3、macOS 26 和 Apple Silicon，且 AirPods 需与 Mac 配对。

查看 README 依据

## Requirements | Item | Status | |---|---| | AirPods Pro 3, macOS 26, Apple Silicon | Tested on one Mac with one pair | | AirPods Pro 2 | Recognized, not tested | | AirPods paired with your Mac | Required | | Xcode | Required to build | Normal connect and disconnect have run many times on that Mac and pair. These cases have not been tested on purpose: - Force quit during a session - Sleep and wake during a session - Bluetooth lost during a session - Calls and audio during and after a session ## Build and run ```sh zsh ./build.sh open AirPointer.app ```

已知限制

会话在盖子关闭约30分钟后结束，期间音频会中断，且未测试强制退出、睡眠唤醒等场景。

查看 README 依据

| **Case data** | Ending a session uses up the diagnostic data stored on the case. | | **AirPods settings** | Some AirPods connection settings stay as the session set them. We do not know yet if this change, or the case data change, lasts after the Bluetooth link resets. | | **Audio** | Each connection drops the AirPods' Bluetooth link for a moment, and their audio stops. Do not connect during a call. |

Edges -->|"No"| Dots["Point at three dots"] Edges -->|"Yes"| Pointing(["Pointing"]) Dots --> Pointing Pointing -->|"fn ⌃"| Paused(["Paused"]) Paused -->|"fn ⌃"| Pointing ``` </details> ## Known limitations **Sessions end about 30 minutes after the lid closes.** The app does not set this limit. At that point motion stops, and the AirPods stay unreachable until you open the lid. To continue, open and close the lid. In one test, reconnecting with the lid closed did not reset the limit. The likely cause is timer `0x63` in the earbud firmware. We found it by reading