Overview
vphone-cli leverages Apple's Virtualization.framework and advanced research VM infrastructure to boot a fully functional virtual iPhone on your Apple Silicon Mac. This powerful tool allows for deep system interaction, experimentation, and development within a sandboxed iOS environment.
Key Features
- Seamless VM Creation: Automate the entire pipeline from IPWS download and patching to DFU restore and custom firmware (CFW) installation with a single command.
- Flexible Firmware Variants: Choose from five distinct firmware variants, each offering increasing levels of security bypass and customizability, ranging from minimal patches to full jailbreak and anti-VM detection research capabilities.
- Comprehensive VM Management: Easily list, inspect, create, configure, clone, export, import, rename, and delete your virtual iPhones.
- Manual Pipeline Control: Drive the VM creation process step-by-step for granular control over firmware preparation, patching, DFU restore, and CFW installation.
- SSH & VNC Access: Connect to your virtual iPhone via SSH (with different credentials for jailbroken and regular/dev variants) and control it remotely with VNC.
- Programmatic Automation: Utilize a host control socket for programmatic control of screenshots, touch input, hardware keys, and clipboard, enabling AI-driven E2E testing.
- Extensive Tested Environments: A detailed table of tested host macOS versions, iPhone firmware, and CloudOS versions ensures compatibility and guides your setup.
- In-depth Troubleshooting: The FAQ section provides solutions to common issues, including SIP/AMFI relaxation, VM nesting limitations, and app launch errors.
Typical Use Cases
- iOS Security Research: Explore and exploit iOS vulnerabilities with a controlled and reproducible virtual environment, especially with the
jbandexpvariants. - Jailbreak Development: Test and develop jailbreak tools, tweaks, and applications in a safe, sandboxed environment before deploying to physical devices.
- App Development & Testing: Debug and test iOS applications, especially those requiring specific firmware features or system-level access, without needing physical hardware for every iteration.
- Firmware Analysis: Dive deep into the intricacies of iOS firmware, patching boot chains, and understanding system behavior through custom modifications.
- Automated E2E Testing: Integrate vphone-cli with automation frameworks for robust, end-to-end testing of iOS applications and system functionalities.
