+15
Daily
+247
Weekly
+1,462
Monthly
16,684
stars
1,960
forks
77
watchers
575
prs
297
issues
84
releases
README
Docs · English · 中文 · 日本語 · 한국어 vphone-cli Run a virtual iPhone on an Apple Silicon Mac. [!WARNING] This project has never issued or authorized any cryptocurrency or token, and does not accept cryptocurrency payments or donations. Any cryptocurrency or token issued or promoted in this project's name, or claiming any affiliation with it, is a scam. !Virtual iPhone running on macOS vphone-cli runs iOS with Apple's Virtualization.framework and PCC research virtual machines, for security research, reverse engineering, and debugging. Documentation Everything else lives on the documentation site: - Quick Start: requirements, host settings, and your first VM with Launchpad. - Manual: machines, firmware, storage, networking, and troubleshooting, in English, 中文, 日本語 and 한국어. - Research Notes: patches, boot chain, restore, and the automation API reference. The sources of the site are in Documents/ and Research/. Let an Agent Install It If you use a coding agent (Claude Code, Codex, or similar) on this Mac, paste the prompt below instead of following the steps by hand. The agent reads the vphone skill, checks what is already set up, installs Launchpad and VPhone.bundle, and stops to ask when a step needs you, such as an administrator password or a change in macOS Recovery. text Set up vphone on this Mac. Read the skill at https://raw.githubusercontent.com/Lakr233/vphone-cli/main/Skills/vphone-guest-control/SKILL.md and the files it links under references/ (same folder), then follow them: install the newest notarized vphone-launchpad (not every release has a -notarized zip), put vphone-launchpad-cli on PATH, install the VPhone.bundle that matches Launchpad's series, and check vphone-launchpad-cli status. Do not change SIP, boot-args or any other host security setting, and do not create a machine until I confirm the firmware and the free disk space. When a step needs me, tell me exactly what to do and wait. Acknowledgements - wh1te4ever/super-tart-vphone-writeup - owngoal-dev/OpenAVB and owngoal-dev/OpenSEP, the boot ROMs new VMs start from License vphone-cli is released under the MIT License.
Top issues
#859CoreLocation offset problem2 comments · 2026-11-08#842Proposal: more than one virtual NIC per guest, for multipath and failover testing1 comments · 2026-11-05#696[Feature Request] Bluetooth1 comments · 2026-10-20#603Issues with .NET MAUI applications0 comments · 2026-10-06#439setting a passkey fails after jailbreak0 comments · 2026-08-23
Discussions
#769TrollStore Lite issue1 comments · 2026-10-28#733Support for biometrics0 comments · 2026-10-23#505You can try enabling it to support iOS, iPadOS, or Android.0 comments · 2026-09-26#494Tried on AWS ec2?1 comments · 2026-09-20#480how to sign in to iCloud0 comments · 2026-09-19#455Windows support or a Windows-compatible alternative?2 comments · 2026-09-07#449Apple intelligence supported?0 comments · 2026-08-29#444Mobile Application security testing0 comments · 2026-08-25
Latest release
vphone 2.17.1 2.17.1 2026-11-13vphone 2.17.1 A patch release of the changes merged since 2.17.0. Launchpad 2.17 and VPhone.bundle 2.17.x stay interchangeable; the minimum bundle is unchanged. Core Bundle - iPad: the framebuffer stays panel-native, so the pointer is drawn in landscape too (dyld-cfw-quartzcore_unrotated_framebuffer). (926) - ARM64E_X1: the 35 remaining standalone accessibility plug-ins, including UIKit and SwiftUI, are lowered like the debug libraries. This fixes apps faulting in +[AXUIKitPopGlue initialize] at startup on hosts without FEAT_PAuth_LR when accessibility is on. Each plug-in is its own patch,
相关报道 (8)
blog.csdn这 6 个刚崭露头角的开源 GitHub 项目,用 TaoToken 统一 Key 跑通 vphone-cli 与 iOS 虚拟化2026-10-19blog.csdn告别实体机依赖,用 vphone-cli 构建自动化测试农场2026-09-01腾讯网Mac端虚拟iPhone工具vphone-cli发布:支持多版本越狱与自动化测试2026-08-29CSDNvphone-cli:命令行管理虚拟手机实例的实用指南2026-11-07CSDNvphone-cli:基于Virtualization.framework的iOS真机虚拟化工具2026-11-05CSDNvphone-cli:轻量级虚拟手机命令行控制工具设计与实现2026-11-05CSDN轻量级前端框架设计:通透感UI与模块化架构实践2026-11-05蓝点网[开源] 真正的iOS虚拟机!自带越狱环境可用于测试/模拟/安全研究等等2026-05-24
News & coverage (9)
Hacker NewsBoot a Virtual iPhone via Apple's Virtualization.framework▲ 421 · 113 comments · 2026-08-28Hacker NewsVirtual iPhone (iOS26) on Apple Private Cloud Compute (PCC) research VM▲ 2 · 0 comments · 2026-03-16Hacker NewsVirtualizing an iPhone on Apple Silicon Macs Using Virtualization.framework▲ 1 · 0 comments · 2026-03-11shattered.iovphone-cli Boots Full iOS 27 VM, Gives Root SSH [2026]2026-10-19noteThe Era of Letting AI Agents Touch 'Real iOS'—Why vphone-cli Gathered 9,200 Stars and the Price of Disabling SIP2026-09-10noteHow 'vphone-cli' Works to Build Virtual iPhones Using macOS Sequoia's Virtualization.framework2026-09-06ad-hoc-newsvphone-cli: Open-Source-Tool bootet iOS 26 auf Apple Silicon2026-08-29shattered.iovphone-cli: Full iOS 27 Virtualization on Apple Silicon2026-09-14AdafruitBoot a virtual iPhone on a Mac2026-09-01