项目的 README,来自 github.com/Leviidev/Henge。合并为一个 markdown 文件:README.md。
macOS on your iPhone and iPad.
Install · How it works · Website · Releases
Download macOS, install it on the device, and use it.
On an iPhone 17 Pro, macOS reaches the lock screen in about 15 seconds. Discord installs, opens in about 15 seconds, logs in and sends messages.
Sideload Henge.ipa from Releases with SideStore or AltStore, or install Henge.tipa with TrollStore or TrollStore Lite. To get updates in SideStore or AltStore, add Henge's source, https://raw.githubusercontent.com/Leviidev/Henge/main/repo.json, or https://itslevii.dev/repo.json for all of Leviidev's apps. iOS or iPadOS 17 or later, on an A14 or M1 chip or newer. So far it's tested only on an iPhone 17 Pro: iPad support is new and hasn't run on a real iPad yet.
Then open the Install tab, pick macOS Sequoia 15.6.1, and keep Henge open with the device plugged in. Tahoe 26.6.2 and macOS 27.2 are offered too: both install and run on an iPhone 17 Pro, though Tahoe's first setup is slow and macOS 27 is the slowest (Safari's pages may stay blank on it). Sonoma 14.6.1 and Ventura 13.6 are smaller downloads (14.1 and 12.3 GB) for devices short on storage: they install, set up, and run Safari (both tested on an iPhone 17 Pro). Monterey isn't offered yet: it installs, but its desktop never appears.
Do this once for each Mac: open Terminal on the Mac, then in Henge open Details and tap Type the Set Up Command. Press Return on the Mac, and choose Allow when macOS asks about henge-agent and local networks. It needs the Mac's keyboard layout to be U.S.
Then a Henge folder in the Mac's home folder is the same folder as Files › Henge › Shared. What you copy on the Mac is copied on the device too, and the paste button pastes from the device into the Mac.
![]() iPad |
||
![]() Macs |
![]() Trackpad |
![]() Install macOS |
Captured on a Mac: the app's own screens with sample data, at iPad and iPhone sizes, showing a frame from Henge's renderer.
To use Henge, install the latest release. Every change lands on main as it's made, so main can be unfinished between releases.
On a Mac with Xcode 27 or later and xcodegen. Henge takes StikJIT, on-device pairing, libslirp and glib from a built Husk checkout at ~/Documents/Coding/Husk (set HUSK to use another path):
ios/scripts/fetch_deps.sh
tools/build_ios_restore.sh
make ios-lib
ios/scripts/package_ipa.sh
That produces ~/Desktop/Henge.ipa, and package_ipa.sh --trollstore writes Henge.tipa.
make builds the engine for the Mac, build/hengevm, and make test runs its tests.
GPL-2.0-or-later. Henge compiles in usbmuxd (GPLv2 or GPLv3) and code from Husk (GPL-2.0-or-later), so the shipped binary is a combined GPL work. It cannot go on the App Store. See docs/licensing.md.
macOS and the Mac's boot ROM are Apple's and aren't part of Henge. Henge downloads both from Apple when you install.