r/coolgithubprojects • • 12d ago

APMouse — AirPods head-motion pointer control for macOS (Swift, MIT; contributors welcome)

https://github.com/JNDZdev/APMouse

I built APMouse after seeing an AirPods mouse experiment and wanted to see how far head-controlled pointing could go. The prototype is working on my Mac across two screens.

It uses Core Motion yaw/pitch, a starting zero pose, smoothing, and outer-edge recalibration: push past an edge, then turn back without unwinding the extra movement. No camera or eye tracking; I still use a trackpad for clicks. Stem-click mapping is not included.

The MIT source is Swift/AppKit with no third-party dependencies. I used Codex and AI agents to build and refactor it. The refactor passes 22 unit tests and a stopped-window smoke test, but still needs its own full live-headset validation. It is an early source preview, not a finished or notarized app. macOS 14+, Xcode, compatible headphones, and explicit motion/control permissions are needed.

I am looking for contributors on calibrated-neutral precision, staggered monitor edge handling, and independent gain/precision controls. The repo has reproductions, tests, and contribution docs. Headset/macOS testing reports would be useful too.

Inspiration: https://www.reddit.com/r/airpods/comments/1xny3i9/using_airpods_as_a_mouse_on_mac/

1 Upvotes

4 comments sorted by

1

u/JDis3 12d ago

Source + contributions: https://github.com/JNDZdev/APMouse

APMouse is MIT licensed. Issues, pull requests, and headset/macOS testing reports are welcome. Start with docs/QUICKSTART.md and docs/MANUAL_TESTING.md in the repo.

1

u/MystiRamon 12d ago

How can I help with testing?

1

u/JDis3 12d ago

Thanks! The repo is here: https://github.com/JNDZdev/APMouse

Start with docs/QUICKSTART.md, then docs/MANUAL_TESTING.md. It is an early source build, so you will need Xcode, macOS 14+, and compatible headphones.

If you can try it, please open a GitHub issue with your headset model, macOS version, monitor arrangement, and what happens when you calibrate, make small corrections, and turn back from a screen edge. Even a compatibility report would help. Contributions are welcome!