TouchHLE

Emulator 0.3.0

TouchHLE emulates iPhone and iPod touch devices up to iPhone OS 3.0, primarily for gaming, and works on Apple Silicon Macs via Rosetta.

TouchHLE is a HLE (High-Level Emulation) emulator designed to run applications and games developed for the iPhone and iPod touch under iPhone OS 3.0. It focuses on mobile title compatibility, with a strong emphasis on games, while accurately reproducing the original environment through an optimized software approach.

On macOS, it runs on Apple Silicon processors via Rosetta, providing an accessible solution for users with recent hardware. Initially developed by hikari-no-yume and maintained by a community, it remains a practical tool, unaffiliated with Apple. Compatibility and performance vary depending on the applications, as detailed in its dedicated database.

Crash Bandicoot Nitro dans touchHLE
Doom II RPG dans touchHLE
Doom dans touchHLE

Last updated:

Platforms

Architecture

Mac OS X - macOS Mac OS X - macOS Intel x86 Intel x86 64-bit 64-bit

Download and links

Version history

0.3.0
  • Nouveauté majeure : support officiel pour les applications iOS (et non plus seulement iPhone OS), incluant le mode iPad (768×1024 pixels) et les apps universelles.
  • Améliorations API : correction des problèmes d’orientation et de mise à l’échelle pour les apps dépendantes de UIKit, et ajout des bibliothèques dynamiques SQLite3 et libxml2 compilées depuis la toolchain open-source.
  • Compatibilité étendue : prise en charge des apps iOS 4.0.x et iPhone OS 3.2.x, avec mises à jour des bibliothèques libgcc et libstdc++ vers leurs versions iOS 4.0.1.
  • Correction majeure : résolution des deadlocks et amélioration des performances via l’utilisation de coroutines pour la gestion des threads.
  • Nouveautés fonctionnelles : ajout de 20 applications compatibles (ex. Devil May Cry 4 Refrain, Angry Birds, Ultimate Mortal Kombat 3).

Hi everyone. Please enjoy this new release! It's the conclusion of a dreadfully long saga with threading problems. But it's also a big step forward for touchHLE in other ways, as it is finally an “iOS” emulator rather than just an “iPhone OS” one. ;)

~ hikari_no_yume, on behalf of the touchHLE development team


Compatibility:

  • New working apps:
  • API support improvements:
    • Various small contributions. (@hikari-no-yume, @ciciplusplus, @zazatree, @abnormalmaps, @alborrajo, @acieslewicz, @JCR64, @mcd-3, @apexad)
    • Fixed several issues related to apps that rely on UIKit to rotate their UI. Previously these apps would appear cropped or stretched, and in the wrong orientation. (@hikari-no-yume)
    • SQLite3 and libxml2 dynamic libraries are now available, compiled from source using our clean open-source toolchain. (@acieslewicz, @ciciplusplus)
  • There is now support for running apps in iPad mode (768×1024 pixels). Previously, only iPhone mode (320×480 pixels) was supported, so apps designed exclusively for the iPad would not work. Universal apps (which can run on both) are also supported. Device family (iPhone or iPad) is deduced from the app bundle, but the user can also override it with --device-family= option. (@ciciplusplus)
  • There is now support for iOS 4.0.x and iPhone OS 3.2.x apps:
    • The bundled dynamic libraries, libgcc and libstdc++, have been updated to their iOS 4.0.1 versions. (@ciciplusplus)
    • Support for NIBArchive NIB file format decoding. (@ciciplusplus)
    • touchHLE will no longer output a warning when trying to run an app with iOS 4.0.x as its minimum OS version. The warning now only appears for apps requiring iOS 4.1 and later. (@ciciplusplus)
  • touchHLE now uses coroutines to implement threads. This fixes the deadlocks that plagued the old system and created compatibilty issues, and improves performance in some games. (@abnormalmaps)
0.2.3
  • Compatibilité étendue : Prise en charge de plus de 300 applications avec une note de 3 étoiles ou plus, incluant Dungeon Hunter, Resident Evil 4: Mobile Edition, Assassin’s Creed, et Battlefield: Bad Company 2.
  • Améliorations API : Support du texte réel dans UITextField (clavier physique sur macOS/Windows, clavier système sur Android) et transformations affines pour Core Animation et UIKit.
  • Nouveautés macOS : Distribution sous forme de bundle .app avec données utilisateur dans Application Support et fichiers embarqués, remplaçant le format Unix exécutable.
  • Corrections critiques : Accélération corrigée sur certains téléphones Android et multi-touch amélioré dans plusieurs jeux.
  • Options utilisateur : Ajout d’un mode "Quick options" dans le sélecteur d’applications et simulation de l’accéléromètre via la souris (bouton droit maintenu).
  • Support audio : Intégration de ALAC et Microsoft IMA ADPCM dans Audio Toolbox, avec les mêmes restrictions que les autres codecs compressés.

Hello everyone!

The touchHLE team is proud to announce the new release!

Compatibility has grown from dozens of games to over 300 apps with 3+ stars support :tada:

Many thanks to all of the contributors who made this release possible :pray:

~ ciciplusplus and hikari_no_yume


Compatibility:

Usability:

  • Default options for various games have been added or improved. (@celerizer, @nighto)
  • The app picker now has a “Quick options” feature. This provides a quicker and easier way to set some common options. (@hikari-no-yume)
  • App icons in the app picker are now sorted by the display name of the app, case-insensitively. (@hikari-no-yume)
  • The accelerometer (tilt controls) can now be simulated using a mouse, instead of a game controller or real accelerometer. Simply hold down the right mouse button and move the mouse cursor. (@alborrajo)
  • The new --disable-analog-stick-tilt-controls option can be used to disable the use of the game controller's analog sticks for accelerometer simulation. This is useful on devices with both an integrated game controller and an integrated accelerometer, as touchHLE by default will only use the real accelerometer if no game controller is detected. (@hikari-no-yume)
  • Android builds and releases of touchHLE now have an icon and meaningful version metadata. They also now use a different package name for preview builds versus releases, which means you can install them side-by-side. (@hikari-no-yume)
  • macOS builds and releases of touchHLE now come as an application bundle (.app directory) rather than as a bare “Unix executable” file. This should fix problems some users encountered with running touchHLE outside of a terminal, and allows putting touchHLE in the Applications folder like a normal graphical app. To support this, user data (apps, options, etc) is now stored in “Application Support” rather than the current directory, and the bundled files (fonts, dylibs, etc) are now part of the app bundle. If you prefer the old layout, you can still get it if you move all the files out of the bundle. (@hikari-no-yume)
  • The “File manager” button on Android now works more reliably, especially the first time it is tapped. (@hikari-no-yume)
  • The new --force-composition= option has been added, which is a workaround that may solve rendering issues in some games, at the cost of performance. For some games it is applied by the default options. (@ciciplusplus)
  • Most errors causing touchHLE to crash now produce a graphical message box, rather than the error message only being found in the log. (@abnormalmaps)
  • touchHLE now writes log messages to a file on all platforms, not just on Android. The file has been renamed from log.txt to touchHLE_log.txt. (@hikari-no-yume)
  • Two new options for input handling of analog stick (--stick-to-touch=) and 8-directional DPad (--dpad-to-touch=) via a game controller. (@celerizer)

Quality:

  • Fixed an issue on some Android phones where the accelerometer was not usable. (@Oscar1640)
  • Fixed multi-touch in some games. (@ciciplusplus)
  • App icons are now displayed with a glossy sheen where required. (@hikari-no-yume)
  • The app icons and labels in the app picker are now displayed at integer pixel offsets, making them sharper and more symmetrical. (@hikari-no-yume)

Other:

  • MP3 decoding now uses Symphonia rather than dr_mp3. We do not expect this to affect compatibility. (@abnormalmaps)
0.2.2
  • Ajout du support officiel pour quatre applications : Rayman 2, Tony Hawk’s Pro Skater 2, Earthworm Jim et Castle of Magic.
  • Prise en charge des fichiers audio AAC (AAC-LC dans des conteneurs MPEG-4 typiques) via Audio Toolbox, avec des limitations potentielles.
  • Support étendu aux applications iPhone OS 3.0 (en plus des 2.x), avec gestion des binaries fat (ARMv6/ARMv7) et suppression des avertissements pour les versions minimales 3.0.
  • Mise à jour des bibliothèques dynamiques ARMv6 (libgcc et libstdc++) vers leurs versions iPhone OS 3.0.1.
  • Ajout du paramètre --button-to-touch= pour mapper les boutons Start et LeftShoulder aux touches tactiles, avec ajustements par défaut pour certains jeux.

Hi everyone! I'm sorry this release took a while, but it's here. This release (including the date) was @ciciplusplus's idea, and they now have more power in the project than before. We hope you enjoy! ~ hikari_no_yume


Compatibility:

  • New working apps:
  • API support improvements:
    • Various small contributions. (@alborrajo, @WhatAmISupposedToPutHere, @ciciplusplus, @hikari-no-yume, @LennyKappa, @Skryptonyte, @teromene)
    • AAC audio files (AAC-LC in a typical MPEG-4 container) are now supported in Audio Toolbox. This is done in a fairly hacky way so it might not work for some apps. (@hikari-no-yume)
  • There is now support for iPhone OS 3.0 apps, in addition to the existing support for iPhone OS 2.x apps:
    • Support for fat binaries has been added. touchHLE will no longer crash when trying to run an app with both ARMv6 and ARMv7 versions, and instead will try to pick the best available option (ARMv7, or failing this, ARMv6). This improves compatibility with iPhone OS 3.0 apps, many of which use fat binaries in order to improve performance on the iPhone 3GS and iPod touch (3rd generation). (@WhatAmISupposedToPutHere)
    • The bundled ARMv6 dynamic libraries, libgcc and libstdc++, have been updated to their iPhone OS 3.0.1 versions. Previously the iPhone OS 2.2.1 versions were used. (@hikari-no-yume)
    • touchHLE will no longer output a warning when trying to run an app with iPhone OS 3.0 as its minimum OS version. The warning now only appears for apps requiring iPhone OS 3.1 and later. (@hikari-no-yume)

Usability:

  • The --button-to-touch= option now supports the Start and the LeftShoulder buttons in addition to the A/B/X/Y buttons and D-pad. Certain games' default options have been adjusted to use them. (@nighto)
  • Default options for various games (@nighto)

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum