Case study
SwitchWakerHD: a Nintendo Switch port of the Wind Waker HD recompilation
Ports the ZeldaWWHDRecomp static recompilation of The Wind Waker HD to the Nintendo Switch as homebrew, adding a libnx platform layer and a renderer that draws the game’s GX2 graphics with deko3d, with translated shaders compiled on the console by uam. Game code is recompiled locally from the user’s own Wii U dump, so no Switch binaries are released. README reports the game playable handheld and docked at stock clocks, at 26–30 fps in its own measurements, and states that nearly all of the Switch work was written by Claude Code under human direction and hardware testing.
- Targets
- Game
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 247
- Last commit
- 2026-11-09
- Language
- C++
- License (GitHub)
- MPL-2.0
GitHub data as of 2026-11-10
Evidence
- Observed
- Code, documentation and a download method observed; no demo found.
- Checked
- 2026-11-09
Requirements & limits
- Requires the user’s own Wii U dump of the USA or European release, version 0 without the update. Disc extraction needs the disc key and Wii U common key; the runtime checks code/cking.rpx. NRO files and shader caches built from the dump contain game content and must not be shared.
- Builds need Python 3 with pycryptodome and devkitpro/devkita64 in Docker or Podman, or native devkitPro on Windows. The game runs on a Switch with Atmosphère and Homebrew Menu, launched in title mode for sufficient memory. Generated code needs substantial memory per compiled file.
- The project reports handheld and docked play at stock clocks, around 26–30 fps in its measurements, with sound, saves, save states and mods. Testing focused on the opening island, Dragon Roost and surrounding sea; known issues are in docs/switch-port.md. CI tests desktop and Android runtimes with placeholder guest code; the Switch NRO is built and tested on hardware.
- This fork retains ZeldaWWHDRecomp desktop and Android targets while adding a Switch platform layer and renderer. The author reports that Claude Code wrote nearly all Switch work under human direction and hardware testing.
- Code is MPL-2.0. Vendored Cemu, uam, {fmt}, Dear ImGui, xxHash and metal-cpp retain their licenses; game content retains its owner’s rights.
Cite
BibTeX
@misc{switchwakerhd-switch-port-case,
title = {{SwitchWakerHD: a Nintendo Switch port of the Wind Waker HD recompilation}},
howpublished = {\url{https://github.com/centollOS/SwitchWakerHD}},
url = {https://github.com/centollOS/SwitchWakerHD},
urldate = {2026-10-19},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/switchwakerhd-switch-port-case/}}
}Plain text
SwitchWakerHD: a Nintendo Switch port of the Wind Waker HD recompilation. https://github.com/centollOS/SwitchWakerHD (accessed 2026-10-19). Awesome REA entry: https://awesomerea.org/resources/switchwakerhd-switch-port-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · centollOS/SwitchWakerHD · Revision 093c96c
- INSTALL.md GitHub · centollOS/SwitchWakerHD · Revision 093c96c
- docs/switch-port.md GitHub · centollOS/SwitchWakerHD · Revision 093c96c
- THIRD_PARTY.md GitHub · centollOS/SwitchWakerHD · Revision 093c96c
- .gitmodules GitHub · centollOS/SwitchWakerHD · Revision 093c96c
- .github/workflows/release.yml GitHub · centollOS/SwitchWakerHD · Revision 093c96c
- .github/workflows/linux.yml GitHub · centollOS/SwitchWakerHD · Revision 093c96c
- LICENSE GitHub · centollOS/SwitchWakerHD · Revision 093c96c
- https://github.com/centollOS/SwitchWakerHD/releases/tag/v0.4.7
More in Games
- Swordigo Vita: an Android executable port to PS Vita · Case study
- swos-port: a DOS Sensible World of Soccer port with recorded behaviour checks · Case study
- Tactical-Retreat: rebuilding Counter-Strike 1.5 gameplay in QuakeC · Case study
- Test Drive Enhanced: an SDL3 port of the 1987 game · Case study
- Test Drive III Enhanced: an SDL3 port of the reconstructed racing game · Case study
- Test Drive III: The Passion: a reverse-engineered SDL3 port · Case study