Repository navigation
A standalone Mac app for live iPhone mirroring over USB, with native Home/App Switcher controls, keyboard input, and a local MCP server.
Download
- iPhoneBridge-0.2.0-macOS-arm64.zip — unzip and move iPhoneBridge.app into Applications. Python, USB utilities, the viewer, and the phone daemon are included.
- iPhoneBridge-0.2.0-corresponding-source.tar.gz — complete app and dependency sources, patches, notices, exact build recipes, and rebuild/replacement instructions.
- SHA256SUMS — checksums for both assets.
Requirements
Apple silicon Mac on macOS 26+; USB-connected, trusted, unlocked jailbroken iPhone on iOS 15.1.1; existing SSH key access as mobile. Tested on iPhone 13 Pro. This does not support stock iPhones.
Open the app to connect. Use Settings… for device selection or a custom SSH key. ⌘1 sends Home and ⌘2 opens App Switcher; drag a card upward to close a phone app. Keep human and agent input separate.
The app is ad-hoc signed and is not Apple-notarized. macOS may require Privacy & Security → Open Anyway after the first launch attempt. Apple's instructions.
Verified
- Hosted CI passes: 48 Python tests, 17 viewer tests, and Swift release compilation.
- Installed app mirrors the real phone; native buttons, shortcuts, settings, reconnect, cleanup, and CLI input were checked live.
- Installed MCP server returns six tools and a verified native screenshot.
- Final ZIP passes signature verification and self-test after extraction with a clean HOME/PATH.
- Device daemon was rebuilt from the accompanying offline source package.
Original bridge code/artwork is MIT licensed. TrollVNC and the combined phone daemon are GPL-2.0-only; other components retain their own GPL/LGPL/MPL and permissive terms. Component licenses and credits.