TouchHLE
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.
Last updated:
Platforms
Architecture
Mac OS X - macOS
64-bit
Download and links
- Download TouchHLE
- Official website
- Source code 4 085 GitHub stars
- License : MPL-2.0
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:
- Devil May Cry 4 Refrain (@hikari-no-yume)
- Amerzone Pt1 (@ciciplusplus)
- Eternal Legacy (@ciciplusplus)
- Dungeon Hunter 2 (@ciciplusplus)
- N.O.V.A. 2: The Hero Rises Again (@ciciplusplus)
- Star Battalion (@ciciplusplus)
- Ice Age: Dawn of the Dinosaurs (@ciciplusplus)
- Zombieville (@ciciplusplus)
- Doom Resurrection (@ciciplusplus)
- Ace Combat Xi (@alborrajo)
- Fruit Ninja (@acieslewicz, @ciciplusplus)
- Asphalt 6 (@ciciplusplus)
- World of Goo (@ciciplusplus)
- Angry Birds (@ciciplusplus)
- Ravensword: The Fallen King (@abnormalmaps, @ciciplusplus)
- NEX (@ciciplusplus)
- Mirror's Edge (@ciciplusplus)
- Palm Heroes (@ciciplusplus)
- Sonic at the Olympic Winter Games (@ciciplusplus)
- Ultimate Mortal Kombat 3 (@ciciplusplus)
- Dead Space (@ciciplusplus)
- Spy Mouse HD (@ciciplusplus)
- Call of Duty World at War Zombies (@abnormalmaps, @alborrajo)
- Resident Evil Degeneration (@abnormalmaps, @alborrajo)
- 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:
- New working apps:
- Dungeon Hunter (@ciciplusplus)
- Crystal Defenders: Vanguard Storm (@ciciplusplus)
- Zombie Infection (@ciciplusplus)
- Gangstar: West Coast Hustle (@ciciplusplus)
- Asphalt 4: Elite Racing (@ciciplusplus)
- Prince of Persia: Warrior Within (@ciciplusplus)
- Resident Evil 4: Mobile Edition (@alborrajo)
- Command & Conquer: Red Alert (@ciciplusplus)
- SimCity (@ciciplusplus)
- Asphalt 5 (@ciciplusplus, @hikari-no-yume)
- Cut the Rope (@ciciplusplus)
- Skater Nation (@ciciplusplus)
- Iron Man 2 (@ciciplusplus)
- Shrek Forever After (@ciciplusplus)
- Spore Origins (@ciciplusplus, @hikari-no-yume, @teromene)
- Defender Chronicles (@hujerhoe)
- Real Racing (@ciciplusplus)
- Tom Clancy's Splinter Cell: Conviction (@ciciplusplus)
- Assassin's Creed (@ciciplusplus)
- N.O.V.A. Near Orbit Vanguard Alliance (@ciciplusplus)
- Brothers in Arms 2: Global Front (@ciciplusplus)
- Ferrari GT: Evolution (@ciciplusplus)
- Castle Frenzy (@ciciplusplus)
- Hero of Sparta 2 (@ciciplusplus)
- Hero of Sparta (@ciciplusplus)
- Bridge Odyssey (@ciciplusplus)
- Terminator Salvation (@ciciplusplus)
- Brothers In Arms: Hour Of Heroes (@ciciplusplus)
- Crusade Of Destiny (@ciciplusplus)
- Arvale (@ciciplusplus)
- Battlefield: Bad Company 2 (@ciciplusplus)
- Ms. PAC-MAN (@acieslewicz)
- Dark Nebula (@ciciplusplus)
- FIFA 10 (@ciciplusplus)
- Crash Bandicoot Nitro Kart 2 (@ciciplusplus)
- Driver (@ciciplusplus)
- Sacred Odyssey: Rise of Ayden (@ciciplusplus)
- Nanosaur 2 (@ciciplusplus)
- Cro-Mag Rally (@ciciplusplus)
- Bugdom 2 (@ciciplusplus)
- API support improvements:
- Various small contributions. (@hikari-no-yume, @alborrajo, @ciciplusplus, @atasro2, @abnormalmaps, @hujerhoe, @acieslewicz, @WhatAmISupposedToPutHere, @JaGoTu, @apexad, @chyyran, @mistydemeo, @bognarit80, @RMZeroFour)
- UITextField now supports real text input with a keyboard. On Windows/macOS physical keyboard is used, on Android it's done via a system soft keyboard. (@ciciplusplus)
- UIScrollView and UITextView partial implementations. (@Skryptonyte, @ciciplusplus)
- Core Animation and UIKit now support affine transforms, allowing UI elements to be rotated, a feature needed by several games. Note however that auto-rotation is not yet supported. (@hikari-no-yume)
- Partial support for Core Animation explicit animations has been added. (@alborrajo)
- The libz dynamic library is now available, compiled from source using a clean open-source toolchain. (@acieslewicz)
- ALAC and Microsoft IMA ADPCM are now supported in Audio Toolbox, with the same caveats as other compressed codecs. (@abnormalmaps)
- Switched to ARMv7 rather than ARMv6 versions of libstdc++ and libgcc. (@acieslewicz)
- Added support for certain iPhone OS 3.1 binary format changes (iPhone OS 3.1 apps are still considered unsupported). (@bognarit80)
- Limited support for local multiplayer via Wi-Fi in some games. (@ciciplusplus)
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-controlsoption 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 (
.appdirectory) 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.txttotouchHLE_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:
- Rayman 2 (@ciciplusplus)
- Tony Hawk's Pro Skater 2 (@ciciplusplus)
- Earthworm Jim (@ciciplusplus)
- Castle of Magic (@ciciplusplus)
- 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)
0.2.1
- Ajout du support multi-touch et amélioration de l'API pour plusieurs applications, incluant Doom, Doom II RPG, I Love Katamari et Wolfenstein RPG.
- Limitation du framerate à 60 FPS par défaut pour correspondre à l'iPhone OS original, avec option --limit-fps= pour ajuster ou désactiver.
- Ajout d’un bouton « Open file manager » dans le sélecteur d’applications pour accéder facilement aux dossiers de stockage.
- Suppression du support de la variable LANG pour la détection automatique de langue, remplacée par --preferred-languages=.
- Pagination du sélecteur d’applications pour dépasser la limite initiale de 16 apps.
- Option --button-to-touch= étendue pour inclure les mappings du D-pad, avec des configurations par défaut pour Wolfenstein RPG et Doom II RPG.
Hi everyone! I'm happy to announce a new release, two months after the previous one.
Before I get to the changelog, some special notes:
- From this release onwards, the old list of supported apps is replaced by the new, crowdsourced touchHLE app compatibility database.
- In case you missed it, the touchHLE app archive was recently launched. It only has one app at the moment, but that's hopefully just the start. If you were an indie developer in the early iPhone days, please get in touch!
- If you want to get notified about future releases, you might want to join the Discord server. You can't post there, but you'll be @'d with updates. There's also a YouTube channel where I post short gameplay videos with new releases.
- If you want to help me keep working on this full time, please consider supporting me financially.
Finally, a big thanks to all the other contributors who made this release what it was! If it weren't for them, there might not have been any new game support in this release.
Happy Halloween! 🎃
~ hikari_no_yume
Compatibility:
- API support improvements:
- Various small contributions. (@hikari-no-yume, @ciciplusplus, @alborrajo)
- New working apps:
- Doom (@ciciplusplus)
- Doom II RPG (@alborrajo)
- I Love Katamari (@ciciplusplus)
- Wolfenstein RPG (@alborrajo)
Quality:
- Multi-touch is now supported. (@ciciplusplus)
Usability:
- The Android version of touchHLE now has a documents provider. Thanks to a mere three hundred lines of boilerplate code originally written for the emulator Skyline (RIP), it is now possible for you, as the owner of a device running a newer Android version, to move
filesdocuments in and out of touchHLE'sdirectorylocation on your device with relative ease. For example, it is now possible to download an.ipa fileapplication/octet-streamdocument to the Downloads folder of your device, then, using an appropriate app, move this document to the touchHLE location. Users of normal operating systems and older versions of Android continue to be able to access a superior version of the same functionality via a so-called “file manager”. (@hikari-no-yume) - There is now an “Open file manager” button in the app picker, to make it easier to find where touchHLE stores your apps and settings. On most operating systems this opens the relevant directory in a file manager, and on Android it opens some sort of app for managing documents in the touchHLE location. (@hikari-no-yume)
- The Android version of touchHLE now writes all log messages to a file called
log.txt, in addition to outputting them to logcat. (@hikari-no-yume) - The new
--stabilize-virtual-cursor=option makes the analog stick-controlled virtual cursor appear more stable to the emulated app, which is helpful in some games with overly sensitive menu scrolling. In some titles it is applied by default. (@hikari-no-yume; special thanks: @wareya) - Automatic language detection now works on all platforms, and supports a list of languages in order of preference, rather than just one. The
LANGenvironment variable is no longer supported, and instead the new--preferred-languages=option can be used. Note that it is the emulated app itself that decides what to do with this list, and whether particular languages are supported. (@hikari-no-yume) - The app picker now has multiple pages, so it is no longer limited to 16 apps. (@hikari-no-yume)
- The framerate is now limited to 60fps by default, which matches the original iPhone OS and fixes issues with some games where the game ran too fast or consumed excessive energy and CPU time. This limit can be adjusted or disabled with the new
--limit-fps=option. (@hikari-no-yume; special thanks: @wareya) - The
--button-to-touch=option now supports D-pad mappings in addition to the A/B/X/Y buttons. (@alborrajo) - Default game controller button mappings have been added for Wolfenstein RPG and Doom II RPG, including for the D-pad. (@alborrajo)
0.2.0
- Nouveauté majeure : première version fonctionnelle sur Android (seulement pour appareils AArch64), avec prise en charge de l’accéléromètre pour l’entrée tactile.
- UIKit et applications : support limité de UIKit (hiérarchie de couches, gestion des touches, UIImageView, UILabel, UIControl, UIButton), permettant d’émuler des apps non-graphiques.
- Applications ajoutées : Fastlane Street Racing, Mystery Mania, Wolfenstein 3D (v1.0), et plusieurs titres de Donut Games.
- Correction macOS : résolution d’une fuite mémoire macOS (jusqu’à 0.4 MB/s) via des modifications des pilotes graphiques.
- Interface utilisateur : ajout d’un sélecteur d’applications avec grille d’icônes, et options --fullscreen, --button-to-touch=, --print-fps, --headless.
- Débogage : implémentation basique du protocole GDB Remote Serial pour inspection mémoire et points d’arrêt.
At long last, it's here: the first release to work on Android, the first release with an app picker UI, the first release with (very limited) UIKit support, and much more!
This release required a lot of effort, and not just from me! I want to especially thank @ciciplusplus, who dared to try to port touchHLE to Android and somehow succeeded. I also want to thank @KiritoDv and @LennyKappa, who also made big contributions to this release.
Thank you all for your continued patience and support. I hope you enjoy!
~ hikari
[Update 2023-09-01: When the release was tagged and uploaded yesterday, two changelog entries were mistakenly in the v0.1.2 section rather than v0.2.0. The copies of the changelog below and in the release zip files have now been corrected. Additionally, the OPTIONS_HELP.txt file was mistakenly absent from the Android release zip file, but it has now been added.]
Compatibility:
-
API support improvements:
- Various small contributions. (@hikari-no-yume, @KiritoDv, @ciciplusplus, @TylerJaacks, @LennyKappa)
- PVRTC and paletted texture compression is now supported. (@hikari-no-yume)
- Some key pieces of UIKit and Core Animation are now implemented: layer and view hierarchy, layer and view drawing, layer compositing, touch input hit testing,
UIImageView,UILabel,UIControl, andUIButton. Previously, touchHLE could only support apps that draw everything with OpenGL ES, which is only common for games. This lays the groundwork for supporting games that rely on UIKit, and possibly some non-game apps. (@hikari-no-yume) - Threads can now sleep, join other threads, and block on mutexes. (@LennyKappa, @hikari-no-yume)
-
New supported apps:
- Fastlane Street Racing (@hikari-no-yume)
- Mystery Mania (@KiritoDv)
- Wolfenstein 3D (@ciciplusplus; version 1.0 only)
- Many old apps by Donut Games (@ciciplusplus)
Quality and performance:
- Overlapping characters in text now render correctly. (@Xertes0)
- touchHLE now avoids polling for events more often than 120Hz. Previously, it would sometimes poll many times more often than that, which could be very bad for performance. This change improves performance in basically all apps, though the effects on the supported apps from previous releases are fairly subtle. (@hikari-no-yume)
- The macOS-only memory leak of up to 0.4MB/s seems to have been fixed! (@hikari-no-yume)
- App icons are now displayed with rounded corners, even if the PNG file contains a square image. This is more accurate to what iPhone OS does. (@hikari-no-yume)
- The memory allocator is a lot faster now. (@hikari-no-yume)
New platform support:
- touchHLE is now available for Android. Only AArch64 devices are supported. (@ciciplusplus, @hikari-no-yume)
Usability:
- touchHLE now supports real accelerometer input on devices with a built-in accelerometer, such as phones and tablets. This is only used if no game controller is connected. (@hikari-no-yume)
- The options help text is now available as a file (
OPTIONS_HELP.txt), so you don't have to use the command line to get a list of options. (@hikari-no-yume) - The new
--fullscreenoption lets you display an app in fullscreen rather than in a window. This is independent of the internal resolution/scale hack and supports both upscaling and downscaling. (@hikari-no-yume) - touchHLE now has a built-in app picker with a pretty icon grid. Specifying an app on the command line bypasses it. (@hikari-no-yume)
- The new
--button-to-touch=option lets you map a button on your game controller to a point on the touch screen. touchHLE also now includes default button mappings for some games. (@hikari-no-yume) - The new
--print-fpsoption lets you monitor the framerate from the console. (@hikari-no-yume)
Other:
-
To assist with debugging and development, touchHLE now has a primitive implementation of the GDB Remote Serial Protocol. GDB can connect to touchHLE over TCP and set software breakpoints, inspect memory and registers, step or continue execution, etc. This replaces the old
--breakpoint=option, which is now removed. (@hikari-no-yume) -
The version of SDL2 used by touchHLE has been updated to 2.26.4. (@hikari-no-yume)
-
Building on common Linux systems should now work without problems, and you can use dynamic linking for SDL2 and OpenAL if you prefer. Note that we are not providing release binaries. (@GeffDev)
-
Some major changes have been made to how touchHLE interacts with graphics drivers:
- touchHLE can now use a native OpenGL ES 1.1 driver where available, rather than translating to OpenGL 2.1. This is configurable with the new
--gles1=option. (@hikari-no-yume) - The code for presenting rendered frames to the screen has been rewritten for compatibility with OpenGL ES 1.1. (@hikari-no-yume)
- The splash screen is now drawn with OpenGL ES 1.1, either natively or via translation to OpenGL 2.1, rather than with OpenGL 3.2. (@hikari-no-yume)
Theoretically, none of these changes should affect how touchHLE behaves for ordinary users in supported apps, but graphics drivers are inscrutable and frequently buggy beasts, so it's hard to be certain. As if to demonstrate this, these changes somehow fixed the mysterious macOS-only memory leak.
- touchHLE can now use a native OpenGL ES 1.1 driver where available, rather than translating to OpenGL 2.1. This is configurable with the new
-
The new
--headlessoption lets you run touchHLE with no graphical output and no input whatsoever. This is only useful for command-line apps. (@hikari-no-yume)
0.1.2
- Améliorations de l'API : UIImage, CGImage et CGBitmapContext partiellement implémentés pour charger des textures PNG via le code d'exemple d'Apple.
- Ajout du support du format MP3 dans Audio Toolbox (solution temporaire, résultats variables).
- Support ajouté pour Touch & Go LITE et Super Monkey Ball Lite (version complète déjà supportée).
- Correction d'un bug dans stb_image permettant le chargement des splash screens et icônes.
- Avertissement affiché pour les apps nécessitant une version plus récente d'iPhone OS.
- Options utilisateur sauvegardables dans des fichiers (touchHLE_default_options.txt, touchHLE_options.txt).
Hi everyone!
Yesterday was the 15-year anniversary of the iPhone SDK launch. Isn't that neat? I was hoping this release would be out yesterday, but alas I didn't manage to get everything done in time.
Something very cool did come out yesterday, though: Stop Skeletons From Fighting's video about the touchHLE project, and the story of Super Monkey Ball for iPhone. It's pretty fantastic, please watch it!
Anyway, without further ado, here's what touchHLE v0.1.2 has to offer…
Compatibility:
- API support improvements:
- Various small contributions. (@hikari-no-yume, @nitinseshadri)
- Some key parts of
UIImage,CGImageandCGBitmapContextused by Apple'sTexture2Dsample code are now implemented. Loading textures from PNG files in this way should now work. (@hikari-no-yume) - MP3 is now a supported audio file format in Audio Toolbox. This is done in a fairly hacky way so it might not work for some apps. (@hikari-no-yume)
- New supported apps:
- Touch & Go LITE
- Super Monkey Ball Lite (full version was already supported)
Quality:
- The version of stb_image used by touchHLE has been updated. The new version includes a fix for a bug that caused many launch images (splash screens) and icons to fail to load. Thank you to @nothings and @rygorous who diagnosed and fixed this.
Usability:
- The virtual cursor controlled by the right analog stick now uses a larger portion of the analog stick's range. (@hikari-no-yume)
- Basic information about the app bundle, such as its name and version number, is now output when running an app. There is also a new command-line option,
--info, which lets you get this information without running the app. (@hikari-no-yume) - You are now warned if you try to run an app that requires a newer iPhone OS version. (@hikari-no-yume)
- Options can now be loaded from files. (@hikari-no-yume)
- The recommended options for supported apps are now applied automatically. See the new
touchHLE_default_options.txtfile. - You can put your own options in the new
touchHLE_options.txtfile. - If you're a Windows user, this means that dragging and dropping an app onto
touchHLE.exeis now all you need to do to run an app.
- The recommended options for supported apps are now applied automatically. See the new
Other:
- The version of dynarmic used by touchHLE has been updated. This will fix build issues for some people. (@hikari-no-yume)
Enjoy!
0.1.1
- Ajout du support de l'application Crash Bandicoot Nitro Kart 3D (version 1.0 uniquement).
- Amélioration du support API : prise en charge basique des entrées/sorties POSIX, des Audio Session Services et de MPMoviePlayerController.
- Optimisation du code limitant l'usage du CPU pour une meilleure réactivité et une consommation énergétique équilibrée.
- Accélération de l'accès mémoire par le CPU via un chemin plus direct, améliorant les performances de 25 % dans certains cas.
- Correction de l'encodage/décodage gamma pour le rendu de texte avec UIStringDrawing, résolvant un problème visuel dans Super Monkey Ball.
Compatibility:
- API support improvements:
- Various small contributions. (@hikari-no-yume, @nitinseshadri, @LennyKappa, @RealSupremium)
- Basic POSIX file I/O is now supported. Previously only standard C file I/O was supported. (@hikari-no-yume)
- Very basic use of Audio Session Services is now supported. (@nitinseshadri)
- Very basic use of
MPMoviePlayerControlleris now supported. No actual video playback is implemented. (@hikari-no-yume)
- New supported app: Crash Bandicoot Nitro Kart 3D (version 1.0 only).
Quality and performance:
- The code that limits CPU use has reworked in an attempt to more effectively balance responsiveness and energy efficiency. Frame pacing should be more consistent and slowdowns should be less frequent. No obvious impact on energy use has been observed. (@hikari-no-yume)
- The emulated CPU can now access memory via a more direct, faster path. This can dramatically improve performance and reduce CPU/energy use, in some cases by as much as 25%. (@hikari-no-yume)
- Fixed missing gamma encoding/decoding when rendering text using
UIStringDrawing. This was making the text in Super Monkey Ball's options menu look pretty ugly. (@hikari-no-yume)
Usability:
.ipafiles can now be opened directly, you don't need to extract the.appfirst. (@DCNick3)- New command-line options
--landscape-leftand--landscape-rightlet you change the initial orientation of the device. (@hikari-no-yume) - The app bundle or
.ipafile no longer has to be the first command-line argument. (@hikari-no-yume)
Other:
- Some of the more spammy warning messages have been removed or condensed. (@hikari-no-yume)
0.1.0
No details for this version.
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.