sonic-riders-recomp

Sonic Riders native port

Play Sonic Riders (GameCube, USA) natively, with no emulator, on a modded Nintendo Switch, a Windows PC, an Android phone, Linux / Steam Deck (new, untested on a Deck), or an iPhone / iPad (new, built on a Mac). The game is rebuilt on your own PC from your own disc image; this project contains no game files.

Original (4:3) This port (PC, 21:9)

Original (4:3) This port (PC, 21:9)

Get it

I want to play on...	Download from the latest release	Guide
a Windows PC	SonicRiders-PC-Setup-<version>.zip	Install on PC
a modded Nintendo Switch	SonicRiders-Switch-Setup-<version>.zip	Install on Switch
an Android phone (64-bit, Android 11+)	SonicRiders-Android-Setup-<version>.zip	Install on Android
Linux or a Steam Deck (new, test version)	SonicRiders-Linux-Setup-<version>.zip from the Linux test pre-release	Install on Linux / Steam Deck
an iPhone or iPad (new; built on a Mac)	SonicRiders-iOS-Setup-<version>.zip	Install on iPhone / iPad

In short: extract the zip, double-click the Install Sonic Riders file, pick your disc image, and wait 10–30 minutes the first time (Android: 20–40, then it installs over a USB cable). Every version is built on a Windows 10/11 PC, except Linux / Steam Deck, which builds on the Linux machine itself (no compiler or root rights needed), and iPhone / iPad, which builds on a Mac with Xcode.

You need: your own Sonic Riders (USA) disc image (GXEE8P, a full 1.4 GB .iso) and a 64-bit Windows 10 (1803+) or 11 PC with internet the first time. Switch: custom firmware with the Homebrew Menu. PC: a graphics card with OpenGL 3.3. Android: USB debugging turned on, about 2 GB free on the phone. All requirements

Playing

	Switch	PC keyboard	PC gamepad
Move	Left stick	W A S D	Left stick
A / B / X / Y	A / B / X / Y	J / K / L / I	A / B / X / Y
START	+	Enter	Start
Settings menu	hold −	hold F1	hold Back

Android: touch controls on screen (top-left button = settings menu) or any controller. Up to 4 players on Switch and PC, 2 on one phone: connect more controllers. Full controls, settings and multiplayer

Status

Playable from boot to races, story mode and 4-player Free Race, with sound, on both platforms.

• PC: 60 fps on the test PC (RTX 3060), 4 players included.
• Switch (stock clocks): a steady 30 fps in races (1 player tested); 60 fps in lighter scenes with the 60 fps setting.
• Android (new in v0.4.0): 60 fps races on a Galaxy S23 Ultra (other phones untested). Screen recording is not supported on Android: recording the screen during a race makes the phone's graphics driver reset the game again and again until it closes. Record with a capture card or play without recording.
• iPhone / iPad (new): 60 fps races on an iPhone 17 Pro, iPad Pro 11" (M1) and iPad (A16) (a short stutter the first time a new effect appears); the iPad 7th generation (2019) plays with small dips on busy tracks.
• Switch (overclocked): 1–2 players mostly 60 fps; 3 players mostly 60 with dips in the busiest moments; 4 players about 30 fps.
• Known issues are tracked in Issues; what changed in each version is in the CHANGELOG.

More

Installing, updating, troubleshooting	Requirements, step-by-step setup, fixes for common problems
Playing	Controls, settings menu, multiplayer, debug options
Reporting bugs	What to include, logs, screenshots
Modding	Swapping characters, changing stats, custom tracks (PC, in progress)
Building from source	For developers
Contributing	Help is welcome from players and developers; coding agents can use CLAUDE.md

How it works

The game's PowerPC code (main.dol + _Main.rel) is translated to C ahead of time on your PC (static recompilation), and the GameCube hardware (graphics, disc, audio, memory card, controllers) is reimplemented natively: deko3d on the Switch, OpenGL 3.3 on PC. The approach follows SwitchWakerHD and ZeldaWWHDRecomp, whose PowerPC→C translator this project forks. Current status is in STATE.md; design notes in docs/REFERENCE.md and docs/HISTORY.md.

Legal

• A fan project, not affiliated with, endorsed or sponsored by SEGA or Nintendo. "Sonic Riders" and "Nintendo Switch" are trademarks of their owners, used only to describe what this works with.
• This repository and its releases contain no game code, assets, data or console keys. You need your own disc image of Sonic Riders (USA), made from a disc you own. Everything derived from the game is generated locally on your PC by the setup tool.
• Never share your built .nro, .exe or .nsp, or your disc image. Issues and pull requests that contain game files are deleted.

Licensed under the Mozilla Public License 2.0, like the ZeldaWWHDRecomp translator it forks (third_party/LICENSE-MPL-2.0).

Credits

• SwitchWakerHD and ZeldaWWHDRecomp: the approach, and the PowerPC→C translator this project forks (MPL-2.0).
• Dolphin: hardware documentation and behaviour reference (no Dolphin code is included).
• decomp-toolkit: analysis of the game's executables.
• devkitPro, libnx and deko3d: the Switch toolchain and graphics API.
• nx-hbloader (ISC) and hacBrewPack: the optional forwarder NSP.
• SDL2 and llvm-mingw: the PC version.
• Dear ImGui (MIT): the settings menu; its layout follows SwitchWakerHD's settings overlay.
• AMD FidelityFX Super Resolution 1 (MIT): the sharpening and upscaling (EASU, RCAS), ported to GLSL in runtime/src/platform/host/fsr1_gl.h and runtime/shaders/vk_easu.frag / vk_rcas.frag.
• gamemasterplc's 16:9 Gecko code: the idea behind the widescreen option.
• Banner image: fan art by an unknown artist. If it's yours, open an issue and we'll credit you or remove it.
• Game icon (setup/icon.png): fan-made Sonic Riders icon by cedry2kio on DeviantArt, used with credit. cedry2kio, if you'd like it changed or removed, open an issue and we'll do it right away.

Sonic Riders is © SEGA. This project is not affiliated with SEGA.