Skip to content
This repository was archived by the owner on Nov 9, 2026. It is now read-only.

v0.2.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 07 Nov 01:47
v0.2.0
c82e491

Live screen viewer, optional WebView debugging, and a successor project.

We recommend iphone-control (https://github.com/Derrors/iphone-control) for new setups. It succeeds
this project as one Rust binary for Linux and macOS, supports iPhone and iPad, and keeps the MCP tools compatible.

New

  • iphonectl viewer: a desktop window with the phone's screen live from WebDriverAgent's MJPEG stream,
    controlled with mouse and keyboard (tap, long press, swipe, scroll, typing, Home, close app). It runs
    next to the MCP server and shares its WebDriverAgent session. Needs Python 3.11+ with Tk and Pillow on the host.
  • Optional WebView debugging: Safari tabs and inspectable WebViews over the Chrome DevTools Protocol
    on 127.0.0.1. Off by default; set CDP_PORT=9222 in .env to turn it on.
  • iphonectl doctor checks the live stream and the number of inspectable pages.

Fixes

  • The MCP server joins the active WebDriverAgent session instead of replacing it, and after a WDA restart
    clients no longer keep ending each other's sessions.
  • The supervisor manages one port forward per port, so the WDA and MJPEG forwards restart independently.

Upgrading

  • New .env options: MJPEG_PORT (default 9100, 0 turns it off) and CDP_PORT (default 0, off).
    The container uses host networking: if another service on the host already uses port 9100, set MJPEG_PORT=0.
  • Chinese docs now cover the viewer and WebView debugging.

Testing: unit tests, lint and the image build pass. The viewer was exercised against a simulated
WebDriverAgent; the contributor tested the original version on an iPhone 15 (iOS 27.2). The fixes made
during review have not been tested on a real phone yet — reports are welcome.

Thanks to TheSalaty for the viewer and WebView debugging (#1).

Container image

docker pull ghcr.io/derrors/iphone-control-toolkit:0.2.0

Digest: sha256:fc7e81530f9b2a2e244aec73299114148c5dfba5c4f133e1c6108f3beebb7704 (linux/amd64). Verify provenance with
gh attestation verify oci://ghcr.io/derrors/iphone-control-toolkit:0.2.0 -R Derrors/iphone-control-toolkit.

Third-party source code

The image contains GPL and LGPL components (pymobiledevice3, usbmuxd, libimobiledevice and others).
Their complete corresponding source is attached to this release — see SOURCES.md.

What's Changed

  • Live screen viewer (iphonectl viewer) and WebView debugging over CDP by @TheSalaty in #1

New Contributors

Full Changelog: v0.1.0...v0.2.0

Contributors

TheSalaty
Assets 7
Loading