Henge README

README проекта с github.com/Leviidev/Henge. Одним файлом markdown: README.md.

Henge

Henge

macOS on your iPhone and iPad.

Install · How it works · Website · Releases

Downloads GPL-2.0-or-later

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.

Install

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.

Sharing with the Mac

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.

Known limits

Screenshots

Discord on an iPad
iPad
Macs
Macs
Trackpad
Trackpad
Install macOS
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.

Building

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.

Licence

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.

Henge (Leviidev/Henge)

Ищем в базе…

2.4K ·GitHub
Что это такое?Henge запускает macOS на iPhone или iPad. Это собственный эмулятор со своими JIT, MMU и устройствами, и он устанавливает macOS из образа восстановления Apple прямо на устройстве.
Это приложение для Mac или для телефона?Это приложение для iOS и iPadOS, которое вы устанавливаете на устройство. Сама macOS — программное обеспечение Apple, которое Henge скачивает во время установки.
Как его запустить?Установите Henge.ipa из Releases через SideStore или AltStore либо установите Henge.tipa через TrollStore или TrollStore Lite. Затем откройте вкладку Install, выберите macOS Sequoia 15.6.1 и держите Henge открытым, пока устройство подключено.
Что нужно перед установкой?Нужны iOS или iPadOS 17 или новее на чипе A14, M1 или новее, вариант JIT, например StikDebug или помощник StikJIT, встроенный в Henge (iOS 26 или новее), и около 43 ГБ свободного места. Для установки Mac не нужен.
Каковы главные ограничения?Работает медленнее настоящего Mac, так как это эмуляция. Вход в Apple Account внутри macOS завершается ошибкой проверки, а за один запуск приложения можно запустить только один Mac.
На каких устройствах его проверяли?Пока его проверяли только на iPhone 17 Pro. Поддержка iPad новая и ещё не запускалась на настоящем iPad.
Оно бесплатное и можно ли выложить его в App Store?Оно бесплатное и распространяется по лицензии GPL-2.0-or-later. В App Store его выложить нельзя, потому что готовая сборка объединяет код usbmuxd и Husk в одну работу под GPL.
Работает ли с внешним дисплеем?Да. Во время сеанса Mac дисплей, подключённый кабелем USB-C с поддержкой видео или через док-станцию USB-C/HDMI, включается автоматически, а устройство сохраняет управление трекпадом и клавиатурой. Вывод видео по USB-C подтверждён пользователями только на iPhone 17 Pro с iOS 27.
Зачем писать собственный эмулятор, а не использовать QEMU?iOS не даёт приложениям гипервизора, поэтому Henge запускает arm64-код Mac через собственный JIT, со своими MMU и устройствами. Он не использует QEMU или Virtualization.framework.
Как быстро macOS запускается на телефоне?На iPhone 17 Pro macOS доходит до экрана блокировки примерно за 15 секунд. Discord устанавливается, открывается примерно за 15 секунд, входит в аккаунт и отправляет сообщения.
Какие есть похожие проекты?Madeira, Husk, totk-mobile, nxnative, Wind-Waker-Recomp, S2Arm, UTM, Stela
Автор
Leviidev
Размер
8 MB
Звёзды
2.4K
Возраст
16 д
Коммиты · 90 дней