Install & Setup Guide

Step-by-step instructions for installing ReRAC Launcher (v0.3.1-alpha) and Engine (v0.3.9-alpha), verifying your SCUS-97199 ISO, and running natively on Windows, Linux, Steam Deck and macOS.

  • Windows 10/11 · Linux · Deck · macOS
  • SCUS-97199 plain .iso
  • ~4.5 GB extracted footprint
  • Portable CLI mode supported
Desktop gaming PC workstation with dual monitors and tempered glass chassis
Native Rust and Bevy desktop target with 416p-2160p scaling and Fill ultrawide view

Before you start: verify your PS2 disc image

ReRAC requires your own legally dumped PlayStation 2 disc of Ratchet & Clank (2002) as a plain 2048-byte-sector ISO9660 file ending in .iso. No PlayStation 2 firmware or system files are needed.

Disc Serial / FormatRegionRevisionReRAC Status
SCUS-97199 (SCUS_971.99)North America (NTSC-U)v1.00 (Black Label / Greatest Hits v1.00)Supported
SCES-50916Europe / Australia (PAL)v1.00 / v2.00Not yet (Launcher Issue #18; error 21)
SCPS-15037 / PAPX-90208Japan (NTSC-J)All revisionsNot yet (error 21)
.chd / .cso / .zso / .bin+.cueCompressed or raw 2352-byte imagesAnyUnsupported container (error 11; use plain .iso)

Windows 10 & Windows 11 (64-bit) setup

  1. Download & verify: Grab rerac-launcher-windows-x64.msi (4.9 MB) and rerac-0.3.9-windows-x86_64.zip (34.7 MB) from Download, then verify both SHA-256 hashes in the local WebCrypto checker.
  2. Install ReRAC Launcher: Run rerac-launcher-windows-x64.msi. Because the alpha installer is not signed with a commercial Authenticode certificate, if Windows SmartScreen prompts Windows protected your PC, click More info → Run anyway after confirming the SHA-256 hash.
  3. Activate Engine v0.3.9-alpha: Launch ReRAC Launcher. Select v0.3.9-alpha in the Version dropdown above Play; if no release channel entry appears yet, open Settings → Version Management → Development → Install from zip…, pick rerac-0.3.9-windows-x86_64.zip, and click Set active.
  4. Extract your SCUS-97199 ISO: Click Ratchet & Clank in the sidebar, choose Install via ISO, and select your NTSC-U .iso. Wait 3–15 seconds while rerac-extract.exe verifies all 2,937 disc files and generates %LOCALAPPDATA%\rerac\games\rac1\data\cache\v1 (~4.5 GB total).
  5. Play & configure: Click Play. Press F11 for borderless fullscreen, or open Pause → Options → Port Options to enable the Enhanced preset, 16:9 / Fill ultrawide, and 1080p–2160p rendering.

Portable Windows setup (Launcher Issue #12): If you cannot run an MSI installer on a locked-down PC, unpack rerac-0.3.9-windows-x86_64.zip directly to any folder, run rerac-extract.exe extract --iso "C:\path\to\rac1.iso" --out .\data once in PowerShell, and launch rerac.exe --data-dir .\data.

Linux x86_64 & Steam Deck setup

  1. Make the AppImage executable: Download rerac-launcher-linux-x86_64.AppImage (83.7 MB) and rerac-0.3.9-linux-x86_64.zip (47.3 MB). In a terminal (or Dolphin → Properties → Permissions in SteamOS Desktop Mode), run:
    chmod +x ~/Downloads/rerac-launcher-linux-x86_64.AppImage
    ~/Downloads/rerac-launcher-linux-x86_64.AppImage
  2. Import or select v0.3.9-alpha: Pick v0.3.9-alpha from the Version dropdown, or import rerac-0.3.9-linux-x86_64.zip under Settings → Version Management → Development → Install from zip… and click Set active.
  3. Extract to internal SSD or microSD: If you want the ~4.5 GB data folder on a Steam Deck microSD card (such as /run/media/mmcblk0p1/rerac), set that folder first under Settings → Folders, then click Install via ISO and pick your SCUS-97199 .iso.
  4. Gaming Mode on Steam Deck: Right-click rerac-launcher-linux-x86_64.AppImage in Desktop Mode and select Add to Steam (or add the unpacked rerac binary directly with Launch Options set to --data-dir "/home/deck/.local/share/rerac/games/rac1/data", as discussed in Launcher Issue #16). Return to Gaming Mode, set Aspect Ratio to 16:10 in Port Options, and play at 60 FPS.

macOS (Apple Silicon & Intel) setup

  1. Mount the DMG: Download rerac-launcher-macos-arm64.dmg (11.7 MB, for M1/M2/M3/M4 Macs) or rerac-launcher-macos-x64.dmg (12.0 MB, for Intel Macs) and drag ReRAC Launcher to Applications.
  2. Allow first launch in Gatekeeper: Right-click ReRAC Launcher in Finder and choose Open, or open System Settings → Privacy & Security and click Open Anyway.
  3. Add v0.3.9-alpha & extract ISO: Select v0.3.9-alpha or import rerac-0.3.9-macos-arm64.zip via Version Management → Development → Install from zip… (the launcher removes com.apple.quarantine automatically), run Install via ISO, and press Play.

Building ReRAC from Rust source (cargo xtask)

Developers and Intel Mac / Linux builders who want to compile re-rac/rerac directly from source only need a recent stable Rust toolchain via rustup (plus standard X11/Wayland/ALSA/udev development headers on Linux for Bevy):

git clone https://github.com/re-rac/rerac.git
cd rerac
cargo xtask regen-data --iso "/path/to/Ratchet & Clank (USA).iso"
cargo dev

cargo xtask regen-data extracts all 3,072 files into <repo>/extracted/ (the engine’s automatic RC_EXTRACTED fallback when neither --data-dir nor RC_DATA_DIR is passed). Pass runtime switches directly, for example RC_LEVEL=3 RC_ASPECT=fill cargo dev.

ReRAC maps PlayStation 2 face buttons, bumpers, triggers and twin analog sticks by physical position across connected gamepads, with multi-controller detection and Linux 8BitDo mapping fixes in v0.3.8-alpha:

ControllerBest For in ReRACHardware AdvantageLink
Sony DualSenseAuthentic PlayStation button layoutSymmetrical twin sticks matching DualShock 2 muscle memory + crisp D-padView on Amazon
8BitDo Ultimate 2 WirelessLinux, SteamOS & Windows desktopZero-drift TMR sticks, charging dock, verified Linux button mapping in v0.3.8-alphaView on Amazon
GameSir Cyclone 2Precision 3D platforming & strafingTMR sticks, hair-trigger locks for L2/R2 Thruster-Pack strafing, 1000 Hz wirelessView on Amazon
Xbox Wireless ControllerPlug-and-play Windows 10/11Native Windows XInput standard with positional face-button mappingView on Amazon

As an Amazon Associate, this site earns from qualifying purchases.

Macro view of interlocking bronze and steel mechanical gearwheels on a machined frame
Precision mechanical gearwork echoing the OmniWrench and Gadgetron machinery
Metal workshop case holding twin reversible ratcheting socket wrenches and hexagonal steel sockets
Reversible ratcheting socket wrenches and hexagonal bolt drivers
Macro view of a handheld mainboard PCB and multi-core GPU silicon package
Multi-threaded Bevy wgpu renderer over Vulkan, DirectX 12 and Apple Metal

Common questions

Can I delete my 4.4 GB .iso file after Install via ISO finishes?

Once Install via ISO reaches 100% and writes extract-info.json, ReRAC runs entirely from games/rac1/data/ and never reads the ISO during gameplay. However, keep your backup ISO archived on external storage in case a future ReRAC release updates data_format and asks for a Re-extract.

Why did extraction fail with error code 11 or 21?

Code 11 means the file is not a plain ISO9660 .iso (for example, it is compressed as .chd/.cso or dumped as raw 2352-byte .bin sectors). Code 21 means the disc is a different region (such as PAL SCES-50916) or a sequel (Going Commando / Up Your Arsenal).

Can I launch Ratchet & Clank directly without opening the launcher window every time?

Yes. After your ISO is extracted once, run rerac --data-dir "<path-to-rerac>/games/rac1/data" from a desktop shortcut or Steam Non-Steam Game entry (just leave rerac inside its version folder alongside assets/shaders/).