Repository navigation
Unleashed Recompiled — Unofficial macOS Build (Apple Silicon, Native Metal)
Unofficial community build. Not affiliated with hedge-dev or SEGA. Report problems to this fork's issues, not to the upstream project.
A macOS (Apple Silicon) build of Unleashed Recompiled using the native Metal rendering backend from hedge-dev/UnleashedRecomp#1648 by @squidbus.
What's fixed since the 2026-09-20 build
- Crash right after launch on macOS older than 27. The previous build's Metal shaders were compiled only for macOS 27, so on older versions the Metal renderer couldn't load them. All 1,385 shaders are now built for macOS 13 and later, matching the app's minimum. If you switched to Vulkan to work around the crash, you can set
GraphicsAPIback to"Auto".
I verified the fix by checking the target of every shader in the build and by playing it on an M4 Pro (macOS 27). I don't have an older macOS to test on, so if you were seeing the crash, please let me know in the issues whether it's gone.
Requirements
- Apple Silicon Mac (M1 or newer). There's no Intel build.
- macOS 13 Ventura or newer
- Your own legally dumped copy of Sonic Unleashed (Xbox 360). PS2, PS3 and Wii copies won't work. This build contains no game files; see the official dumping guide.
Install
- Download and extract
UnleashedRecomp-macOS-arm64-metal-20261110.tar.gz - Move
Unleashed Recompiled.appto/Applications - The app is ad-hoc signed (not notarized), so on first launch right-click it → Open → Open, or run
xattr -dr com.apple.quarantine "/Applications/Unleashed Recompiled.app"in Terminal. - An existing installation in
~/Library/Application Support/UnleashedRecomp(game data, saves, settings) is picked up automatically.
Troubleshooting
- Can't find the
Libraryfolder: it's hidden by default. In Finder press Cmd + Shift + G and paste~/Library/Application Support/UnleashedRecomp - Still crashing at launch: set
GraphicsAPI = "Vulkan"inconfig.tomlin that folder to use the MoltenVK renderer, and please open an issue with your Mac model and macOS version. - Controller: connect it before launching the game. Plugging one in while the game runs can crash it (hedge-dev#1771).
- Known upstream issue: white screen in the first Gaia Temple cutscene (hedge-dev#1737).
Source & credits
GPL-3.0. Source: metal branch, commit cf57aee. Built with Xcode 27.2, CMake preset macos-release, arm64.
Credit to hedge-dev for Unleashed Recompiled, @squidbus for the Metal backend and macOS support, and @Markos-Th09 for the XenosRecomp option that sets the shaders' minimum macOS version.
Also available: an iOS build for iPhone 15 Pro / 16 series and newer.
SHA-256 (UnleashedRecomp-macOS-arm64-metal-20261110.tar.gz): 8196f16322b5c1e82f0c75035d38cae707116c97edbd3b2f050ac1dd0f8497dd