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

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:
   • macOS: unofficial macOS build · Windows/Linux: official releases
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.

Unofficial macOS Build (Apple Silicon, Native Metal) — 2026-09-20

Unleashed Recompiled — Unofficial macOS Build (Apple Silicon, Native Metal)

Unofficial community build. Not affiliated with hedge-dev or SEGA. Use at your own risk.

This is a macOS (Apple Silicon) build of Unleashed Recompiled using the native Metal rendering backend from hedge-dev/UnleashedRecomp#1648 by @squidbus. Metal is the default renderer in this build (MoltenVK/Vulkan remains available as an option).

• Source: the metal branch of this fork, commit 97193c6d526f8c7c1b8f462403acf50d3276fc4a (mirrors squidbus/UnleashedRecomp:metal, 2026-05-25) — GPL-3.0
• Built with: Xcode 27 / macOS 27, CMake preset macos-release (Release + LTO), arm64
• Credits: hedge-dev for Unleashed Recompiled, @squidbus for the Metal backend, macOS support, and XenosRecomp MSL support

Requirements

• Apple Silicon Mac (M1 or newer) — no Intel build
• macOS 15 or above recommended for optimal performance (per the PR)
• Your own legally dumped copy of Sonic Unleashed (Xbox 360). This build contains no game files. On first launch the installer asks for your game dump — see the official dumping guide.

Install

1. Download and extract UnleashedRecomp-macOS-arm64-metal-20260920.tar.gz
2. Move Unleashed Recompiled.app to /Applications
3. The app is ad-hoc signed (not notarized), so on first launch:
   • Right-click the app → Open → Open, or
   • run xattr -dr com.apple.quarantine "/Applications/Unleashed Recompiled.app" in Terminal
4. If you already had a previous Unleashed Recompiled installation, your game data, saves, and settings in ~/Library/Application Support/UnleashedRecomp are picked up automatically.

Testing status

• Verified on an M4 Pro (macOS 27): builds clean, boots, renders via the native Metal backend, picks up an existing installation.
• The source is squidbus's metal branch, which they report as tested with a full playthrough (see the PR).
• Known open macOS issues inherited from upstream: #1771 (crash when plugging in a controller), #1737 (white screen in the first Gaia Temple cutscene).

Notes

• Report Metal-specific issues to PR #1648 only after confirming they don't happen on other backends.
• To switch back to Vulkan/MoltenVK: set GraphicsAPI = "Vulkan" in ~/Library/Application Support/UnleashedRecomp/config.toml.