Skip to content

Unofficial iOS Build (A17 Pro+, Native Metal, Experimental) — 2026-11-02

Pre-release
Pre-release

Choose a tag to compare

View all tags
@yorgunkral31 yorgunkral31 released this 02 Nov 13:51
ios-20261102
78f224b

Unleashed Recompiled — Unofficial iOS Build (Experimental)

Unofficial, experimental community build. Not affiliated with hedge-dev or SEGA. Expect rough edges — report issues to this fork's issues, not to the upstream project.

Sonic Unleashed running natively on iPhone — static recompilation, no emulator, no JIT, rendering through the native Metal backend.

Built from the ios branch: the iOS port by @Markos-Th09 (hedge-dev#1767) + the native Metal backend by @squidbus (hedge-dev#1648) + my fixes (stable boot, shader generation, ProMotion, suspend/resume, iOS 27 scene lifecycle, full-screen landscape).

What's new since the 2026-10-31 build

  • Touch controls and a native file picker from the latest iOS port by @Markos-Th09. The installer can now pick game files straight from the Files app on the phone.
  • App icon on the home screen.
  • Shaders are precompiled for Metal at build time instead of on first use, which shortens loading and reduces hitches.
  • Everything from the 2026-10-31 build is kept: launches on iOS 27 with the UIScene lifecycle (scene integration based on @DevZer0D4Y's work), fills the screen in landscape, survives locking and app switching.

Tested on an iPhone 16 Pro (iOS 27.2): launch, full-screen rendering, app icon, the file picker opening from the installer, and repeated background/foreground cycles without a crash. Gameplay, 120 FPS and controllers were verified on the previous builds. I haven't yet done a full on-device install through the new picker or played with the touch controls myself, so feedback on those is very welcome.

Requirements

  • iPhone 15 Pro / 16 series or newer (A17 Pro+ GPU required for BC texture support). M-series iPads should also work (untested).
  • iOS 16.4+
  • ~10 GB free storage (app + game data)
  • Your own legally dumped copy of Sonic Unleashed (Xbox 360) — this build contains no game files

Install

  1. Sideload the IPA with AltStore, SideStore, or Sideloadly — the tool re-signs it with your own Apple ID. (Free Apple IDs need re-signing every 7 days; paid developer accounts last a year.)
  2. Install the game data, either way:
    • On the phone: put your game dump in the Files app, launch the app and pick the files in the installer.
    • From a computer (tested path): install the game with Unleashed Recompiled on your computer (macOS build · Windows/Linux), then copy the folders game, update, patched (and optionally dlc and save) into On My iPhone → Unleashed Recompiled with the Files app or Finder.
  3. Launch. For high frame rates, raise the FPS setting in Options (ProMotion devices go up to 120).

Controls

  • Touch controls are built in. A Bluetooth controller is still the best experience (DualShock 4 verified; Xbox controllers should work).
  • Hardware keyboards also work, including the Mac's keyboard through iPhone Mirroring.

Known limitations

  • FPS dips in effect-heavy moments; 120 FPS mode increases battery drain and heat
  • Experimental: crashes or bugs may exist that the desktop versions don't have

Source & credits

GPL-3.0 — source: ios branch (+ plume fork). Built with Xcode 27.2 (iOS 27.2 SDK), ios-device-release preset.

All credit to hedge-dev for Unleashed Recompiled, @Markos-Th09 for the iOS port, touch controls and file picker, @squidbus for the Metal backend and XenosRecomp MSL support, and @DevZer0D4Y for the UIScene integration.

SHA-256 (UnleashedRecomp-iOS-arm64-metal-20261102.ipa): 0b00637be00fede860c789958244881628e98d35fd08e6fb1613d08c7af9fef6

Assets 3
Loading