Repository navigation
v0.1.0
First public release.
Added
iphone-control daemon: one long-running process owns the phone — usbmuxd supervision (with a sysfs fallback for containers without udev), pairing and Developer Mode checks, Developer Disk Image download and mounting, a CoreDevice tunnel with a user-space TCP stack, WebDriverAgent launch and health checks, and a state machine that recovers from unplugging, usbmuxd restarts and phone reboots.- MCP server with 15 tools: status, screenshots with zoom-in regions, element lists, tap / tap by text, long press, swipe, typing (including Chinese), hardware buttons, app launch / terminate / list, URLs,
iphone_wait_forandiphone_batch. Action tools acceptthento return the screen after the action. - HID fallback for taps, swipes, buttons, ASCII typing and screenshots while WebDriverAgent is unavailable.
- Signing of WebDriverAgent with a free Apple ID (two-factor and SMS login), including the
.xctestbundle, a post-signing check, automatic re-signing before the 7-day profile expires, and a daily Apple ID session check. - Notifications through Bark and Telegram, with de-duplication.
- Optional auto-unlock with strict safeguards (stops after one wrong attempt).
setupwizard,doctordiagnostics,status,mcp-config,wda-bridge,notify-test.- Docker image (single binary plus Debian's usbmuxd, not privileged) with a generated third-party license list, published to
ghcr.io/derrors/iphone-controlfor linux/amd64 and linux/arm64. - Running without Docker, from source or from the prebuilt Linux binaries (x86_64, aarch64): as a regular user with the system usbmuxd, XDG data and socket paths, the unsigned WebDriverAgent downloaded and checksum-verified before the first signing,
mcp-configprinting a direct command, and a systemd user service.
Docker image: ghcr.io/derrors/iphone-control:0.1.0 (linux/amd64, linux/arm64)