Home

HyperHLE Wiki

HyperHLE is an independent, AI-assisted fork of touchHLE — a high-level emulator (HLE) for early iPhone OS apps. It runs the original ARM binaries and re-implements iPhone OS frameworks in Rust, so no iOS system files or firmware are needed.

This fork focuses on faster iteration, better mobile support (always-installable signed Android builds) and broader app compatibility, while keeping a clean-room relationship to upstream (MPL 2.0, no copied code). See the repository README for the full fork statement.

Pages

• Getting Started — install & run your first app
• Build and CI — compiling from source, Android builds, workflow overview
• Architecture — how the emulator works, codebase map
• Debugging — logging, crash traces, --dump, unimplemented-API reports
• Compatibility — what runs, and how to report results
• AppDB — the compatibility-report web app bundled in this repo
• Roadmap — current focus and ideas

Quick links

• Repository: https://github.com/KlugKlugTG/HyperHLE-Fork
• CI builds: Actions (every push to trunk produces artifacts for Windows/macOS/Linux/Android)
• Community Discord: https://discord.gg/taNP4aTvd
• AppDB (compatibility reports): https://appdb.touchhle.org

Community note: the official touchHLE Discord bans all fork discussion. Keep fork talk here or in the HyperHLE Discord.