Sonic Riders on iPhone and iPad

Start here. The first start of the launcher needs a few clicks in macOS, once. After that the launcher guides you through everything else (Xcode, building, Sideloadly, Developer Mode, renewing).

Before you start

Unzip and keep the folder

Double-click the zip you downloaded. Keep the folder it makes (for example move it into your home folder): the launcher builds the app inside it and needs it again for updates. Its path must not have spaces; if it does, the launcher offers to move it for you.

The launcher is free and unofficial, so it isn't signed by Apple (that costs $99 a year). That is why macOS asks you to allow it once, as shown below.

The first start (once)

Double-click "Sonic Riders Launcher"

It's in the folder you unzipped (the Super Sonic icon).

A warning appears: click Done (the lower, grey button)

macOS says it could not verify the app. Click Done, the grey button at the bottom. Do not click the blue "Move to Trash" button above it: it is highlighted, but it deletes the launcher (if that happened, unzip again).

“Sonic Riders Launcher.app” Not Opened

Apple could not verify “Sonic Riders Launcher.app” is free of malware that may harm your Mac or compromise your privacy.

Move to TrashNOT THIS DoneCLICK THIS

System Settings > Privacy & Security > Open Anyway

Open System Settings (Apple menu > System Settings), click Privacy & Security in the sidebar and scroll down to Security. Next to "Sonic Riders Launcher.app was blocked to protect your Mac" there is now an Open Anyway button (it only appears after step 1). Click it.

Security

Allow applications fromApp Store & Known Developers ⌃⌄

“Sonic Riders Launcher.app” was blocked to protect your Mac. Open Anyway Apple could not verify “Sonic Riders Launcher.app” is free of malware that may harm your Mac or compromise your privacy.

macOS asks once more: click Open Anyway (the middle button)

A question "Open “Sonic Riders Launcher.app”?" appears (if it doesn't, double-click the launcher again). Click Open Anyway, the middle button. Again not the blue "Move to Trash" on top. Then confirm with Touch ID, or click Use Password… and type your Mac password.

Open “Sonic Riders Launcher.app”?

Apple is not able to verify that it is free from malware that could harm your Mac or compromise your privacy. Don’t open this unless you are certain it is from a trustworthy source.

Move to TrashNOT THIS Open AnywayCLICK THIS Done

✋

You are attempting to open an app that may cause harm to your Mac or compromise your privacy

Touch ID or enter an administrator’s name and password to continue with Privacy & Security.

Use Password…OR TOUCH ID Cancel

The launcher opens: click Allow for your folders

macOS asks whether the launcher may use files in your Downloads folder (where its folder and usually your disc image are) and your Desktop folder (where it puts the finished app). Click Allow both times. That's it: from now on the launcher opens with a normal double-click.

✋

“Sonic Riders Launcher.app” would like to access files in your Downloads folder.

Don’t AllowAllow

Then, in the launcher

✓

Get ready: checks Xcode (free, App Store), its iOS platform and Metal Toolchain, and Homebrew's two build tools. Each missing piece has a button that installs or opens it.

Build: pick your own Sonic Riders (USA) disc image and, if you like, any picture as the app icon. The first build takes 15-30 minutes.

Install: step by step with Sideloadly (free): connect the device, sign in with your Apple ID, Developer Mode, trust your Apple ID on the device, copy the disc image.

Renew: with a free Apple ID the app works for 7 days; renewing takes a minute and keeps your saves.

The Terminal way still works: "Install Sonic Riders (iOS).command" in the same folder (it needs the same Privacy & Security step). README-FIRST.txt has all the details. Never share your disc image or the .ipa: they contain the game.