Repository navigation
SwitchWakerHD 0.3.0
Pre-releaseSwitchWakerHD runs The Wind Waker HD (Wii U, title 00050000-10143500, USA, version 0) natively on a Switch with custom firmware: the game's code is statically recompiled to C and drawn with deko3d. No emulation.
No game inside, no binaries. Every build carries the game's code recompiled from your own dump, so you build it on your computer with one script and copy the result to your SD card. Do not share what you build.
Install
- Download
SwitchWakerHD-v0.3.0.zipbelow and unzip it. - Follow INSTALL.md: with Docker and Python installed, one command builds everything from your dump:
python3 tools/switch/make_sd.py --image game.wux # or --game-dir <extracted game> - Copy
build/sd/to the root of the SD card and start the Homebrew Menu in title mode (hold R while starting any game).
Updating from 0.2.0: build the same way and copy wwhd.nro over the old one. Saves, settings.ini and the compiled graphics stay. An old env.txt is converted into settings.ini on the first start and renamed env.txt.old.
What's new since v0.2.0
Faster, fewer stutters
- The opening island's heaviest view went from 22 to about 29 fps at stock clocks: the renderer's per-draw work dropped by about a fifth.
- Shader variants seen in an earlier session come from a new cache file (
shadercache_dk_translations.bin): effects that stuttered every session now do so only the first time. New textures unpack about three times faster.
New
- Save states work on the console: five slots in the Saves tab (upstream's portable save states: your progress and Link's place, boat included).
- Rumble on the Joy-Con and the Pro Controller (Switch tab → Rumble).
- Gyro aiming in Pro Controller mode too (the default), lower default sensitivity, turning-axis choice and Recalibrate.
- 16x anisotropic filtering (Switch tab → Picture, off by default).
- Every option now lives in the menu (
settings.ini);env.txtis gone.
Fixed
- Black letters in the Rito post office's sorting game (now playable).
- A crash with quick doors in Tingle's jail on Windfall (upstream #61).
- A possible hang where one game thread waits for another (upstream #62).
Defaults
- The console runs at stock clocks by default (CPU 1020 MHz, stock GPU). The busiest scenes (sailing near Dragon Roost, the volcano island) run at 26–29 fps there; the CPU's 1224 MHz step is marked Recommended in the Switch tab and holds a steady 30 fps. A clock you already saved in the menu is kept.
Also
- Upstream ZeldaWWHDRecomp v0.2.7–v0.2.8 merged (fan translations as content mods, including right-to-left scripts).
- One log per session in
logs/(the 10 most recent kept). - A network debug server for developers, off by default (Switch tab → Debug).
Known limits
- The first visit to a place compiles its graphics in the background: an object may appear a moment late, once per console.
- A picture-in-picture GamePad screen (in a corner) is planned.
Credits, licenses and how AI was used: see the README. Built on ZeldaWWHDRecomp by Lukas S and its contributors. License: MPL-2.0.