{
  "name": "iOS Apps",
  "icon": "https://bb10repo.whytofly.de/img/bb10-touchhle-installer.png",
  "category": "Runtime",
  "type": "bar",
  "author": "touchHLE: hikari_no_yume and contributors (MPL-2.0). BB10 port, installer and packaging: whytofly.",
  "homepage": "https://touchhle.org/",
  "description": "Install iPhone apps and games on your BlackBerry 10 phone, from the phone. Pick an .ipa from your own storage, tap Install, and it becomes a real home-screen icon with its own rounded iOS icon — the same as any other app.\n\nRuns on touchHLE, an emulator for iPhone OS 2.x-4.x apps, which is INCLUDED in this package. There is nothing else to install.\n\n— INSTALLING —\n\nThis package is self-contained: it brings the touchHLE emulator with it and pulls in bb10-bar-install automatically. Nothing else to set up, and no root.\n\n— HOW TO USE —\n\n1. Copy your own legally-acquired .ipa files to the phone, anywhere under:\n     /accounts/1000/shared/documents/\n     /accounts/1000/shared/downloads/\n   (Total Commander, BBDT, SCP, USB Mass Storage or the Files app all work.)\n\n2. Open 'iOS Apps' from the home screen. It lists every .ipa it can find, with sizes.\n\n3. Tap one, then tap Install. A large app takes a few minutes — the progress screen shows the installer's own output as it goes.\n\n4. The new icon appears on the home screen and opens straight into the app. Remove it like any other app: hold on the home screen and tap the X.\n\n— COMMAND LINE —\n\nThe same thing without the GUI, from Term49 or ssh:\n\n     install-ipa-ondevice.sh <file.ipa>\n     install-ipa-ondevice.sh --remove <file.ipa>\n\n— UPDATING THE EMULATOR —\n\nAn installed game holds only a ~12KB launcher, not a copy of the emulator: it finds the newest runtime on the device when it starts. So updating THIS package updates the emulator for every game you have installed, and you do not have to reinstall anything.\n\n— NO ROOT REQUIRED —\n\nInstalling runs entirely as an ordinary user. It does not need bb10-rootd, a rooted phone, or a computer.\n\n— WHAT WORKS —\n\ntouchHLE targets iPhone OS 2-4 era apps; not everything from that era runs, and newer iOS apps will not. See https://appdb.touchhle.org/ for per-title status. Performance depends on the title: 2D games generally run at full speed, heavy 3D ones do not.\n\nAll copyright in the apps you install remains with their authors. This package ships only the emulator and the installer; it does not bundle, distribute or modify any app.",
  "history": [
    {
      "version": "1.11",
      "released": "2026-10-06",
      "changes": "- Fixes games sometimes drawing a tiled, repeating pattern instead of the game (seen in Angry Birds Lite and N.O.V.A.). touchHLE set up the emulated iPhone's memory on top of memory the graphics driver and the system log were already using; depending on where the system placed those on each launch, a game could start with corrupted textures. The emulator's memory is now reserved before anything else starts, and anything already in the way is left alone.\n- Carries the updated touchHLE runtime, so every installed game picks it up at next launch without being reinstalled."
    },
    {
      "version": "1.10",
      "released": "2026-10-05",
      "changes": "- N.O.V.A. no longer closes right after its splash screen. touchHLE's hang watchdog treated its long asset load (over 20 seconds without drawing a frame) as a hang and closed it. A game that is still working now gets two minutes; one that is genuinely stuck is still stopped after 20 seconds.\n- The Browse, Settings and About tabs now show on a fresh install too. With no .ipa files found yet, the app showed only a message, with no visible way to browse for files elsewhere.\n- Listed under Runtime in Rubus.\n- Known issue (fixed in 1.11): on some launches Angry Birds Lite and N.O.V.A. drew a tiled, repeating pattern instead of the game."
    },
    {
      "version": "1.9",
      "released": "2026-10-04",
      "changes": "- Fixes \"Could not prepare the .ipa: cannot write to /tmp\". The installer copies the .ipa into RAM so the system installer can read it, and did so through /tmp; on a phone where /tmp had been shadowed by a root-owned directory, every install failed. It now uses /dev/shmem directly, which /tmp normally points to and which nothing can shadow, and the error names the real cause if it ever fails again."
    },
    {
      "version": "1.8",
      "released": "2026-10-04",
      "changes": "- N.O.V.A. no longer shows a black screen. Games written for the iPhone's GPU upload textures in a format the BlackBerry's GPU refuses; the runtime now converts them.\n- Fixes Angry Birds Lite's screen breaking into repeating strips (a regression in 1.7's runtime).\n- Carries the updated touchHLE runtime, so every installed game picks it up at next launch without being reinstalled."
    },
    {
      "version": "1.7",
      "released": "2026-10-04",
      "changes": "- The \"Show frame rate\" setting now actually shows a frame rate. It only ever wrote the rate to a log, and a game started from the home screen has no log you can see, so the switch appeared to do nothing. The counter is drawn in the top-right corner of the game.\n- Carries an updated touchHLE runtime, so every installed game picks it up at next launch without being reinstalled."
    },
    {
      "version": "1.6",
      "released": "2026-09-28",
      "changes": "- Fixed flickering at the top of the screen while scrolling. A row scrolled only partly above the list was still drawn from its own position, so it painted over the title bar (and, on Browse, the path line) by a different amount every frame. Drawing is now clipped to the list area, which fixes every scrolling screen at once.\n- The app's own home-screen icon is now rounded like the icons it gives the apps you install. It was the one square tile on a home screen full of rounded ones."
    },
    {
      "version": "1.5",
      "released": "2026-09-28",
      "changes": "- Fixed a button with no label. The 'Back' button on the install-confirm screen drew white text on a white background, so the one screen that asks you to make a decision showed an empty rounded rectangle. Button labels now take their colour from the button.\n- Fixed overlapping text on the install progress screen: the line spacing was still the one tuned for the old small font.\n- Listing screenshots refreshed to the current interface, and now show the install confirmation, the home screen with installed iOS apps, and a game running."
    },
    {
      "version": "1.4",
      "released": "2026-09-27",
      "changes": "- Larger text throughout. The type was correct but too small to read comfortably at arm's length; every size is up about a quarter, and line spacing now follows the text size instead of being fixed pixel counts, so nothing crowds.\n- About lists all four scan folders again -- the bigger lines had pushed two of them off the bottom, which made a list that answers \"where does it look?\" give the wrong answer.\n- Home-screen labels are spaced too, so an app whose bundle calls itself \"GalaxyOnFire\" no longer appears as \"GalaxyOnFi\"."
    },
    {
      "version": "1.3",
      "released": "2026-09-27",
      "changes": "- Real text. The interface was drawn with an 8x8 bitmap font scaled up, which is why it still looked like a terminal after the layout was reworked. It now uses FreeType with the phone's own Slate Pro family: anti-aliased, properly proportioned, with a heavier weight for titles and headings.\n- App names are spaced for display, so \"CutTheRope\" reads as \"Cut The Rope\". Acronyms are left alone.\n- The About tab showed the wrong version (1.1 against a shipped 1.2). It now comes from one place, so it cannot drift again.\n- The first-run permission dialog said \"iOS Apps by Unknown\". It now names the project."
    },
    {
      "version": "1.2",
      "released": "2026-09-27",
      "changes": "- Fixed: removing this package left the app on the home screen. The uninstall hook deleted its own staging copy before the installer had read it, so the uninstall failed while the package record was removed anyway -- and because these install as system apps, the leftover could not be deleted from the home screen either.\n- Fixed two related bugs in the same hook: it ran with a minimal PATH where the tool it used to verify the copy does not exist, and it never checked that the copy succeeded."
    },
    {
      "version": "1.1",
      "released": "2026-09-27",
      "changes": "- Settings: frame-rate display, frame-rate limit, resolution and network access, applied to EVERY installed game at once (a game with its own options keeps them).\n- Browse: a file picker, so an .ipa in a subfolder can be found. The Apps tab only scans four fixed folders and does not recurse.\n- About: installer and runtime versions, and credits to touchHLE's authors.\n- Fixed flickering while scrolling (the UI was single-buffered).\n- Fixed the colours: red and blue were swapped, so the app was not even drawing its own palette.\n- Reworked to look like iOS: light grouped lists, hairline separators, system blue, rounded buttons, proportional text.\n- Installed games now request Shared Files access so device-wide settings reach them; each game asks once on first launch."
    },
    {
      "version": "1.0",
      "released": "2026-09-27",
      "changes": "- Initial release.\n- On-device .ipa installer with a file list, progress view and uninstall.\n- Command-line installer (install-ipa-ondevice.sh) for Term49 / ssh.\n- Includes the touchHLE runtime; installed games share it, so one update reaches all of them.\n- Icons are masked to iOS's rounded-corner shape at packaging time.\n- Installs with NO ROOT: bar-install runs as devuser through the setuid __devuser helper."
    }
  ],
  "screenshots": [
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/01-app-list.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/02-install-confirm.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/03-settings.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/04-browse.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/05-about.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/06-home-screen.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/07-spore-running.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/08-angry-birds.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/09-assassins-creed.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/10-katamari.png",
    "https://bb10repo.whytofly.de/img/screenshots/bb10-touchhle-installer/11-tetris.png"
  ]
}
