Boot a virtual iPhone via Apple's Virtualization.framework using PCC research VM infrastructure.

Prerequisites

Host:

Apple Silicon

macOS 15+ (Sequoia)

Xcode + iOS SDK (cross-compiles the guest daemon)

SIP/AMFI relaxation to allow private PV=3 entitlements with unsigned-binary

Dependencies:

brew install [email protected] aria2 wget gnu-tar openssl@3 ldid-procursus sshpass keystone cmake libusb ipsw zstd

Install

brew install zqxwce/tap/vphone-cli

Build

<div dir="auto" data-snippet-clipboard-copy-content="git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git

./scripts/setup_tools.sh # install deps, build toolchain submodules, create the Python venv ./scripts/build.sh # build + sign vphone-cli, bundle the .app, cross-compile vphoned

cd .build/vphone-cli.app/Contents/MacOS/ vphone-cli --help"> git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git

./scripts/setup_tools.sh # install deps, build toolchain submodules, create the Python venv ./scripts/build.sh # build +…