百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
G

gecko

> 编程语言
开源

一个使用 Rust 编写的 GameCube/Wii 模拟器和调试器。

324 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

一个使用 Rust 编写的 GameCube/Wii 模拟器和调试器。

Status

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:

  • GameCube
  • Wii

[!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!

Features

Gecko is developed with homebrew development and reverse engineering in mind, but also aims to provide a faithful and playable experience!

  • Cross-platform: Windows, Linux and macOS
    • x86 and ARM supported on each platform
    • More platforms supported if compiling yourself
  • Cranelift based JITs
    • PowerPC, DSP, vertex decoder
  • Upscaling 1x - 4x
  • Controller support
    • Xbox, Steam, etc.
    • PS5 DualSense Wiimote motion control
  • Starlet HLE
  • IPL skip patches for NTSC and PAL
  • wgpu based renderer backend
    • Supports all major platforms
  • wesl based specialized shader compiler
  • JIT and shader cache
  • FIFO recorder, player and debugger
    • Compatible with Dolphin
  • GameCube memory cards
  • Savestates
  • Frame pacing
  • Modular audio backend, defaults to cpal
    • Supports mixing audio sinks
    • Supports dumping to .wav files
  • MCP server
  • Lua scripting system for runtime introspection
  • A beautiful yet advanced egui-based debugging UI
  • Experimental freecam in the debugger
  • Symbol parsing from ELFs and IDA Pro databases
  • IDA Pro loaders for DOL and Apploader
  • RenderDoc captures with all sorts of debug markers
  • ISO and RVZ support
    • Supports either compressed as ZIP
  • Included multitool, supports:
    • IPL decode/encode
    • SYSCONF decode/encode
    • setting.txt decode/encode
    • DVD filesystem extraction
    • Disassembler for PPC and DSP
  • Various built-in diagnostics for JIT and GX
  • Support for web browser
    • incl. debugging capabilities

Usage

Prebuilt 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:

bash
# 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.rvz

A 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:

…

Controls

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-devices package (or an equivalent udev rule for 054c:0ce6) and replug the controller. Without it the pad still works, but falls back to buttons and sticks only.

Default gamepad bindings

GameCube

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

Wii

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

GameCube

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

Wii

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

Savestates

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 .

Freecam (experimental)

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.

Required files

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

GameCube

  • IPL (NTSC and PAL tested)
  • DSP IROM
  • DSP coefficient ROM

If you only have an encoded IPL, decode it first with multitool:

bash
multitool ipl --action decode private/IPL.bin private/IPL.decoded.bin

Wii

A NAND is generated on boot whenever fs/ is missing. The folder can be overriden using the GECKO_FS_ROOT environment variable.

bash
# optional!
GECKO_FS_ROOT=/path/to/dolphin-nand tinyapp --dvd wii_game.rvz # ... and other arguments

Examples

Examples you might find useful:

…

The CLI options are largely the same across the sub pro

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rustemulationemulatorgamecubewii

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言