Android app launcher for iOS.

Drop in an APK, tap it, and the Android app opens full-screen.

JIT

Husk needs JIT, which on iOS takes an attached debugger. Use StikDebug, or Husk's built-in StikJIT helper (iOS 26+), which on iOS 27 can pair with your iPhone from Settings with no computer. The app walks you through it; see docs/06-built-in-jit.md.

Builds

Every push builds an unsigned Husk.ipa in GitHub Actions (build-ipa.yml). It is attached to the run as an artifact, ready for AltStore, SideStore or TrollStore to sign and install. The first run builds QEMU and its dependencies from scratch, which takes a couple of hours; after that they are cached.

Licence

GPL-2.0-or-later. Husk links QEMU, which is GPLv2, so the shipped binary is a combined GPLv2 work and the full source is public. It cannot go on the App Store — both because of that and because it needs get-task-allow plus a debugger attaching at runtime. See docs/01-licensing.md.