Skip to content

Unofficial iOS Build (A17 Pro+, Native Metal, Experimental) — 2026-09-21

Pre-release
Pre-release

Choose a tag to compare

View all tags
@yorgunkral31 yorgunkral31 released this 21 Sep 12:43
· 9 commits to ios since this release
ios-20260921
9bb873e

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) + this fork's fixes (stable boot, corrected shader generation, ProMotion support — full findings).

Verified on an iPhone 16 Pro: stable boot, correct rendering, up to 120 FPS (ProMotion), day & night stages, Bluetooth DualShock 4.

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
  • A computer for one-time setup (see below)

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. Prepare the game data on a computer — the on-device installer is not functional yet. Install the game with Unleashed Recompiled on your computer first:
  3. Copy the installation to your iPhone with the Files app (or Finder file sharing): copy the folders game, update, patched (and optionally dlc and save) into On My iPhone → Unleashed Recompiled.
    • macOS source: ~/Library/Application Support/UnleashedRecomp/ · Windows: the game's install folder
  4. Launch. For high frame rates, raise the FPS setting in Options (ProMotion devices go up to 120).

Controls

  • Bluetooth controller strongly recommended (DualShock 4 verified; Xbox controllers should work). There are no touch controls yet.
  • Hardware keyboards also work — including the Mac's keyboard through iPhone Mirroring.

Known limitations

  • No on-device installer yet (game data must be prepared on a computer)
  • No touch controls
  • 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, ios-device-release preset.

All credit to hedge-dev for Unleashed Recompiled, @Markos-Th09 for the iOS port foundation, and @squidbus for the Metal backend and XenosRecomp MSL support.

Assets 3
Loading