rustcube

GAMECUBE WII EMULATOR

rustcube

rustcube — a work-in-progress GameCube emulator written in Rust. The repository is an open-source WIP that aims to run GameCube images and the IPL/BIOS; it includes a basic GTK-based debugger and is built with Cargo.

Jump to download ↓Jump to setup guide ↓

rustcube emulator screenshot.

gamecube wiiPRIMARY SYSTEM

History documentedPROJECT BEGAN

Open sourcePROJECT MODEL

WHY IT MATTERS

Why rustcube exists

rustcube appears to be a personal/independent reimplementation of a GameCube emulator core in Rust. The README describes active development toward booting the GameCube BIOS and provides developer-focused tools (a basic GTK debugger). The project is positioned as a work-in-progress rather than a finished end-user emulator.

BEST FOR

Notable present state

Repository contains an emulator core that can be run from the Rust toolchain and accepts GameCube IPL (BIOS), DOL, ISO and GCM files as input. A GTK-based debugger binary is provided as a separate Cargo package. The project is licensed MIT/Apache-2.0.

Gameplay from Super Mario Sunshine on GameCube.

The people behind rustcube

History & status

The GitHub repository for rustcube shows active development (many commits) but the README explicitly marks it WIP and states "Work is in progress to boot the Gamecube BIOS." The project provides developer build/run instructions rather than packaged releases; the GitHub releases page has no published releases. The repository currently serves as a code-first experimental emulator rather than a polished consumer product.

What rustcube supports

GameCube (targeted)
DOL executables (GameCube homebrew)
ISO and GCM disc images
GameCube IPL (BIOS) as input

Download and availability

OFFICIAL DOWNLOADS

Get rustcube

No official compiled releases are published on the GitHub releases page. Install or run from the repository source using the Rust toolchain (cargo).

Get rustcube ↗

DOCUMENTATION

Official documentation

Read the official configuration, compatibility, and troubleshooting material before changing advanced options.

Read official documentation ↗

Broken or missing download? Emulator projects move and official links sometimes change. Please contact Retro Replay so the source can be verified and updated.

rustcube setup guide

Setup note: This guide explains how to build and run rustcube from source using the Rust toolchain and how to run the included basic debugger. It is based on the project's README and repository contents. If you plan to run commercial games you must obtain any required BIOS or disc images yourself; rustcube does not include firmware or commercial game files.

Prerequisites: Install Rust (rustup and cargo). Ensure you have a compatible rust toolchain (stable or as recommended by the repository). On Linux or macOS you will need development libraries required by any Rust crates the project uses (GTK development packages if you want to use the GTK-based debugger).
Clone the repository: Clone from the project's official repository (msierks/rustcube) and change into the repository directory.
Build and run the emulator (basic): From the repository root, run cargo run — <PathToIPL/DOL/ISO/GCM>. The README documents that rustcube accepts a GameCube IPL (bios) or DOL/ISO/GCM paths as the single command-line argument. Example: cargo run — /path/to/game.iso
Enable debug logging: To enable debug logging set the RUST_LOG environment variable when running cargo. Example: RUST_LOG=debug cargo run — /path/to/file
Run the GTK-based debugger: The repository contains a separate debugger package. Run it with cargo run -p debugger — <PathToIPL/DOL/ISO/GCM>. The README warns the debugger is very much a work-in-progress and may be missing features.
Notes on BIOS / IPL: The README mentions testing with a specific IPL.bin (it includes an SHA-1 in the README). You must supply any BIOS/firmware files yourself; rustcube does not ship or provide commercial firmware or games. The README also indicates the project is still working on fully booting the GameCube BIOS.
Platform specifics and dependencies: The project is built with cargo and thus can target any platform supported by Rust provided the necessary native dependencies are installed. The GTK-based debugger will require GTK development libraries and a working display environment. Because the repository is code-first and lacks packaged binaries, building on Windows, macOS or Linux may require installing system libraries and following platform-specific Rust toolchain setup.
Troubleshooting and development tips: Enable RUST_LOG for more runtime information. Use cargo run from the repository root. Check the repository issues/commits for current problems and recent changes. If you intend to contribute, follow the repository's contribution/license notes (dual-licensed MIT/Apache-2.0).

Software reminder: rustcube is a work-in-progress source project. There are no official releases on the GitHub releases page; build from source with cargo and provide your own BIOS/disc images. Follow the repository for updates and consult its README for exact command syntax.