Repository navigation
v0.2.0
English
Upgrade notes
- Docker is no longer released. Stop the container (
docker compose down) and move toinstall.sh, Homebrew or the.deb. - To keep the Apple ID session, signed WDA and passcodes, copy the container's
./datato~/.local/share/iphone-controlfirst (how). The phone may ask to trust the computer again. - Settings move from
.envto~/.config/iphone-control/env. - The daemon no longer runs usbmuxd. On Linux, install the system one (
sudo apt install usbmuxd), and unmask it if you masked it for the container. - Register the MCP server again: the first-run guide does it, or run the command
iphone-control mcp-configprints.
New
- One-line installs:
install.shfor macOS (Apple Silicon) and Linux, Homebrew, and a.debfor Debian 12+ / Ubuntu 22.04+, each with a background service. - First-run guide: run
iphone-controlafter installing.setup --reconfigureredoes any part of it. iphone-control service install|uninstall|start|stop|restart|status.- AI tasks on the control page: type a task and Claude Code or Codex does it on the phone. Pause, take over or stop it at any time, and it asks before paying, deleting or sending.
- A revoked signing certificate is detected and the device re-signed automatically.
- The control page follows device switches, explains why there is no picture, and can sign and install WDA.
Improvements
- New control page: AI assistant, live screen with zoom, and a device panel with apps and elements. In English or Chinese.
- On iOS 27 and later the picture works like a touchscreen: about 20 ms per tap instead of 530 ms.
- The picture runs at about 50 fps.
Fixes
- The mouse wheel works again on the control page below iOS 27.
lockandhomeare much faster on newer iPhones, and taps no longer take 26 s while something animates.- Home pressed during an app transition on iPad is retried.
- After a restart, the daemon goes on with the last device that was ready.
iphone-control viewerstarts even before the daemon has picked a device.- Clearer hints when WDA fails with
unexpected response, Web Inspector is off, or the daemon can't be reached. iphone_app_logsno longer returns Info lines.
中文
升级注意事项
- 不再发布 Docker 镜像。先停掉容器(
docker compose down),改用install.sh、Homebrew 或.deb。 - 想保留 Apple ID 会话、签好的 WDA 和解锁密码,先把容器的
./data复制到~/.local/share/iphone-control(做法)。手机可能会再问一次是否信任这台电脑。 - 设置从
.env搬到~/.config/iphone-control/env。 - 守护进程不再自己运行 usbmuxd。Linux 上装系统的(
sudo apt install usbmuxd),之前为容器屏蔽过的要解除屏蔽。 - 重新注册 MCP 服务:首次引导会做,或运行
iphone-control mcp-config打印的命令。
新功能
- 一行安装:macOS(Apple Silicon)和 Linux 用
install.sh,还有 Homebrew 和 Debian 12+ / Ubuntu 22.04+ 的.deb,都带后台服务。 - 首次引导:装好后运行
iphone-control;setup --reconfigure可以重做任意一部分。 iphone-control service install|uninstall|start|stop|restart|status。- 控制台上的 AI 任务:输入任务,Claude Code 或 Codex 在手机上完成。随时可以暂停、接管或停止,付款、删除、发送前会先问你。
- 签名证书被吊销时会自动发现并重新签名。
- 控制台跟着切换的设备走,说明没有画面的原因,还能签名并安装 WDA。
改进
- 新的控制台:AI 助手、可缩放的实时画面、带 App 和元素的设备面板,中英文都有。
- iOS 27 及以上,画面像触屏一样操作:一次点按约 20 毫秒,原来约 530 毫秒。
- 画面约每秒 50 帧。
修复
- iOS 27 以下,控制台的鼠标滚轮恢复可用。
- 新款 iPhone 上
lock、home快了很多,界面有动画时点按不再要 26 秒。 - iPad 上 App 切换动画中按的 Home 会再补按一次。
- 重启后,守护进程沿用上次就绪的设备。
- 守护进程还没选好设备时,
iphone-control viewer也能启动。 - WDA 报
unexpected response、没开 Web Inspector、连不上守护进程时,提示更清楚。 iphone_app_logs不再返回 Info 级别的日志。
Binaries / 二进制: linux-x86_64, linux-aarch64 (glibc 2.34+), macos-arm64 (macOS 11+, Apple Silicon); .deb amd64, arm64 (Debian 12+, Ubuntu 22.04+)
Install / 安装: curl -fsSL https://raw.githubusercontent.com/Derrors/iphone-control/main/install.sh | sh (macOS, Linux) · brew install derrors/tap/iphone-control · Debian/Ubuntu: sudo apt install ./iphone-control_0.2.0_amd64.deb (or _arm64.deb)