Skip to content

touchHLE

Type standalone
Classification Embedded HLE
Source https://github.com/touchHLE/touchHLE
Version 0.2.3
Revision touchHLE/touchHLE@3c5850585ba5
Profiled 2026-10-17
Profile YAML, JSON
Cores touchhle, touchhle-sa
Systems apple-ios
Technical notes

High-level emulator for iPhone OS apps. The operating system and its frameworks are reimplemented in Rust, so no Apple firmware or system file is opened. What it reads besides the app are resources bundled with it: three Free Software ARMv6 libraries, fonts, and a table of default per-app options. ref: Cargo.toml:7, src/paths.rs:9-12, src/paths.rs:28-36

Resources are opened relative to the working directory, or the Resources folder of a macOS bundle. ROCKNIX patches the Linux base to /usr/lib/touchHLE. ref: src/paths.rs:63-82

The libraries are mapped into the guest at /usr/lib under their own names and aliases. An app binary that links one of them loads it from there, and fails to start with "Could not load bundled dylib" when the host file is missing. ref: src/fs.rs:588-622, src/environment.rs:384-413

Fonts are opened the first time an app draws text in that face, and a missing or unparsable file is a panic. The Liberation families stand in for the iPhone OS faces, and Noto Sans JP is used for strings holding kana or kanji. ROCKNIX installs only the LiberationSans files, so an app that asks for a monospace, serif or Japanese face stops there. ref: src/font.rs:70-129, src/frameworks/uikit/ui_font.rs:26-43, src/frameworks/uikit/ui_font.rs:180-205

touchHLE_default_options.txt is read before the user's touchHLE_options.txt; when it cannot be opened a warning is printed and the app runs without it. ref: src/lib.rs:319-323

18 files | 0 required, 18 optional | 0 in repo, 18 missing Categories: 17 BIOS, 1 game data

libgcc_s.1.dylib optional missing bundled #
GCC runtime library from the iPhoneOS 4.0 SDK

  • Path: touchHLE_dylibs/libgcc_s.1.dylib
  • System: apple-ios
  • SHA1: 827d9304ade7342560b83bb2d79519161a36a395
  • MD5: f170c90d0940c5989c7ea65f6832906b
  • Source: src/fs.rs:588-622, src/environment.rs:384-413
  • Exposed as /usr/lib/libgcc_s.1.dylib. Needed by apps that link it.

libstdc++.6.0.9.dylib optional missing bundled #
GNU C++ standard library from the iPhoneOS 4.0 SDK

  • Path: touchHLE_dylibs/libstdc++.6.0.9.dylib
  • System: apple-ios
  • SHA1: 80a78b90ed2af3656947124a623be06346c91c07
  • MD5: d44ff6644a1f42e1a333664752940266
  • Source: src/fs.rs:588-622, src/environment.rs:384-413
  • Exposed as /usr/lib/libstdc++.6.dylib and /usr/lib/libstdc++.6.0.9.dylib. Needed by apps that link it.

libz.1.2.3.dylib optional missing bundled #
zlib built from Apple's zlib-23.0.1 sources

  • Path: touchHLE_dylibs/libz.1.2.3.dylib
  • System: apple-ios
  • SHA1: c7a074cc2a28618205107da722d3030441a7f791
  • MD5: 6b2f78a706d9b46f038059ef01c97253
  • Source: src/fs.rs:588-622, src/environment.rs:384-413
  • Exposed as /usr/lib/libz.1.2.3.dylib, libz.1.dylib, libz.dylib and libz.1.1.3.dylib. Needed by apps that link it.

LiberationMono-Regular.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationMono-Regular.ttf
  • System: apple-ios
  • SHA1: 6d137827a5b3b5b4ca2378642cdee0f65497ad0b
  • MD5: e59b87dce1497a1ba08d472667722916
  • Source: src/font.rs:70-85, src/font.rs:88-90
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationMono-Bold.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationMono-Bold.ttf
  • System: apple-ios
  • SHA1: 621736fa22ae2661eff1a0a199f882733440a33c
  • MD5: e52e17953632fd6f1da5e51c84a6dea7
  • Source: src/font.rs:70-85, src/font.rs:91-93
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationMono-BoldItalic.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationMono-BoldItalic.ttf
  • System: apple-ios
  • SHA1: 6dbf7cd701cb1048dd7a2a01f84b5473842bf3ba
  • MD5: 00bed708fb7614c12c92cfd16f1fb7b8
  • Source: src/font.rs:70-85, src/font.rs:94-96
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationMono-Italic.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationMono-Italic.ttf
  • System: apple-ios
  • SHA1: 67ec8aefea86e24e6a875e9f5b78437e75edf9e8
  • MD5: fe762a65e22e23c935aff8eda38eaaf3
  • Source: src/font.rs:70-85, src/font.rs:97-99
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationSans-Regular.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationSans-Regular.ttf
  • System: apple-ios
  • SHA1: 822a13649cfa7475343d52bfb2db9f0358a36822
  • MD5: d7b4e92b03deb1865aa61328fd5ff400
  • Source: src/font.rs:70-85, src/font.rs:100-102
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationSans-Bold.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationSans-Bold.ttf
  • System: apple-ios
  • SHA1: 4e5ee6e5de4d35337f7d14fa43222908e28e2d8d
  • MD5: ab3823f8c454609eab661b54751fd55e
  • Source: src/font.rs:70-85, src/font.rs:103-105
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationSans-BoldItalic.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationSans-BoldItalic.ttf
  • System: apple-ios
  • SHA1: cbf18b615d022b3a49c114c1fdea5170e04e8d08
  • MD5: ad144bbd42d9dccb07db1aae6682b98b
  • Source: src/font.rs:70-85, src/font.rs:106-108
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationSans-Italic.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationSans-Italic.ttf
  • System: apple-ios
  • SHA1: aa4de844c5538cb9bf5393ed767884cd72f2b448
  • MD5: 333f554fddaa0faf89afc3621a6a18c8
  • Source: src/font.rs:70-85, src/font.rs:109-111
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationSerif-Regular.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationSerif-Regular.ttf
  • System: apple-ios
  • SHA1: e617879345422a0e204de4b1dff4a41103992d64
  • MD5: 732ab01395f607bf178d0f32d841cc71
  • Source: src/font.rs:70-85, src/font.rs:112-114
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationSerif-Bold.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationSerif-Bold.ttf
  • System: apple-ios
  • SHA1: d38816f0b2205dc619c061a60ef5f250b9bdf231
  • MD5: 184a866d565bae797baa39458fde7ac4
  • Source: src/font.rs:70-85, src/font.rs:115-117
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationSerif-BoldItalic.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationSerif-BoldItalic.ttf
  • System: apple-ios
  • SHA1: 7e9704cabad534e2a56b32bbbec89a8d7e4e138f
  • MD5: 23e615c7010f0ad9f1d2817009733cb9
  • Source: src/font.rs:70-85, src/font.rs:118-120
  • Opened on first use of its face. touchHLE panics when it is missing.

LiberationSerif-Italic.ttf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/LiberationSerif-Italic.ttf
  • System: apple-ios
  • SHA1: c5f801425d1f93be54e31267813f4367755f096c
  • MD5: 31defdf69fc00c20b9caabe3e76d53e1
  • Source: src/font.rs:70-85, src/font.rs:121-123
  • Opened on first use of its face. touchHLE panics when it is missing.

NotoSansJP-Regular.otf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/NotoSansJP-Regular.otf
  • System: apple-ios
  • SHA1: 2a167a116b54ecd4f939e47d0ad78cb3402d938c
  • MD5: f82ef23cfbf8b46a234465b0151ee71f
  • Source: src/font.rs:70-85, src/font.rs:124-126
  • Opened on first use of its face. touchHLE panics when it is missing.

NotoSansJP-Bold.otf optional missing bundled #
Bundled font

  • Path: touchHLE_fonts/NotoSansJP-Bold.otf
  • System: apple-ios
  • SHA1: a7a997c4c894d2cc691332e7232d909d4f08a552
  • MD5: 77921099a1d3fce6fb64a7b3b678b7dc
  • Source: src/font.rs:70-85, src/font.rs:127-129
  • Opened on first use of its face. touchHLE panics when it is missing.

touchHLE_default_options.txt optional missing game_data bundled #
Default options per app

  • System: apple-ios
  • SHA1: ee41db73da6e50593fdb95c3dee3bd42783718cf
  • MD5: e982d067cdcbda507773dd9d4b3d4c07
  • Source: src/paths.rs:36, src/lib.rs:319-323
  • Command-line style options keyed by app bundle identifier, applied before the user's own file.

Generated on 2026-10-20T03:49:43Z