Skip to content

Releases: odelot/wii-ra-adapter

Release list

v0.0.1 - first public release

v0.0.1 - first public release Latest
Latest

Choose a tag to compare

View all tags
@odelot odelot released this 18 Jul 17:11
v0.0.1
65a395a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

RetroAchievements on original Wii hardware — for both Wii and GameCube games — with no PC, no emulator and no game patching.

This is the first public release of the wii-ra-adapter. The zip bundles everything you need for a working setup: the ESP32-S3 firmware for both supported boards, plus the three console-side programs for your Wii SD card.

What's in the zip

Path What it is
firmware/esp32-s3-devkit/ Firmware for the ESP32-S3 DevKitC (hand-wired build)
firmware/xiao-esp32s3/ Firmware for the Seeed XIAO ESP32S3 (compact PCB build)
sd-card/apps/wiiflow/ WiiFlow Lite build with RetroAchievements support (Wii games)
sd-card/apps/nintendont/ Nintendont build with RetroAchievements support (GameCube games)
sd-card/apps/d2x-cios-installer/ Installer for the d2x cIOS with the ra-module (slots 248–251)

Installing

Follow the step-by-step Getting Started guide in the README. In short:

  1. Build the adapter and flash the firmware for your board with esptool.
  2. On a softmodded Wii, run the bundled d2x cIOS installer (slots 248–251).
  3. Copy the contents of sd-card/ to the root of your Wii SD card (back up your apps folder first — the bundled WiiFlow and Nintendont overwrite existing installs).
  4. Plug the adapter into GameCube memory card Slot B, power it over USB, and configure your Wi-Fi and RetroAchievements credentials through the adapter's setup portal.
  5. Enable RetroAchievements in the WiiFlow / Nintendont settings and play.

What works

  • Achievements for Wii and GameCube games on real hardware, real discs/backups, evaluated in real time
  • On-console game hashing — no game patching, no per-game setup
  • Pointer-chain achievements, resolved console-side every frame
  • Unlock feedback: on-screen trophy indicator and disc-slot LED blink
  • Live web dashboard at http://wii-ra.local/ — achievement list with live progress, unlock toasts and rich presence

Notes for this release

  • This is an early release — expect rough edges, and please report anything odd.
  • Requires an original Wii (RVL-001) — the model with GameCube ports. Wii Family Edition and Wii mini have no memory card slots.
  • The d2x cIOS installs into slots 248–251 and overwrites whatever is there; the bundled WiiFlow expects exactly these slots.
  • For Wii games, scrubbed WBFS images hash incorrectly — use accurate (unscrubbed) dumps.
  • A 2.4 GHz Wi-Fi network is required (the ESP32 does not support 5 GHz-only networks).

Questions, problems, bugs?

Open an issue or join the community on Discord.

Credits

Built on RetroAchievements / rcheevos, and on the d2x cIOS, WiiFlow Lite and Nintendont projects — see the README for full credits. Console-side sources: d2x-cios · WiiFlow_Lite · Nintendont.

Assets 3
Loading