Run a virtual iPhone on an Apple Silicon Mac.
Swift
docs: Add `restore_offline` documentation
zqxwce856576e93b68
diff --git a/README.md b/README.mdindex 4119e91d..b3be4bb6 100644--- a/README.md+++ b/README.md@@ -158,6 +158,8 @@ make boot_dfu # boot VM in DFU mode (keep running)# terminal 2make restore_get_shsh # fetch SHSH blobmake restore # flash firmware via pymobiledevice3 restore backend+# or: make restore_offline # offline restore (decrypts AEA images in place, uses cached .shsh blob)+ # for the first time should be ran with internet access for AEA decryption```## Install Custom Firmware@@ -314,6 +316,15 @@ make fw_patchOur patches are applied via binary analysis, not static offsets, so newer versions should work. If something breaks, ask AI for help.+**Q: I used `restore_offline` and I am stuck in the setup screen**++The device is trying to contact apple for the setup, and you are probably not connected to the internet if you used `restore_offline`.+You can bypass most of the setup screen by making the device supervised:++```bash+python3 -m pymobiledevice3 profile supervise vphone+```+## Automationvphone-cli exposes a host control socket (`vm/vphone.sock`) for programmatic VM interaction — screenshots, touch injection, swipe gestures, hardware keys, and clipboard. Every action returns a compact grayscale screenshot inline, enabling AI-driven E2E testing workflows.diff --git a/docs/README_ja.md b/docs/README_ja.mdindex 8bc6d564..5c5c2922 100644--- a/docs/README_ja.md+++ b/docs/README_ja.md@@ -146,6 +146,8 @@ make boot_dfu # DFUモードでVMを起動(実行したまま# ターミナル 2make restore_get_shsh # SHSH blob の取得make restore # pymobiledevice3 restore バックエンドでファームウェアを焼き込み+# または: make restore_offline # オフライン復元(AEA イメージをその場で復号し、キャッシュ済み .shsh blob を使用)+ # 初回は AEA 復号のためインターネット接続が必要です```## カスタムファームウェアのインストール@@ -296,6 +298,15 @@ make fw_patch私たちのパッチは静的なオフセットではなくバイナリ解析によって適用されるため、新しいバージョンでも動作するはずです。何か壊れた場合は AI に聞いてください。+**Q: `restore_offline` を使ったらセットアップ画面で進めなくなりました**++セットアップ中に Apple への接続が必要ですが、`restore_offline` を使った場合はインターネットに接続されていない可能性があります。+デバイスを監視対象(supervised)にすることで、セットアップ画面の多くを回避できます:++```bash+python3 -m pymobiledevice3 profile supervise vphone+```+## 謝辞- [wh1te4ever/super-tart-vphone-writeup](https://github.com/wh1te4ever/super-tart-vphone-writeup)diff --git a/docs/README_ko.md b/docs/README_ko.mdindex 4a78d87d..d3e0fdc2 100644--- a/docs/README_ko.md+++ b/docs/README_ko.md@@ -146,6 +146,8 @@ make boot_dfu # VM을 DFU 모드로 부팅 (계속 실행 유지# 터미널 2make restore_get_shsh # SHSH blob 가져오기make restore # pymobiledevice3 restore 백엔드로 펌웨어 플래싱+# 또는: make restore_offline # 오프라인 복원 (AEA 이미지를 제자리에서 복호화하고 캐시된 .shsh blob 사용)+ # 최초 1회는 AEA 복호화를 위해 인터넷 연결이 필요합니다```## 커스텀 펌웨어 설치@@ -296,6 +298,15 @@ make fw_patch저희의 패치는 정적 오프셋이 아닌 바이너리 분석을 통해 적용되므로, 최신 버전에서도 작동할 것입니다. 만약 문제가 발생하면 AI에게 도움을 요청하세요.+**Q: `restore_offline`를 사용했더니 설정 화면에서 진행이 멈췄습니다**++설정 과정에서 Apple 서버에 연결을 시도하는데, `restore_offline`를 사용한 경우 인터넷에 연결되어 있지 않을 가능성이 큽니다.+기기를 supervised 상태로 만들면 설정 화면의 대부분을 우회할 수 있습니다:++```bash+python3 -m pymobiledevice3 profile supervise vphone+```+## 감사 인사- [wh1te4ever/super-tart-vphone-writeup](https://github.com/wh1te4ever/super-tart-vphone-writeup)diff --git a/docs/README_zh.md b/docs/README_zh.mdindex a95345f3..a3b45060 100644--- a/docs/README_zh.md+++ b/docs/README_zh.md@@ -146,6 +146,8 @@ make boot_dfu # 以 DFU 模式启动 VM(保持运行)# 终端 2make restore_get_shsh # 获取 SHSH blobmake restore # 通过 pymobiledevice3 restore 后端刷写固件+# 或:make restore_offline # 离线恢复(就地解密 AEA 镜像,并使用缓存的 .shsh blob)+ # 首次运行需要联网以完成 AEA 解密```## 安装自定义固件@@ -296,6 +298,15 @@ make fw_patch我们的补丁是通过二进制分析(binary analysis)而非静态偏移(static offsets)应用的,因此更新的版本应该也能正常工作。如果出现问题,可以寻求 AI 的帮助。+**问:使用 `restore_offline` 后卡在设置界面。**++设备在设置过程中会尝试连接 Apple,如果你使用了 `restore_offline`,很可能当前没有联网。+你可以将设备设为 supervised,以绕过大部分设置界面:++```bash+python3 -m pymobiledevice3 profile supervise vphone+```+## 致谢- [wh1te4ever/super-tart-vphone-writeup](https://github.com/wh1te4ever/super-tart-vphone-writeup)