Run a virtual iPhone on an Apple Silicon Mac.
Swift
Merge pull request #111 from zqxwce/feature/amfidont_readme
zqxwce8e9aba12245b
diff --git a/README.md b/README.mdindex c4811a23..350f7581 100644--- a/README.md+++ b/README.md@@ -30,22 +30,42 @@ See [research/patch_comparison_all_variants.md](./research/patch_comparison_all_**Host OS:** macOS 15+ (Sequoia) is required for PV=3 virtualization.-**Disable SIP and AMFI** — required for private Virtualization.framework entitlements.+**Configure SIP/AMFI** — required for private Virtualization.framework entitlements and unsigned binary workflows.-Boot into Recovery (long press power button), open Terminal:+Boot into Recovery (long press power button), open Terminal, then choose one setup path:-```bash-csrutil disable-csrutil allow-research-guests enable-```+- **Option 1: Fully disable SIP + AMFI boot-arg (most permissive)**++ In Recovery:-After restarting into macOS:+ ```bash+ csrutil disable+ csrutil allow-research-guests enable+ ```-```bash-sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"-```+ After restarting into macOS:++ ```bash+ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"+ ```++ Restart once more.++- **Option 2: Keep SIP mostly enabled, disable only debug restrictions, use [`amfidont`](https://github.com/zqxwce/amfidont)**++ In Recovery:-Restart once more.+ ```bash+ csrutil enable --without debug+ csrutil allow-research-guests enable+ ```++ After restarting into macOS:++ ```bash+ xcrun python3 -m pip install amfidont+ sudo amfidont --path [PATH_TO_VPHONE_DIR]+ ```**Install dependencies:**@@ -171,11 +191,16 @@ Connect via:**Q: I get `zsh: killed ./vphone-cli` when trying to run it.**-AMFI is not disabled. Set the boot-arg and restart:+AMFI/debug restrictions are not bypassed correctly. Choose one setup path:-```bash-sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"-```+- **Option 1 (full AMFI disable):**++ ```bash+ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"+ ```++- **Option 2 (debug restrictions only):**+ use Recovery mode `csrutil enable --without debug` (no full SIP disable), then install/load [`amfidont`](https://github.com/zqxwce/amfidont) while keeping AMFI otherwise enabled.**Q: System apps (App Store, Messages, etc.) won't download or install.**