Skip to content

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 17:06
· 109 commits to main since this release
10d5cf9

English

Upgrade notes

  • Docker is no longer released. Stop the container (docker compose down) and move to install.sh, Homebrew or the .deb.
  • To keep the Apple ID session, signed WDA and passcodes, copy the container's ./data to ~/.local/share/iphone-control first (how). The phone may ask to trust the computer again.
  • Settings move from .env to ~/.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-config prints.

New

  • One-line installs: install.sh for macOS (Apple Silicon) and Linux, Homebrew, and a .deb for Debian 12+ / Ubuntu 22.04+, each with a background service.
  • First-run guide: run iphone-control after installing. setup --reconfigure redoes 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.
  • lock and home are 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 viewer starts 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_logs no 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)