Installation
- See GitHub for source, build instructions and development milestones. This page does not provide a DMG yet.
- The iPhone app requires a development installation. Public installation instructions will be added when available.
- Use macOS 26+ and iOS 26+ for pairing validation, following repository instructions for permissions and iCloud.
Requires macOS 26 and iOS 26 or later.
First-time setup
- Open the Mac app. The setup assistant walks through each permission: Bluetooth, Accessibility (to type your password), Camera, Notifications and iCloud.
- Show the QR code from the assistant or from the menu bar (AetherGuard → Pair New iPhone…), then scan it with the AetherGuard iPhone app or the Camera app.
- Enter your Mac login password in Settings to turn on auto-unlock.
- Put your iPhone where it usually is when you sit at the Mac and click Calibrate Here.
Troubleshooting
- Doesn't unlock when you return: check that Accessibility access is still granted. After a failed unlock, auto-unlock pauses until you save your password again.
- Locks too late, or locks while you're sitting there: recalibrate at your seat, or adjust the delay in Settings.
- No alerts on your phone: allow notifications for AetherGuard on the iPhone, and make sure both devices use the same Apple ID and are online.
- After restarting your iPhone, unlock it once before the Bluetooth connection resumes.
Updates
Update development builds using repository instructions. Mac auto-update and TestFlight distribution details will be confirmed at public release.
Issue Reporting
When reporting a problem, include both app versions (bottom of the Mac menu, About on the iPhone) and the log exported from the debug window.