yiem/vphone-cli
1
0
Fork 0
mirror of https://github.com/Lakr233/vphone-cli.git synced 2026-09-05 17:14:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #111 from zqxwce/feature/amfidont_readme

Browse Source 
readme: Add `amfidont` as an option
This commit is contained in:
zqxwce
2026-03-06 00:01:32 +08:00
committed by GitHub
parent 018b54fb94
commit 8e9aba1224
1 changed files with 40 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+28 -3
View File
@@ -30,9 +30,13 @@ See [research/patch_comparison_all_variants.md](./research/patch_comparison_all_
**Host OS:** macOS 15+ (Sequoia) is required for PV=3 virtualization. **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:
- **Option 1: Fully disable SIP + AMFI boot-arg (most permissive)**
In Recovery:
```bash ```bash
csrutil disable csrutil disable
@@ -47,6 +51,22 @@ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"
Restart once more. Restart once more.
- **Option 2: Keep SIP mostly enabled, disable only debug restrictions, use [`amfidont`](https://github.com/zqxwce/amfidont)**
In Recovery:
```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:** **Install dependencies:**
```bash ```bash
@@ -171,12 +191,17 @@ Connect via:
**Q: I get `zsh: killed ./vphone-cli` when trying to run it.** **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:
- **Option 1 (full AMFI disable):**
```bash ```bash
sudo nvram boot-args="amfi_get_out_of_my_way=1 -v" 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.** **Q: System apps (App Store, Messages, etc.) won't download or install.**
During iOS setup, do **not** select **Japan** or **European Union** as your region. These regions enforce additional regulatory checks (e.g., sideloading disclosures, camera shutter requirements) that the virtual machine cannot satisfy, which prevents system apps from being downloaded and installed. Choose any other region (e.g., United States) to avoid this issue. During iOS setup, do **not** select **Japan** or **European Union** as your region. These regions enforce additional regulatory checks (e.g., sideloading disclosures, camera shutter requirements) that the virtual machine cannot satisfy, which prevents system apps from being downloaded and installed. Choose any other region (e.g., United States) to avoid this issue.