一个使用 Rust 编写的 GameCube/Wii 模拟器和调试器。
Gecko is still in development. While many games work well, most will likely have varying degrees of visual glitches or will be outright broken. Refer to the screenshot databases to gauge compatiblity:
[!NOTE] Not all games are tracked. The screenshot service makes a best effort attempt to enter games by pressing random buttons. Just because a game doesn't go ingame, doesn't mean it actually doesn't.
Gecko now also has a community driven compatibility database! Feel free to leave a vote when trying out games. The database is still new, so please take the ratings with a grain of salt!
Gecko is developed with homebrew development and reverse engineering in mind, but also aims to provide a faithful and playable experience!
wgpu based renderer backendwesl based specialized shader compilercpalPrebuilt releases (including debug builds) can be downloaded here. GameCube and Wii require system files to use the emulator, please refer to the "Required Files" chapter. Minimal commands to launch a game:
# Launch a GameCube game
./tinyapp --ipl IPL.decoded.bin --dsp dsp_rom.bin --coef dsp_coef.bin --skip-ipl --dvd YourGame.rvz
# Launch a Wii game
./tinyapp --dsp dsp_rom.bin --coef dsp_coef.bin --dvd YourGame.rvzA more modern and friendly experience is provided via gecko (short preview on YouTube):
It scans the configured GameCube and Wii folders for .iso, .rvz and .zip files. Double-clicking on a row opens a dedicated player window for that game. The decoded GameCube IPL and DSP files are expected to be inside the system folder and must be named exactly as follows:
…Gamepads are supported on all frontends through SDL3. Xbox, DualSense (PS5) and anything else SDL recognizes works out of the box. Keyboard and mouse stay active.
On Wii, the pointer source is picked automatically based on what the connected gamepad can do: gyro aiming on a DualSense (press R3 to recenter), right stick otherwise, mouse as the fallback. The DualSense touchpad can also act as an pointer. Its accelerometer drives Wiimote motion directly, so physically shaking the controller shakes the Wiimote. Pads without motion sensors use R1 as a shake button instead. The right stick doubles as the Wiimote D-pad whenever it is not serving as the pointer, and game rumble is forwarded to the controller on both GameCube and Wii.
Bindings, pointer source, sensitivity and axis inversion are configurable in gecko under Settings > Controller Bindings, persisted in the [input] section of config.toml (see other/example.conf for every option). tinyapp uses the default bindings and points with the mouse. Pass --pointer gyro|stick|touchpad|auto to override.
Keyboard and player-window hotkeys are configurable the same way under Settings > Keyboard Bindings, persisted in the [keyboard] section of config.toml. The keyboard and hotkey tables below are the defaults.
[!NOTE] DualSense motion sensors and rumble on Linux require hidraw permissions. Install the
steam-devicespackage (or an equivalent udev rule for054c:0ce6) and replug the controller. Without it the pad still works, but falls back to buttons and sticks only.
Default gamepad bindings
| Gamepad | Action |
|---|---|
| Left stick | Main stick |
| Right stick | C-stick |
| D-pad | D-pad |
South |
A |
West |
B |
East |
X |
North |
Y |
Start |
Start |
L2 R2 |
L / R (analog) |
R1 |
Z |
| Gamepad | Action |
|---|---|
| Gyro | IR pointer (if available) |
| Right stick | IR pointer or D-pad |
| Left stick | Nunchuk stick |
| D-pad | D-pad |
South |
A |
R2 |
B |
West |
1 |
North |
2 |
Start |
Plus |
Select |
Minus |
Guide |
Home |
L1 |
Nunchuk C |
L2 |
Nunchuk Z |
R1 |
Shake (pads without sensors) |
R3 |
Recenter pointer |
Hotkeys
tinyapp and debugger:
| Key | Action |
|---|---|
Space |
Start emulation from the splash screen (--wait flag) |
F5 |
Save state (overwrites the game's existing state) |
F7 |
Load state |
F10 |
Trigger a RenderDoc capture (requires renderdoc-capture feature) |
F11 |
Screenshot the full window |
F12 |
Screenshot the emulated framebuffer only |
gecko player window:
| Key | Action |
|---|---|
Space |
Pause / resume emulation |
Tab |
Toggle the speed limit (run uncapped) |
F5 |
Save state (overwrites the game's existing state) |
F7 |
Load state |
F10 |
Toggle borderless fullscreen |
F11 |
Toggle the FPS and emulation speed overlay |
F12 |
Screenshot the emulated framebuffer to /screenshots/ |
Keyboard bindings
| Key | Action |
|---|---|
| Arrow keys | Main stick |
I K J L |
D-pad (up/down/left/right) |
X |
A |
Z |
B |
C |
X |
V |
Y |
Enter |
Start |
A |
L |
S |
R |
D |
Z |
Wiimote:
| Input | Action |
|---|---|
| Mouse movement | IR pointer |
| Left mouse | A |
| Right mouse | B |
| Arrow keys | D-pad |
1 |
1 |
2 |
2 |
Home |
Home |
- |
Minus |
= |
Plus |
Left Shift |
Shake (motion) |
Nunchuk:
| Key | Action |
|---|---|
W S A D |
Analog stick |
Q |
Z |
E |
C |
tinyapp, debugger and the gecko player support saving and loading GameCube and Wii emulation state with F5 and F7. The debugger also provides Save State and Load State menu actions. In gecko, these hotkeys are configurable under Settings > Keyboard Bindings; requests made while paused are processed after emulation resumes.
Each game has one state slot at /cache//state.gkst; saving again overwrites it. The data directory defaults to the executable's directory and can be overridden with GECKO_DATA_DIR. Sessions without a game ID use cache/default/state.gkst.
tinyapp and debugger can also load a state immediately after boot with --load-state .
In debugger, open Windows > GX, expand Freecam and enable Unlock camera. Freecam controls are not exposed in tinyapp or the gecko player.
| Input | Action |
|---|---|
| Hold right mouse button and move | Look around |
W A S D |
Move forward, left, backward and right |
Q / E |
Move down / up |
Shift |
Move 5x faster |
| Mouse wheel | Adjust movement speed |
The panel also provides a speed slider and Reset view button. Game input is suspended while freecam is enabled; disable Unlock camera to return to normal controls.
Gecko does not ship any system files.
Reference SHA-256 hashes (these are the files the project is developed against):
| File | SHA-256 |
|---|---|
IPL.bin (NTSC, encoded) |
7228bd8f0171008e71c48788eef5e0fd5abce8ef85f1d00327c6f3368113d2a5 |
IPL.decoded.bin (NTSC) |
31e9aa82d972a423d9b7ea7bdbdcff0aff86c3ed953600ca841fe24f3f577051 |
PAL_IPL.bin (PAL, encoded) |
a5fd3ab0ed3d63ad365990cbf522f9f175e01d3b37e5f30a8e5a103cbbc749fd |
PAL_IPL.decoded.bin (PAL) |
011b66ce68d8dcb4f37460fcb322215bcda7df79072aeca22fdc690499deabac |
dsp_rom.bin |
49d987ee1eab29a157425b82d54516957a81e1bac247c8834e494642605c3e8c |
dsp_coef.bin |
d7741279c2e8ec5c5fb318f8fbdd6de6bf583520d288e836a5383233a4238179 |
If you only have an encoded IPL, decode it first with multitool:
multitool ipl --action decode private/IPL.bin private/IPL.decoded.binA NAND is generated on boot whenever fs/ is missing. The folder can be overriden using the GECKO_FS_ROOT environment variable.
# optional!
GECKO_FS_ROOT=/path/to/dolphin-nand tinyapp --dvd wii_game.rvz # ... and other argumentsExamples you might find useful:
…The CLI options are largely the same across the sub pro
暂无开放 Issues,或尚未同步最近议题。