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

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-10-19
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/centollOS/SwitchWakerHD>
- Primary source: <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/README.md>
- Catalog page: <https://awesomerea.org/resources/switchwakerhd-switch-port-case/>
- Record JSON: <https://awesomerea.org/resources/switchwakerhd-switch-port-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/switchwakerhd-switch-port-case/index.md)

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

## Primary sources

1. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/README.md>
2. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/INSTALL.md>
3. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/docs/switch-port.md>
4. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/THIRD_PARTY.md>
5. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/.gitmodules>
6. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/.github/workflows/release.yml>
7. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/.github/workflows/linux.yml>
8. <https://github.com/centollOS/SwitchWakerHD/blob/093c96cf590d23b07472e3cf2aa66f9a7a32cd4e/LICENSE>
9. <https://github.com/centollOS/SwitchWakerHD/releases/tag/v0.4.7>

## More in Games

- [Swordigo Vita: an Android executable port to PS Vita](https://awesomerea.org/resources/swordigo-vita-case/index.md) · Case study
- [swos-port: a DOS Sensible World of Soccer port with recorded behaviour checks](https://awesomerea.org/resources/swos-port-case/index.md) · Case study
- [Tactical-Retreat: rebuilding Counter-Strike 1.5 gameplay in QuakeC](https://awesomerea.org/resources/tactical-retreat-case/index.md) · Case study
- [Test Drive Enhanced: an SDL3 port of the 1987 game](https://awesomerea.org/resources/test-drive-enhanced-case/index.md) · Case study
- [Test Drive III Enhanced: an SDL3 port of the reconstructed racing game](https://awesomerea.org/resources/test-drive-iii-enhanced-case/index.md) · Case study
- [Test Drive III: The Passion: a reverse-engineered SDL3 port](https://awesomerea.org/resources/test-drive-iii-sdl3-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.
