Summary

vphone-cli enables booting virtual iPhone environments on macOS via Apple's Virtualization.framework. It targets developers, researchers, and power users needing flexible iOS testing platforms, offering distinct firmware variants, including a jailbroken version, for deep system analysis and application development.

How It Works

The project leverages Apple's Virtualization.framework on macOS 15+ to instantiate virtual iPhones. It supports three firmware patch variants: 'Regular' for standard operation, 'Development' with enhanced debug capabilities and security bypasses, and 'Jailbreak' offering full security bypasses for tools like Sileo, apt, and TrollStore. Patching is performed via binary analysis, aiming for resilience against iOS updates.

Quick Start & Requirements

• Host OS: macOS 15+ (Sequoia) is mandatory.
• Prerequisites: Requires specific SIP/AMFI configurations (fully disable or selective bypass with amfidont/amfree). Dependencies include brew install aria2 wget gnu-tar openssl@3 ldid-procursus sshpass keystone libusb.
• Installation: Full automation via make setup_machine. Manual setup involves make setup_tools, make build, make vm_new, make fw_prepare, and make fw_patch (or _dev/_jb).
• Cloning: Use git clone --recurse-submodules.

Highlighted Details

• Firmware Variants: Offers distinct operational modes: Regular, Development (debug bypasses), and Jailbreak (full bypass).
• AI-Driven Testing: Exposes a host control socket (vm/vphone.sock) for programmatic VM interaction, enabling AI-driven end-to-end testing.
• VM Management: Supports saving, listing, and switching between multiple VM environments using vm_backup, vm_list, and vm_switch.
• Patching Methodology: Employs binary analysis for patching, designed to adapt to newer iOS versions.

Maintenance & Community

No specific details regarding maintainers, community channels, or project roadmaps were found in the provided README.

Licensing & Compatibility

The license type and any associated compatibility notes for commercial use or closed-source linking are not explicitly stated in the provided README.

Limitations & Caveats

The project cannot run on nested macOS virtual machines. Certain iOS regions (Japan, EU) may cause system app installation failures; alternative regions like the United States are recommended. Configuration of macOS security features (SIP/AMFI) is a critical prerequisite.