Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 01 Nov 16:41
· 10 commits to main since this release

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_for and iphone_batch. Action tools accept then to 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 .xctest bundle, 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).
  • setup wizard, doctor diagnostics, 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-control for 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-config printing a direct command, and a systemd user service.

Docker image: ghcr.io/derrors/iphone-control:0.1.0 (linux/amd64, linux/arm64)