Voice-guided remote control for your headless Mac.
AirPlay mirroring & WiFi management without a display.
Open source. Built with Swift. Fully vibe-coded.
▸ Scanning for AirPlay devices...
✓ Found: Living Room Apple TV
✓ Found: Bedroom Apple TV
▸ "Two devices found. Press 1 for Living Room, 2 for Bedroom."
⌃⌥M pressed → Connecting to Living Room Apple TV...
✓ Screen mirroring active — Entire Screen mode
▸ "Connected to Living Room Apple TV."
_
Everything you need to control a headless Mac
Discovers Apple TV via Bonjour, filters display-capable devices, handles PIN entry, and starts full-screen mirroring through Control Center automation.
Scans networks with signal strength & security status, connects automatically, monitors for wrong password errors, and verifies connection.
Every action is announced — device lists, connection status, errors. Works entirely without seeing the screen. English & Ukrainian voice support.
Control Center automation via macOS Accessibility API
Control everything from the keyboard — no display needed
Download the app or build from source
git clone https://github.com/AlexLuzik/headless-helper.git
cd headless-helper
chmod +x build.sh && ./build.sh
Requires macOS 14 (Sonoma) or later · Accessibility permission needed
A display is required for the initial setup — to install the app, grant Accessibility permission, and enable Launch at Login in the app settings. After that, you can go fully headless.
This entire project — every line of Swift, every build script, this very page — was designed, architected, and written through human-AI collaboration. No code was written by hand.