Repository navigation
vphone 2.9.5
Core Bundle
- Apple TV guests. The Apple TV HD (AppleTV5,3) runs tvOS 26.6 (23L773), or 26.4 beta 1 from a manually chosen IPSW, paired with cloudOS 26.4, and reaches TVSetup, Settings and the home screen at 1080p. New
tvospreset: standard without the iOS payloads tvOS has no port of.vm creategives TV guests that preset and refuses templates and slimming. vphoned runs on tvOS asvphoned-tvoswith icli 0.8.6. Escape is Back/Menu; holding the titlebar Home button, fn-← or Device ▸ Control Center (⌘⇧T) sends the TV button. Details, the exact pairings and known limits are inResearch/Firmware/tvos_support.md. (#669, #670) - Apple TV 4K (AppleTV14,1), prototype, behind the
tvos-4kpreset. It has no IPSW:fw prepare --device AppleTV14,1stages its OTA, andcfw installlays the OTA's arm64e userland over the HD 26.6 image with the paravirtual GPU driver. It boots at 2160p on tvOS 26.6 and 27.0 (24J361). The screen can stop updating after a while; see the open issue in the guide. (#670, #673) - Unity games no longer draw scrambled meshes on the cloudOS 26.4 GPU driver. The new guest patch
system-paravirt_gpu-cfw-heap_index_offset, on instandard, makes the driver send every indexed draw with 64-bit offsets; an index buffer 64 KiB or more into a heap used to be read from the wrong address. (#668) cfw installon an external volume that reports 0 bytes available through the resource keys falls back tostatfs, instead of failing with "Less than 50 GiB". (#672)- A template's setup boot whose first-boot app expansion stalls for 180 s is rebooted once in the settle step, after logging installd's and DataMigrator's state and a spindump excerpt. It used to wait out the full 600 s and fail the creation. (#674)
fw catalog --jsongives an OTA pairing'sbuildand the cachefilesit needs. (#673)
Launchpad 2.9.5
- The New Machine sheet offers Apple TV guests with the tvOS preset, without template or slimming. Machines on tvOS show it, and the IPSW cache lists Apple TV IPSWs under their own family. (#670)
- An Apple TV 4K OTA pairing shows its build and is marked downloaded once the OTA and its base IPSW are both in the cache. (#673)
The vphone-launchpad-2.9.5.zip built by CI is unsigned.
Upgrading
Launchpad 2.9.x works with any VPhone.bundle 2.9.x and installs this one from Core Bundle. To move a machine, stop it and choose Change Core Bundle… with 2.9.5 and Update guest environment turned on. The GPU index-offset patch reaches the guest that way. No restore is needed. An Apple TV guest is a new machine, created from Launchpad 2.9.5's New Machine sheet or vphone-cli vm create.