GitHub Store
Lakr233

vphone-cli

Lakr233

A command-line tool that boots a virtual iPhone on Apple Silicon Macs using Apple's Virtualization.framework, with support for iOS versions and firmware variants.

2.17.1
Published at
9h ago
16,654
Stars
6,859
Download
Synced at
9m ago

Latest release

2.17.1Nov 13, 2026, 09:01 AM
Downloads slow? Switch the source anytime above

README

Project Overview

vphone-cli is a command-line tool that boots a virtual iPhone via Apple's Virtualization.framework using PCC research VM infrastructure on Apple Silicon Macs.

Key Features

  • One-command VM creation: vphone-cli vm create myphone -V jb
  • Launch VM: vphone-cli vm launch myphone
  • Five firmware variants (less, jb, etc.)
  • VM management: list, info, new, clone, export, import, rename, delete
  • Manual build pipeline: new → prepare → patch → DFU boot → restore → CFW install → first boot

Target Audience

  • iOS security researchers and developers
  • Users who need to test iOS apps in a virtual environment
  • Apple Silicon Mac users

Quick Start

  1. Install: brew install zqxwce/tap/vphone-cli
  2. One-command create and launch: vphone-cli vm create myphone -V jb
  3. Launch VM: vphone-cli vm launch myphone

Core Advantages

  • Uses Apple's official virtualization framework
  • Command-line driven for automation
  • Multiple firmware variants

System Requirements

  • Hardware: Apple Silicon Mac
  • OS: macOS 15+ (Sequoia)
  • Additional Dependencies: Xcode + iOS SDK

Notes

  • Requires SIP/AMFI relaxation for private PV=3 entitlements
  • Requires Python, aria2, wget, and other dependencies

Release history

Sort