Zelda : The Wind Waker HD Recompiled
Recompilation du Zelda : The Wind Waker HD (Wii U), avec un binaire macOS Apple Silicon.
ZeldaWWHDRecomp reconvertit The Legend of Zelda : The Wind Waker HD, la version Wii U, en exécutable natif. Les archives macOS ARM64 sont publiées à côté des builds Windows, Linux et Android.
Jeux contenus
Les jeux que ce logiciel fait tourner.
The Legend of Zelda : The Wind Waker HD
The Legend of Zelda : The Wind Waker HD est le jeu d’origine du portage Zelda : The Wind Waker HD Recompiled pour macOS.
Architecture
Mac OS X - macOS
Apple Silicon
Téléchargement et liens
- Télécharger Zelda : The Wind Waker HD Recompiled
- Code source 1 590 étoiles sur GitHub
- Licence : MPL-2.0
Historique des versions
0.5.1
- Randomisation intégrée : ajout d’un générateur de graines (TWWHD Randomizer 1.2.0) dans les paramètres, avec import depuis des seeds existants, support des options avancées (comme le shuffle des entrées) et sauvegardes isolées pour les jeux randomisés.
- Modèles de joueurs GameCube : import de packs de modèles GameCube (fichier Link.arc) pour personnaliser l’apparence de Link en haute définition, appliqué dynamiquement sans redémarrage.
- Mods intégrés : ajout des Achievements (99 objectifs, affichage via une fanfare) et du suivi de progression (checklist, carte des trésors, pourcentage), désactivés par défaut.
- Correction macOS : prise en charge des Steam Controllers lancés via Steam et du rumble des manettes compatibles (DualSense, etc.), nécessitant un redémarrage après mise à jour.
- Correction macOS : avertissement explicite pour macOS 14 (nécessité de clic droit > Ouvrir) et rappel de ne pas déplacer l’application hors de son dossier d’origine.
- Correction générale : suppression d’un shader crashant le GPU (macOS, Linux, Android) lors du démarrage, avec tentative de réactivation après une mise à jour.
The Wind Waker HD, native PC port, v0.5.1
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows:
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway");windows-x86_64for x86-64,windows-arm64for Windows on ARM (Snapdragon X) - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file:chmod +xthe.AppImageand start it from anywhere (Steam Deck included); its game, code, saves and settings go to~/.local/share/wwhdand~/.config/wwhdinstead of beside it (Ubuntu 24.04+:libfuse2t64, or--appimage-extract-and-run) - Android (arm64, Android 13+, Vulkan 1.3): install the
android-arm64.apk(android-x86_64is for emulators and Chromebooks), choose your game in the app, and it builds the game on the phone (once, a few minutes). Signing certificate SHA-256:7F:F6:D3:5E:4E:45:11:5E:E4:93:65:EF:5B:40:C0:EB:83:EA:F7:6C:C1:1C:E9:67:F2:64:5C:50:4F:58:B2:13
See "Install (releases)" in the README for details.
What's new
Thanks
Thanks to everyone who sent code for this release:
- @itsarahtonin: change Link's name mid-game (#343), sharp settings text at 4K (#345),
%refused in new-game names (#351), the GameCube adapter on Windows (#357), and two test fixes (#403, #404) - @GenissonEmilio: Android touch on the title screen, file select and name entry (#340), safer save import (#339), touch controls on the Poco M8 Pro (#338)
- @davidsgullick: controller rumble (#347) and Steam Controllers (#348) on macOS
- @mkopec: HDR metadata (#337) and the Mali (panvk) sky fix (#317)
- @rhemfur: keep your save in a cloud folder (#238)
- @RaphaelFakhri: Linux launchers for folders with special characters (#377)
- @DaniXK-96: a Vulkan colour-target fix (#399)
- @francosang: the HD minimap's SDK proposal (ZeldaWWHDMods #33), used for #434
Many features in this release come from two Android forks of the port, with their authors' code or ideas:
- @GreenNaugahyde's Android fork (GreenNaugahyde/ZeldaWWHDRecompAndroid): the in-app randomizer, GameCube player models, Achievements, Game progress, Walk-through doors, 16-character names, Instant text, Deku Leaf wave to rise, touch button pictures, menu sounds, controller dialogs, frame generation and several Android memory and driver fixes
- @Nycolazs' Android fork (Nycolazs/WindWakerHD-Android-Plus): frame generation, the Turnip, Huawei, storm-picture, Shop Ship, texture-memory and low-memory fixes
And thanks for reports, ideas and testing: @aaronlink127, @AnythingVocaloid, @alexander-beepx, @andreasbertram5-alt, @Eggtooth, @findel77, @Froggjarl, @jamesmendel, @KaitoCrisHub, @MattPlays02, @plxjammerplx, @Sherisherisherisheri, @SpicyAwesomeSauce and @thejorro.
New
- Randomizer built in (#430, #431, #390, #366, #408, #396, #433, #435, for #117, the in-app approach from the GreenNaugahyde
Android fork, thanks @GreenNaugahyde; randomizer: TWWHD Randomizer 1.2.0, MIT). Setup's Randomized games page
makes a seed from a preset, a seed name or a permalink, checks it against the port and builds it. A game made with
the official TWWHD Randomizer is added with Import seed… on the same page (or
setup --import-seed PATH). Every option of 1.2.0 is accepted, including Quiet Swift Sail and entrance shuffle (thanks @KaitoCrisHub for the report, #383); seeds from 1.1.1 and older are refused. In the game, Settings › Randomizer shows the seed, its permalink and (after a question) the spoiler log with a sea-chart map. Works for USA and European games and on Android. Every randomized game has its own saves, backups and save states; your normal save is never touched. Choose your game andsetup --game-dirno longer accept a randomized game folder: install the game as it is, then import the seed. Randomized games installed the old way keep updating and keep their saves. - GameCube player models (#432, from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Mods › Install
from a file takes a GameCube model pack you have (a folder or zip with
Link.arc). The port converts it on your device onto HD Link's skeleton, materials and animations, with textures upscaled to HD's sizes. On the model's page in the Mods tab you choose it per save file; the choice applies live, no restart. No model packs ship with the port. - New built-in mod: Achievements (#410, goals, texts and points from the GreenNaugahyde Android fork, thanks
@GreenNaugahyde). Off by default (Mods › Built-in). 99 goals read from your save data, earned for good, for all
save files together and for each one; the record is kept in
achievements.jsonin the port's config folder, never in the save. When you earn one, Link turns round and holds it up with the game's item fanfare (its volume is an option). Cheats pause achievements while they're used, unless you turn on Earn with cheats; loading a save state never takes one back. Pages on the item menu's settings page (Game tab) and in the Esc settings. - New built-in mod: Game progress (#409, idea, count and places from the GreenNaugahyde Android fork, thanks @GreenNaugahyde; chart numbers from TWWHD Randomizer). Off by default (Mods › Built-in). Shows how much of the game your save file has found: a percent, a checklist in ten parts (dungeons, hearts, items, equipment, upgrades, songs, pearls and Triforce, charts, the sea chart, the Nintendo Gallery) and a sea-chart map of where each thing is found. An option shows the percent on screen. Two places (Crescent Moon Island's sunken treasure, Triforce Chart 2) are still to be checked in the game.
- 60 fps (generated), experimental (#425, from the GreenNaugahyde and Nycolazs Android forks, thanks @GreenNaugahyde and @Nycolazs). On Vulkan, Graphics › Frame rate › 60 fps (generated, experimental) keeps the game at 30 fps and generates every other frame on the GPU from the last real one (camera and object movement, with the HUD kept exact). Off by default; not yet checked on a phone. Not available on Metal (on a Mac, use the Vulkan renderer).
- Keep your save in a cloud folder (#238, for #190, thanks @rhemfur). Settings → Saves → Save folder (Windows, macOS, Linux) puts your save in a folder you choose, for example in OneDrive, Dropbox, iCloud Drive or Google Drive, so it stays the same on all your computers. The save only replaces the real one once it is fully on disk, a lock warns when the folder is in use on another computer, and cloud conflict copies are offered at the next start. Nothing is replaced or removed without a backup first and without your answer. See the README section "Optional: keep your save in a cloud folder".
- Change Link's name mid-game, up to 16 characters (#343, for #328, thanks @itsarahtonin; #428, idea from the
GreenNaugahyde Android fork, thanks @GreenNaugahyde). The settings page in the pause menu (Game tab) and the
Settings window's Saves tab can rename Link on the save file being played; the new name shows right away and is
kept with your next save. Names can now have up to 16 characters: the game's texts use the whole name, the file
select shows the first 8. The whole name travels with the save (backups, exports, randomizer saves).
%and characters the game's font can't show are refused. - Quick doors: new "Walk through" mode (#426, from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Quick doors is now Off, Faster or Walk through. With Walk through, dungeon shutters and house doors open as Link walks up, he walks through without the door scene and the door shuts behind him. Locked doors, boss doors and doors with bars keep their scene, sped up as with Faster. Walk-through doors open with A makes them wait for A. The game code is rebuilt once after the update.
- Instant text and No pauses in texts (#411, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Two new switches under Settings › Game, both off by default: message boxes show their whole text at once (each box still waits for A), and the short waits written into some texts are left out.
- Deku Leaf: wave to rise (#412, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). A new built-in option next to Jump anywhere, off by default: while gliding, each wave of the Deku Leaf lifts Link a little, and holding the button keeps waving. The height of one wave is 50–200 %; the glide still uses magic.
- GameCube controllers and button prompts (#301, thanks @MattPlays02 for the idea; #374, for #355; #392, for #356, thanks @itsarahtonin for the report). Choose GameCube in Controls, or let Automatic pick it for a GameCube pad: A acts, B is the sword, X, Y and Z use the item slots, L targets and R shields (from a quarter of their travel or at the click), the C-stick turns the camera and a tap of Start opens the menus. A recognized GameCube controller gets this layout right away. GameCube button prompts show the GameCube's own buttons in the HUD, item menu and dialogue: the big green A, the red B, the kidney-shaped X and Y, the purple Z and the shoulder plates. Each controller can keep its own layout, and Restore previous controller bindings brings back the old buttons. Details in docs/gamecube-controller.md.
- Keyboard and mouse button prompts (#364, for #265, thanks @Eggtooth for the idea). Choose Keyboard / mouse under Controls › Button prompts and the game's prompts show the key or mouse button you bound (for example Tab, M1, LShift, Wh+), drawn in the game's own font. The camera mods (mouse camera, direct camera, first person) moved from Mods › Built-in to Controls, with their settings unchanged.
- Aim the boat cannon with the mouse (#360, for #332, thanks @AnythingVocaloid for the idea). With Mouse camera on and the pointer captured, moving the mouse aims the cannon on the King of Red Lions.
- Targeting letterbox: On / Off with enemies / Always off (#395, for #114, thanks @andreasbertram5-alt for the request). The bars that appear while holding target can be kept, hidden only when an enemy is targeted, or hidden always (also for free targeting). Cutscene, event and minigame bars stay.
- A 4:3 aspect-ratio preset (#359). Settings › Graphics (and the macOS Graphics menu) offer 4:3 next to the
widescreen presets.
WWHD_ASPECT=4:3selects it too. - Story-item cheats (#362, for #289). Mods › More › Cheats › Story items can grant Nayru's, Din's or Farore's Pearl, or the fully powered Master Sword. The first use each session asks for confirmation, because it can change the story's order, and a backup of your save is made first.
- HDR: metadata, darker shadows and a choice of format (#337, thanks @mkopec, and @findel77 for testing; #333, thanks @findel77). With HDR on, the game tells the display its brightness range, so HDR TVs and monitors tone-map it correctly (Auto Peak, on by default, reads the display's peak). The picture is turned into HDR with a gamma 2.2 curve, so shadows no longer look washed out; SDR curve in HDR offers Gamma 2.2 (default), Gamma 2.4 or sRGB (the previous look). HDR format picks Auto, scRGB or HDR10 (PQ). See docs/hdr.md.
- Settings plays the game's menu sounds. Moving, choosing, switching tabs and opening or closing Settings play the game's own menu sounds. Settings → Audio → Menu sounds (on by default). Idea from GreenNaugahyde's Android fork, thanks @GreenNaugahyde.
- GamePad screen: bars filled with the menu background (#397). Where the GamePad picture doesn't fill the screen (the Thor's second screen, phones in GamePad-only mode, the GamePad window), the bars around it show the menu's own background instead of black. On by default; Settings → Display → Fill GamePad bars with background.
Improved
- 60 fps frame interpolation plays exactly like 30 fps (#436). Before, some characters behaved differently at 60 or 120 fps and random events drifted from what the game does at 30 fps (on Outset the grass cutter stopped cutting, and from then on enemy behaviour and drops differed). The picture still gets its in-between frames; the game logic behind them is now the same as at 30 fps.
- True 60 is retired (#407). The experimental "True 60" frame rate (Link and the camera at 60 game steps a second) was broken in many places and is gone; key 7 does nothing now. If you had True 60 selected, the game starts with 60 fps frame interpolation instead. Nothing to do on your side.
- Touch controls: Link in the button pictures, a boat item ring and more taps (#427, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Action buttons show a small picture of Link in that action's pose (jump, sword, crouch, roll, lift, talk, defend, grab, throw, the rope, Cruise and more) with the game's word under him, drawn from your own game files (Settings → Display → Touch controls → Link in the button pictures, on by default). On the boat, the item ring only shows items you can use there. Letters, stone tablets and signs move on with a tap, and after a game over you can tap Continue or Quit. The Classic style always shows every button. Not yet checked on a phone; reports welcome.
- Settings dialogs with a controller (#413, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Dialogs open with their default button selected (Cancel where the action can't be undone), the selection shows again when the controller takes over from the mouse, the right stick scrolls long dialog text, and a button still held while the menu opens presses nothing.
- The Controls settings are split into pages (#371). Settings › Controls has five tabs: Bindings, Controller, Prompts, Camera and Gameplay. Every setting keeps its value; only its place changed.
- The settings page in the pause menu no longer takes Left from the game. Left goes to the game's item slots first; only where the game has nothing further left does the cursor move onto the page arrow (A or Left again opens the page). ZL no longer opens it, and Settings page in the pause menu in Controls turns the arrow off. The arrow's design follows the GreenNaugahyde Android fork (thanks @GreenNaugahyde).
- Picture scaling: Sharp is pixel perfect (#414, idea from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). The settings now say that Sharp shows each rendered pixel as a crisp block. Only the wording changed.
- Windows setup: compiler unpacking shows progress (#394, for #388, thanks @Sherisherisherisheri for the report). Setup shows how many files are unpacked instead of sitting silent for minutes, and if unpacking fails it says why (most often an antivirus program or a full disk) and what to do next.
Fixed
- Picto Box at wide and tall screens (#303, thanks @aaronlink127). Wider than 16:9 or taller (16:10, 4:3, phones), the Picto Box now takes the same 16:9 picture as on the Wii U, and its subject check only counts what is inside that frame. Normal play keeps your full view.
- Leaving Beedle's Shop Ship could stop the game (#416, from the Nycolazs and GreenNaugahyde Android forks, thanks @Nycolazs and @GreenNaugahyde).
- The 3D picture could go black for some frames in a storm (#417, from the Nycolazs and GreenNaugahyde Android forks, thanks @Nycolazs and @GreenNaugahyde). Some GPUs (seen on Adreno 650 phones) produced invalid pixel values near lightning at night, which bloom spread over the whole screen. Shaders are compiled once more after this update.
- A shader that crashes the GPU driver no longer stops the game from starting (#418, from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). The next start leaves that one shader out and logs it; it's tried again after a driver, GPU or port update (Linux, macOS and Android).
- Loading a portable state made while crawling (#365, for #361, thanks @thejorro for the report and the state). Link arrives still crawling instead of standing inside the tunnel's ceiling.
- Controller dead after switching it in a menu (for #330, thanks @itsarahtonin). Switching Keyboard and controllers act as while the pause menu or file select was open no longer leaves the game ignoring every button.
- The rupee sparkle fades out with the rupee counter (#358, for #353, thanks @thejorro for the report).
- Match window keeps exact preset ratios (#372, for #349, thanks @plxjammerplx for the report). A window shaped exactly like a preset (for example 1280×960) uses that preset's exact ratio instead of a rounded one.
- Long help lines no longer make the settings page flicker at high resolutions (#345, thanks @itsarahtonin).
- The new-game name screen refuses
%(#351, thanks @itsarahtonin), which the game reads as a format code. - Start-up audio waits like on the console. At boot the game now waits for its audio threads to finish setting up, as the Wii U does, so the sound system is always ready before the game first uses it.
- Windows: a damaged native mod no longer freezes startup (#437). It now fails with an error instead of waiting on a hidden Windows error box.
- Windows: the Wii U GameCube adapter works (#357, for #354, thanks @itsarahtonin). Install the WinUSB driver for it with Zadig (the same driver Dolphin uses); see the GameCube controller guide.
- macOS: Steam Controllers launched through Steam (#348, for #342, thanks @davidsgullick for the change and @jamesmendel for testing every step on real hardware). The macOS app reads Steam Input's virtual pad, so a Steam Controller started from Steam works and is found again after a reconnect.
- macOS: controller rumble (#347, for #346, thanks @davidsgullick). Any pad macOS reports haptics for rumbles, for example a DualSense.
- Linux: NVIDIA on Wayland closing the game (#309, thanks @Froggjarl). The game turns on NVIDIA's older sync
method on Wayland by itself (
__NV_DISABLE_EXPLICIT_SYNC=1, driver 575 or newer); a value you set yourself is kept. If it still closes,SDL_VIDEO_DRIVER=x11runs the game through XWayland. - Linux on Mali (panvk): one colour over the whole picture at sea (#317, follow-up to #310, thanks @mkopec).
v0.5.0's fix for the flickering sky could turn the picture one solid colour near Outset. On panvk, draws that don't
write depth now clip in their shaders, as the Wii U does.
WWHD_VK_CLIP_EMULATION=0turns it off. Details in docs/vulkan.md. - Linux: launchers for data folders with special characters (#377, for #376, thanks @RaphaelFakhri for the
report and the fix). A folder name with
$,`,",\or%(for exampleGames 100%) no longer breaksplay.shor the menu entry. - Vulkan: continued draws pick the right colour targets after a scissor change (#399, thanks @DaniXK-96). A correctness fix; no known visible glitch.
Android
- Fixed: Android running at about half speed since v0.5.0 (thanks @SpicyAwesomeSauce, #334). From the second
launch on, Snapdragon phones ran much slower (Windfall at 40 fps ran at about 22 fps). It holds 40 fps again, with
no extra stutter when new areas load.
WWHD_VK_PIPELINE_WARMUP=0is no longer needed. - Tap the title screen to start, and touch on file select and name entry (#340, thanks @GenissonEmilio). Your touches reach the game's own GamePad touchscreen on those screens; with no second display, the GamePad picture shows on the main screen there and your view comes back afterwards.
- Safer save import (#339, thanks @GenissonEmilio; #382). An imported save is checked completely before it replaces yours, and your previous save is kept as a backup. An interrupted import brings your old save back, oversized or damaged archives are refused, and a second import or export can't start while one is running.
- Touch controls stay visible on the Poco M8 Pro (#338, thanks @GenissonEmilio). The phone's built-in key injector no longer counts as a controller.
- Turnip on Adreno 6xx GPUs runs without UBWC (#420, from the Nycolazs and GreenNaugahyde Android forks, thanks
@Nycolazs and @GreenNaugahyde). With a custom Turnip driver, Adreno 6xx phones (seen on a Galaxy S20 FE) could
restart at the first frame above 1x resolution; now 1.5x runs too. A
TU_DEBUGyou set yourself still wins. - BC textures decoded on the CPU on Huawei GPUs (#419, from the GreenNaugahyde and Nycolazs Android forks, thanks @GreenNaugahyde and @Nycolazs). Huawei's Maleoon driver crashed compiling the texture decoder shader.
- Textures that haven't been used for a while are freed (#423, from the GreenNaugahyde and Nycolazs Android
forks, thanks @GreenNaugahyde and @Nycolazs). Textures not drawn for about four minutes are released (sooner when
memory is tight), so long sessions use less memory.
WWHD_VK_TEXTURE_BUDGET=0turns it off. Not yet measured on a phone. - Dynamic resolution also steps down when memory runs low (#422, from the GreenNaugahyde and Nycolazs Android forks, thanks @GreenNaugahyde and @Nycolazs). On devices with less than 3.8 GB of RAM it starts at 1× at most.
- No save state when memory is about to run out (#421, from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Such a save is refused with "not saved (too little free memory, close other apps)", instead of Android closing the game in the middle of it.
- Share log can include your save files (#415, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). A new checkbox, off at every start, adds your save file and Picto Box photos for bug reports. Every name in the save becomes "Link" first. Not yet tested on a phone.
- Fixed: code mods "not available" in Android development builds (mods issue #6, thanks @alexander-beepx). Releases weren't affected.
Mods and mod SDK
- Profile mods get their own saves (#385). A mod can declare its own save profile; its saves, backups, settings and save states are then kept apart from your normal game, so a profile mod can't overwrite an ordinary save. Turning the mod off (or Switch all mods off) takes effect on the next launch, which also gives Android players a way back to the normal game without reinstalling.
- Fixed: Story Notebook leaving the menu broken (mods issue #9, thanks @francosang). After the notebook closed, the menu cursor or bait icons could stay hidden; the item button now shows the notebook on the TV and the GamePad.
- For mod authors: mirrored HUD images and the game's own layout texts (#434, from the HD minimap's SDK proposal
in ZeldaWWHDMods #33, thanks @francosang). A HUD image drawn with reversed UVs shows mirrored, and
wwhd_game_message_get("layout-message:/", …)returns the game's own text for a layout label. Mods checkhud.mirrored-images.version/layout-message.versionfirst. HUD API 3, mod manager 1.9.0. - For mod authors: boat compasses and chart selection. Code mods can take over the boat compass corner while
sailing (
wwhd_hud_boat_compasses) and select a sea chart like the GamePad does (wwhd_map_chart_selected/_select/_cancel). See docs/mod-sdk-v2.md. Used by the HD minimap mod. - For mod authors: mods can require an exact game build (#429). A manifest can list
supported_game_builds(for example["USA"]); the manager refuses the mod on a port built for another game version. Needsminimum_manager_version1.8.0. - For mod authors: native actors, story flags, quick-use and traversal (#375, #369, #389). C mods can register
their own native actors with
wwhd_native_actor_profile_register;wwhd/save_flags.hreads and changes the game's story flags with checked inputs (take a save backup first); and source mods get services for the game's quick-use item actions, ready-item checks, boat sail wind and target calculation. - Fixed for mod authors: C mods and hooks leave the game's state alone (#367, #384, #387, #391). Hooks no longer
change the hooked function's registers; C mods keep the game's paired-single float registers; and mods are built
with
-mstackrealign, since the game can call them with an 8-byte-aligned stack. Rebuild C mods from source to get the stack fix; older mods get a best-effort safeguard. - For mod authors: True 60 is gone (#407).
render.true60still exists and always reads 0, andwwhd_logic_dtis always one 30 Hz step. - Editor: MCP access starts once the game is ready (#386). With
--editor --mcp, the MCP server starts after the game code is loaded and all mods are initialized.
Decomp build and testing
- Decomp build (experimental) (#368, #370, #373). In the
-DWWHD_DECOMP=ONbuild, 63 functions of the game's compiler runtime and nn wrappers run as host code, each matched to the original by measurement (WWHD_HOSTRT=0runs the originals); the scalable font draws with the game's main font, since the port doesn't provide the Wii U's system font; and the build reads the decompilation's unit specs the way its own checks do. The normal build is unchanged and keeps the game's own code. - Tests (#403, #404, thanks @itsarahtonin; #379). The Vulkan BC self-test accepts NVIDIA's slightly different
BC4/BC5 rounding, the SDL input tests ignore real controllers such as a plugged-in GameCube adapter, and scripted
Android runs (
WWHD_NO_HOST_INPUT) skip the first-start touch-controls question.
Checksums (SHA-256)
d9aa58c1745e9c9bb32a163bc0dd06b6290cd4832ef852d6084886f3f6a75105 WindWakerHD-v0.5.1-linux-aarch64.zip
d7f56850b5b74788f001bab8eecac8cccde5b1e24e11473e14fbd673b7616c3c WindWakerHD-v0.5.1-linux-x86_64.zip
3e5d7b8715ee7263c641f5eaa7ccd400299601d6c6ae1a0ff01578e4130d92f6 WindWakerHD-v0.5.1-macos-arm64.zip
bd53bdb718d2f65d6bce08fbc72ff38edb196b59a05e390820d128f67e21a2a9 WindWakerHD-v0.5.1-windows-arm64.zip
2e8a8b29ed1b35e6d3cae370a7c9b6878a05d6269b28420dd492415da72f48c4 WindWakerHD-v0.5.1-windows-x86_64.zip
9151908c2db0a14fee9da199973a7d7d67133f754f87e15615c1804c20cd45df WindWakerHD-v0.5.1-linux-aarch64.AppImage
e7532b3f4a04ccc0f4b6bb6dfb7bf79ceb8e249d71853c0bf62b0ed1ce5ebf8a WindWakerHD-v0.5.1-linux-x86_64.AppImage
1157a798095f17814df0b748fac414b450e301ea34a7fcacc13adc85799f11ac WindWakerHD-v0.5.1-android-arm64.apk
bd6cfc5e742a6da0ed8deb739787e4f482521f4212c21379f20271119e33e340 WindWakerHD-v0.5.1-android-x86_64.apk
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.5.1-linux-aarch64.zip: 0 of 63 engines flag it, reportWindWakerHD-v0.5.1-linux-x86_64.zip: 0 of 62 engines flag it, reportWindWakerHD-v0.5.1-macos-arm64.zip: 0 of 57 engines flag it, reportWindWakerHD-v0.5.1-windows-arm64.zip: 0 of 67 engines flag it, reportWindWakerHD-v0.5.1-windows-x86_64.zip: 3 of 67 engines flag it, reportWindWakerHD-v0.5.1-linux-aarch64.AppImage: 0 of 61 engines flag it, reportWindWakerHD-v0.5.1-linux-x86_64.AppImage: 0 of 62 engines flag it, reportWindWakerHD-v0.5.1-android-arm64.apk: 0 of 56 engines flag it, reportWindWakerHD-v0.5.1-android-x86_64.apk: 0 of 45 engines flag it, reportWind Waker HD.exe: 0 of 69 engines flag it, reportWind Waker HD.exe: 3 of 71 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (Elastic, Google, Ikarus), reported to the vendors as false positives; see issue #58.
0.5.0
- Intégration fluide et réduction des stutters : préparation des shaders accélérée (12 secondes au lieu d’une minute sur macOS) et suppression des attentes de shaders sur Android (passant de ~1 000 à ~35 ms).
- Menu de paramètres intégré : page dédiée dans le menu pause (système, graphismes, contrôleurs), compatible clavier, souris, contrôleur et tactile, avec support multilingue (anglais, français, allemand, italien, espagnol).
- Contrôles tactiles et améliorations : sticks flottants adaptatifs, boutons contextuels (ex. : tir au bow), roue d’objets et mode "One screen" (simulant le GamePad en mode portable), activé par défaut sur Android.
- Corrections graphiques majeures : textures macOS aussi nettes qu’à l’origine Wii U (Metal/Vulkan), suppression des artefacts (flickering de torches, checkerboard sous les chests), stabilité des scènes (horizon, mer, ciel).
- macOS : redimensionnement et déplacement de l’image du GamePad avec la souris, installation requiert macOS 14+ (non signée par Apple, autorisation manuelle nécessaire).
- Stabilité et corrections : suppression des judder (soleil/moon), continuité après Game Over avec interpolation, fix des dates du Quest Log, et gestion des sauvegardes GameCube dans le Picto Box.
This update is about smooth play: far fewer shader stutters and steadier frame interpolation, plus more than 100 other changes since v0.4.0. Here are the highlights.
In short
- Far fewer stutters: faster shader preparation in setup, and on Android setup now prepares model shaders by default (on our test phone, shader waits dropped from about 1,000 to about 35).
- A settings page inside the game's own pause menu, drawn like the game's menus, with Camera, Controls, Screen, Graphics, Game and Mods tabs. It works with a controller, keyboard, mouse and touch.
- New touch controls for Android: floating sticks where your thumb lands, buttons that show only when they do something, tap-to-aim items, and talks and shops by tap. Plus an item wheel (also for controllers) and a One screen (handheld) mode that plays like the GamePad in Off-TV Play.
- Controllers: a short setup for each new pad, buttons per controller, button prompts that follow your own face buttons, and buttons for Jump anywhere and the moon jump.
- Sharper, steadier picture: smooth bloom and sharp torchlight at 2x and 3x, torches without a flickering outline, Mac textures as sharp as on the Wii U, and scenes that look the same on every run.
- Smoother frame interpolation that no longer changes the game: 40 fps without judder, many more things moving smoothly, and the game now plays exactly as at 30 fps.
- More platforms and options: HDR on Linux, a floating theater on Meta Quest, a 10× smaller Linux install, and looping sounds such as waves and wind no longer cut out.
- Many fixes, among them Quest Log dates, Continue after a Game Over with frame interpolation, and a stuck Picto Box quest after importing a GameCube save.
The full list is in the changelog.
Thanks
Contributions in this update:
- @itsarahtonin: button prompts that follow custom face buttons (#319, #326), full-size torchlight (#318), smooth bloom at higher resolutions (#307, #308) and sharp torchlight on objects (#313)
- @aaronlink127: the Triforce chest glow fix (#297), a smooth camera in the Boating Course (#299), Continue after a Game Over (#295), Link staying invisible after talks (#283), and the hookshot chain with interpolation (#304)
- @CaptainLibrary: the sun and moon judder (#320) and the loading screen speed (#300) with interpolation, and the file select Quit button (#278, with @Tamryell)
- @Tamryell: the Quit button on the file select screen (#278)
- @Eggtooth: Quit as part of the file select's selection and the mouse button fix in menus (#315), and the "Access Denied" fix when building code mods on Windows (#282)
- @KelpyCode: many world editor improvements: full rooms, model changes, exact joins, kit models and an easier Claude / MCP setup (#281, #296)
- @mkopec: HDR on Linux and HDR10 (#311), and no more sky flicker on Mali (panvk) (#310)
- @pancreations: the Meta Quest floating theater (#259) and detailed profiling as a setting (#261)
- @rhemfur: measurements for the Quest theater's Full SBS 3D (#248) and the Quest game icon fix (#325)
- @Pulpparty: the Nintendo Gallery figurines cheat (#327), and with @depende3000 ideas from SwitchWakerHD: the smaller shader template, looping sounds that no longer cut out, and the hang watchdog
- @depende3000: ideas from SwitchWakerHD (shader template, hang watchdog)
- @l0nkDev: the One screen mode idea from SwitchWakerHD
- @koenada: correct Quest Log dates (#322)
- @Froggjarl: no more crash when the chosen GPU can't show the picture (#309)
- @pontesryan: the Picto Box quest fix for imported GameCube saves (#306)
- @shaneoreilly: moving and resizing the GamePad picture with the mouse on macOS (#305)
- @missionfloyd: a 10× smaller Linux install (#314)
- @Linken17: controller input while the game isn't focused (#267)
- @alexander-beepx: code mods in Android's Community list (ZeldaWWHDMods#6)
- @Omaley360: the report, save state and confirmation for the invisible Link fix (#283)
- The GreenNaugahyde Android fork, where the ideas for the new touch controls, the item wheel, the settings page, the controller setup, the camera options and the low-memory handling come from
- SwitchWakerHD, for the One screen mode, the shader template, sound and diagnostics ideas
- aurora's GX layer (MIT), for the ideas behind the new opt-in Vulkan switches
And thanks to everyone who reported issues and tested the development builds.
Settings and menus
- Settings in the pause menu: a page in the item menu drawn with the game's own paper, font and sounds, in English, French, German, Italian and Spanish. Tabs for Camera, Controls, Screen, Graphics (resolution, frame rate, dynamic resolution, bloom, FXAA, filtering, clouds, torchlight), Game and Mods. The full Settings window stays for everything else.
- Quit on the file select screen: a Quit button in the game's style (X or click), and the game's own selector moves onto it.
- HUD fades (optional): hearts, rupees and the magic meter can fade while nothing changes.
- Large Picto Box view drops the finder's black frame.
- New cheat: all Nintendo Gallery figurines.
Controls and touch
- Flexible touch controls, now the default on Android: a stick appears where your thumb lands; the right half turns the camera. Classic fixed sticks are still there. The layout editor gains size, shape, opacity, a mirrored grid, and saved layouts with export and import.
- Context buttons: a touch button shows only when it does something, with the game's own word or icon. Tap the bow, boomerang or hookshot to aim, tap again to shoot.
- Talks, answers and shops by tap (or mouse, as an option), and B goes back while conducting the Wind Waker.
- Item wheel: hold X, Y or R to pick an item from a ring; the game slows down while it's open.
- One screen (handheld) mode: plays like the GamePad in Off-TV Play, without the "GamePad or Pro Controller?" question. On by default on Android, an option on desktop and Steam Deck.
- Controller setup for each new pad, buttons per controller, and button prompts that follow your own face buttons, with optional coloured action words.
- Jump anywhere and the moon jump get buttons of their own; a standing jump now goes straight up.
- Walking and camera options: keep the walking direction while turning the camera, a camera that swings behind Link, a faster boat camera, and pinch to zoom on Android.
- Controllers can keep playing while the game isn't focused (an option, for streaming or a second screen).
- macOS: move and resize the GamePad picture with the mouse.
Graphics
- Bloom is smooth and torchlight is sharp at 2x and 3x, as at 1x.
- Full-size torchlight (on by default, off on Android) removes the flickering outline around lit objects near torches.
- Mac: textures as sharp as on the Wii U (Metal and Vulkan).
- Scenes look the same on every run: fixes for the distant sea and grass at Outset's cliff changing colour, and for the horizon flickering on Metal.
- The glow under Triforce Shard and Chart chests no longer shows a checkerboard.
- Effects such as elemental arrows and rupee sparkles sit in the right place at every aspect ratio.
- HDR on Linux under Wayland, and HDR10 where scRGB isn't offered.
- Linux on Mali (panvk): no more flickering shapes in the sky.
- New setting Shader compile: Fast keeps playing while new shaders compile.
Frame interpolation
- The game now plays exactly as at 30 fps at 40, 60, 120 and 240 fps; only the picture is smoother.
- 40 fps without judder: every frame shows the game at its exact point in time.
- Much more moves smoothly: camera shake, clouds, the sun and moon, hair and ropes, the sword trail, the hookshot chain, flags, shadows, fades, cutscene bars and more.
- Fixed: Continue after a Game Over, Link staying invisible after some talks, a floating fist, flickering fades, the Boating Course camera, the sun and moon judder, and the loading screen speed.
- Fast Forward's 3x and 4x now really run three and four times as fast.
Shaders and stutter
- Faster shader preparation in setup: about 12 seconds instead of a minute on a Mac, with far less memory.
- Android: setup prepares model shaders by default for far fewer stutters (about 40 minutes on a recent phone; you can untick it).
- Vulkan: after setup's models step, recorded pipelines are built in the background while you play.
- Smaller shader caches, Metal cache versioning, and shaders that failed to translate before now work.
- Setup on a network share (NAS) works again.
Android and handhelds
- The new touch controls, item wheel and One screen mode above.
- "Use the new touch controls?" on first start, and mods can be installed from a file.
- Less likely to be closed when memory runs low.
- Fixed: false "too hot" warnings, and the heat pause flashing on and off, on some handhelds (AYANEO).
- Meta Quest: a floating theater with a flat or curved screen, 2D/3D (now Full SBS), size, distance and passthrough.
Sound
- Waves, wind and other looping sounds no longer cut out after a slow frame.
Mods and the world editor (for mod makers)
- Mod SDK: live options, input filters, touches and pinches, points on the picture, the microphone (only when an option asks for it), and the game's own HUD art.
- New world pieces: the Goron merchants, torches, lava (with
col_lavaground), calm water around islands, bigger islands, game materials on your own sea models, and islands seen from farther away. - World editor: replace, watch and remove imported models, the game's materials without MCP, own 3D models in the Windows release, custom items, exact joins and marked faces, and an easier Claude / MCP setup.
- One mod that can't start no longer stops all the others, and a missing mod compiler gets a clear message.
Other fixes
- Quest Log dates are right again.
- The Picto Box quest no longer gets stuck after importing a GameCube save.
- Choosing a GPU that can't show the picture no longer crashes the game.
- A mouse button bound to a controller button works in menus again.
- Mouse camera up/down is no longer inverted in some interiors.
- The game starts when run directly, and
--editorworks through the launcher. - Linux: the installed game is about 10× smaller.
- Windows: building code mods no longer fails with "Access Denied".
- Android: code mods can be installed from the Community list.
- A hang watchdog writes a report to the log if the game stops drawing, and detailed profiling is now a setting (off by default).
The full list of changes is in CHANGELOG.md.
The Wind Waker HD, native PC port, v0.5.0
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows:
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway");windows-x86_64for x86-64,windows-arm64for Windows on ARM (Snapdragon X) - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file:chmod +xthe.AppImageand start it from anywhere (Steam Deck included); its game, code, saves and settings go to~/.local/share/wwhdand~/.config/wwhdinstead of beside it (Ubuntu 24.04+:libfuse2t64, or--appimage-extract-and-run) - Android (arm64, Android 13+, Vulkan 1.3): install the
android-arm64.apk(android-x86_64is for emulators and Chromebooks), choose your game in the app, and it builds the game on the phone (once, a few minutes). Signing certificate SHA-256:7F:F6:D3:5E:4E:45:11:5E:E4:93:65:EF:5B:40:C0:EB:83:EA:F7:6C:C1:1C:E9:67:F2:64:5C:50:4F:58:B2:13
See "Install (releases)" in the README for details.
Checksums (SHA-256)
31bccded0cb2493bb12d38f851a1290a5cff8ea0efa10b7001f661ca9eae5789 WindWakerHD-v0.5.0-linux-aarch64.zip
3584c4fe05ce99fdd460b73777ca34a7ce75ffb5e56bd1a84d89ef363bb69cf9 WindWakerHD-v0.5.0-linux-x86_64.zip
41004d42c39d862814f383b327bbf81492b026fe7ca0d7858d9dea631d1ac406 WindWakerHD-v0.5.0-macos-arm64.zip
48624feb8b14b0b41d82c45298ea833f14b794f504e31ff2c7577e104cb1d226 WindWakerHD-v0.5.0-windows-arm64.zip
11681f6584757567b0feeb2a464fcc2e792a3315ac27105d6c6d3345bf61d105 WindWakerHD-v0.5.0-windows-x86_64.zip
3e86ab17fb4f20a7feacca4b844383ca8066a5cd0ab9cec50c608c5941c7498f WindWakerHD-v0.5.0-linux-aarch64.AppImage
7772ccac38854a23c19328437d6aca07d569a1fc097aabad00b9839f7417ba89 WindWakerHD-v0.5.0-linux-x86_64.AppImage
6af660aac1c67e5d99bbc653b1c2b9f0e429a8513e0e9ca0c497b0c37177f791 WindWakerHD-v0.5.0-android-arm64.apk
61dbe882fc339225d8708227e9fddd7ad9544e2073def1f159c8745e7117f8a7 WindWakerHD-v0.5.0-android-x86_64.apk
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.5.0-linux-aarch64.zip: 0 of 63 engines flag it, reportWindWakerHD-v0.5.0-linux-x86_64.zip: 0 of 65 engines flag it, reportWindWakerHD-v0.5.0-macos-arm64.zip: 0 of 65 engines flag it, reportWindWakerHD-v0.5.0-windows-arm64.zip: 0 of 66 engines flag it, reportWindWakerHD-v0.5.0-windows-x86_64.zip: 3 of 65 engines flag it, reportWindWakerHD-v0.5.0-linux-aarch64.AppImage: 0 of 61 engines flag it, reportWindWakerHD-v0.5.0-linux-x86_64.AppImage: 0 of 61 engines flag it, reportWindWakerHD-v0.5.0-android-arm64.apk: 0 of 58 engines flag it, reportWindWakerHD-v0.5.0-android-x86_64.apk: 0 of 56 engines flag it, reportWind Waker HD.exe: 1 of 69 engines flag it, reportWind Waker HD.exe: 4 of 71 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (Elastic, Google, Ikarus, MaxSecure, Microsoft), reported to the vendors as false positives; see issue #58.
0.4.0
- Éditeur de monde (préversion pour moddeurs) : accès via --editor pour placer/modifier en temps réel objets, PNJ, ennemis, portes, quêtes visuelles et scènes sans coder.
- Améliorations Android : mode double écran pour handhelds, garde thermique, cadence stable à 60 fps, résolution dynamique (réduction progressive en cas de surcharge GPU).
- Optimisations graphiques macOS : réduction des variantes de shaders sur Metal (500 au lieu de 3 500), cache des shaders sauvegardé plus fréquemment.
- Nouveaux modes de framerate : ajout du mode 40 fps (3 étapes logiques sur 4 frames) pour écrans à 40/80/120 Hz (ex. Steam Deck).
- Corrections critiques : résolution des bugs liés à la restauration de session après un quit en donjon/cave, réactivation des anneaux du Pirate’s Charm au-dessus de 60 fps.
- Prise en charge des modèles animés : jusqu’à 16 matériaux par modèle (textures, transparences, faces doubles) pour les îles modifiées.
This update brings the world editor, a preview for mod makers, a much better Android version for phones and handhelds, more speed on every platform, and many fixes. The full list of changes is below.
Thanks
Contributions in this update:
- @pancreations: Vulkan stereo (3D) improvements (#257) and Android setup tests (#260)
- @almost-drowned-rat: on Android, Full screen hides the system bars (#225), the app's files folder in the system file manager (#226), and Back opens and closes Settings (#227)
- @mhbxyz: one-press combat items and animation speed presets (#196), camera-directed Leaf gusts and initial item facing (#203)
- @rhemfur: a game-icon shortcut on Meta Quest (#249)
- The GreenNaugahyde Android fork, where many of this update's Android and graphics ideas come from (dynamic resolution, less GPU work on Vulkan, fewer shader variants on Metal, shadows without depth clamp, and more)
And thanks to everyone who reported issues and tested the development builds.
World editor (preview, for mod makers)
Start the game with --editor to build mods inside the running game:
- Place and change things live: the game's own villagers, enemies (from ChuChus and Bokoblins to Darknuts, Wizzrobe summoners and Kargaroc riders), chests, pots, switches, doors and your own models. Drag them, turn them, set routes for villagers, and see the change at once.
- Quests without code: a visual quest editor, quest talks for the game's villagers, letters, treasure charts and items, and story changes while the game runs.
- Scenes: a scene editor that plays cutscenes with the game's own cutscene system.
- Islands and levels: island grounds and parts, island buildings, eighteen more islands to place, a water tool for ponds, rivers and waterfalls, and new levels and dungeons of your own (with a dungeon map).
- New mod… starts a mod in a few clicks. Export the game's islands for Blender as a reference.
- Works with Claude and other AI assistants through MCP (off by default).
Android
- A big update for phones and handhelds: two-screen handhelds (AYN Thor and similar), a heat guard for handhelds with a fan, even frame pacing at 60 fps, code mods, "Share log", and fixes for PowerVR phones (e.g. Pixel 10).
- Dynamic resolution (off by default): lowers the resolution in small steps when the graphics chip can't keep up, without stutter.
- Less GPU work, and shadows on GPUs without depth clamp (older Mali and PowerVR phones).
Faster on every platform
- Less work on the render thread (graphics register writes, a fast path, graphics recorded on a second thread).
- Keep game speed holds the game at full speed on devices just under 60 fps; a new 40 fps mode.
- Fewer shader variants on macOS (Metal), and the shader cache is saved more often.
Graphics and comfort
- Toon clouds, horizon haze and cloud shadows. A sharp picture on the Steam Deck in Gaming Mode by default.
- Save states: Last session and auto saves. Quick-use locked items, run/swim boost options, an option to turn off the letterbox bars while targeting, Quit Game in Settings, remappable shortcuts (Esc opens Settings).
- Automatic picture-in-picture shows the Wind Waker's song list. GamePad sounds through the main speakers.
Fixes (selection)
- The Pirate's Charm rings again at 60 fps and above; Sploosh Kaboom shows no doubled markers; no crash at Orca's sword training with True 60; Link's fist no longer flies in with frame interpolation.
- Continue last session works after quitting inside a dungeon, cave or house.
- Controller rumble no longer stops by mistake; code mods work again in the Linux AppImage; fixes for Intel graphics on Windows.
Full list of changes
-
Fixed: switches and doors waited for a restart in the world editor. With all of the editor's live kinds installed, the table for the port's own actor types was full, so switches and doors fell back to "after a restart". They now appear at once like the other actors, and a failure names its cause in the log.
-
Mod stages: the light of a place of the game, the game's trees, joined rooms (for mod makers). A mod stage can take its light from another place, e.g.
"light": {"stage": "sea", "room": 44}for Outset's daylight that follows the game's clock; it can place the game's own trees (small, bushy, large with a scale, palm) as room actors; and rooms joined by an open passage are now drawn together. The editor accepts parameters of two types (such as a kit given by number or by stage and room). See mod stages. -
Dynamic resolution (all platforms, off by default; idea from the GreenNaugahyde Android fork). Settings → Graphics → Dynamic resolution lowers the internal resolution in small steps (down to 75% or 50%) while the graphics chip holds the game back, and raises it again when there is room. The picture keeps its size and is scaled smoothly, and a change of level causes no stutter. It helps on devices where the graphics chip, not the processor, is the limit; it costs some extra graphics memory (about 35 MB on a phone). See the Android and Vulkan docs.
-
Fewer shader variants on Metal (macOS) (idea from the GreenNaugahyde Android fork). Metal now keys shaders on the same narrow state as the Vulkan renderer, so the same scenes need far fewer shaders and pipelines (in our Outset test about 500 instead of 3,500 shaders); existing shader caches keep working. Pictures are unchanged.
-
Crash logs and performance reports list the renderer's live shaders, pipelines and memory mappings, which helps us find out-of-memory crashes.
-
Less GPU work on Vulkan (idea and first versions from the GreenNaugahyde Android fork). Shaders use the slower exact multiply only where a value may be infinite, and rendered mip chains are built only as deep as the game samples them, starting from the first changed level. On our test phone the GPU time per frame fell by about 8–9%; pictures match the previous version (a few pixels differ in the lowest bits).
-
Export the game's islands for Blender (for mod makers). The editor's new
export_glbcommand (andtools/story_mods/export_glb.py) writes a game room, e.g. Outset or Windfall, or one building as a GLB file with textures, the game's material names and optionally collision by ground type and actor markers. It is a reference for scale, style and material names when building your own islands; the files are your own copy of the game's content and must not be shared or put into mods. See world objects. -
Fixed: mod stages in release builds. The stage builder was missing from release packages, so mod stages,
list_kit_materialsand the stage templates failed there; development builds were not affected. -
Mod stages and scenes: quests through stages, cutscene clips, carrying Link (for mod makers). Chests, defeated Darknuts and warps in a mod stage can move a quest on (
then), quest places can point into the mod's own stage, scenes can use clips from the game's cutscene archives that play once and hold, Link's face animations and blending, a smoothblendwhen attaching one actor to another (e.g. the Helmaroc King grabbing and carrying Link with the game's own capture animation), and a scene spawn that drops Link in from above. -
Fixed: Continue last session after quitting inside a dungeon, cave or house. Starting the game with At start → Continue last session (or a save state chosen to load at start) put Link at the save file's start point on Outset and then left the screen black. Link now arrives where you left off; loading states during play is unchanged.
-
Mod SDK: mod dungeon maps for HUD mods (for mod makers). A guest mod can read the current room's map of a mod dungeon (rooms, visited rooms, Link's position, and with the compass the chests), so minimap mods can show mod dungeons too.
-
Vulkan stereo (3D) improvements (#257, thanks to the contributor). Formats that can't be scaled fall back to full-size eyes instead of drawing into a cleared image, and stereo modes reuse their image memory between frames. Nothing changes with stereo off.
-
Less render-thread work on graphics register writes (all platforms; idea from the GreenNaugahyde Android fork). Register writes look up what they affect in a table instead of walking ranges, shader constants take a fast path, and the hot paths no longer use per-thread variables: about 0.3–0.5 ms less render-thread time per frame in our tests.
-
Shadows on GPUs without depth clamp (older Mali and PowerVR phones; idea from the GreenNaugahyde Android fork). Such GPUs used to fail on the game's shadow draws; the port now clamps depth in the shader instead.
-
Fixed: the Pirate's Charm shook without ringing at 60 fps and above (#262). With frame interpolation the game's on-screen interface logic also ran on the in-between frames, where sounds are skipped so nothing plays twice, and the charm's ring always landed there. It now runs once per game step at every frame rate, as at 30 fps; this also brings the interface's other small animations back to their original speed.
-
Scenes and kit materials for mod makers. A demo actor can ask for its own copy with
"spawn": "always"(for example the Helmaroc King, while the room's own one waits hidden for its story moment). A room without a material mapping now uses the kit's main material instead of an arbitrary one, which fixes streaked or black ground. Scenes without text, sounds or story actions no longer need the Story Notebook. New editor and MCP commands:list_kit_materials,edit_demo_actor,set_package_info, andfocuswith an eye point. -
Mod dungeons: sky islands and boss rooms (for mod makers). A stage can borrow the sky of a game stage (day sky, stars or dusk) over your own models;
list_stage_templatesin the editor and MCP lists which stages have a sky, a boss door and music to borrow, and the Stages tab can filter for skies. New entry style: an updraft that lifts Link into the stage. A big chest can hold a heart container, and a warp can wait until a chest is opened. Talks and scene ends can take Link into a stage. A stage can bring its own shader template so it doesn't stutter on the first visit (installed after setup: run setup's Repair). Game Over in a mod stage restarts at the stage's start. -
World editor: scenes play right away, and easier demo steps (for mod makers). A new scene can be played with Play scene or Play step without saving and restarting first. In the Scenes window the step row no longer hides its buttons on narrow panels; the buttons say "Duplicate scene" / "Remove scene…" and "Duplicate step" / "Remove step", a step can be removed with right-click or Delete, and Undo brings back a removed scene. A demo step's actors and events are now picked from lists instead of typed as JSON: game characters, models and your mod's characters; sounds (with a Play button) and particles by name; joints, animations, Link's modes, time, rain and messages. The JSON stays under "Advanced". Full save states made by an older build in editor mode can't be loaded by this one.
-
Water tool: new ponds are swimmable, and pond surfaces always appear. A new pond's level now defaults to its depth above the shore, so Link can swim in it right away; banks stay compact, and nothing reaches down to the sea floor. Some pond outlines left the visible water out because its surface model couldn't be prepared; that is fixed, and the editor names the reason if a model ever can't be prepared. Such a model no longer stops the game at start.
-
Less render-thread work on the Vulkan renderer (#178). Shader programs are fingerprinted again only after the game writes to them, and texture invalidation now looks only at the textures it can reach. On a Snapdragon phone this cut the render thread's CPU time by about 11% in Windfall; the picture is unchanged.
-
Eighteen more islands to place (for mod makers). Shark, Horseshoe, Rock Spire, Thorned Fairy, Seven-Star, Overlook, Stone Watcher, Cliff Plateau, Angular, Boating Course, Gale, Headstone, Greatfish, Cyclops Reef, Two-Eye Reef, Diamond Steppe, Mother & Child and Fire Mountain join the island grounds, built from your own game files. Diamond Steppe and Mother & Child keep their own moving water. Pits, holes and doorways send Link back to the restart point. Fire Mountain comes without its lava for now, and Bird's Peak is too large to offer.
-
World editor: building mod levels, also with an AI assistant (for mod makers, preview). A new Stages tab creates a level from your room models (import, add, build, warp in), adds rooms, places entries, exits, doors with locks, chests, enemies, pots and return warps where Link stands, and moves them with handles in the picture. Check lists unreachable rooms, keys behind their own doors and room models without UVs or named materials. Every step is also an MCP command, so an assistant such as Claude Code can model rooms in Blender and build and look at the level in the game; see the new guide "Building a dungeon with an AI assistant".
-
Fixed: ponds on a mod's own island (water tool). A pond drawn on a terrace of the mod's own island model no longer turns into a column down to the sea floor and is no longer refused as "in the way": the water's level follows the ground at its shore, the island's own surfaces count as ground, and only what really rises through the water (a wall, a pillar, a house) blocks it. Messages now name the game place that blocks a spot and where it is.
-
Mod SDK: a dungeon map for mod dungeons (for mod makers, preview). A mod dungeon with a map shows it on the GamePad's map page (and on the TV's map tab with the Pro Controller): rooms seen from above, made from the rooms' floors, the rooms Link has visited, where he stands, and with the dungeon map every room; with the compass also the chests (open or not) and the boss door. Only Link's floor is shown for now.
-
40 fps mode. A new frame rate next to 30, 60, 120 and 240 fps: three game steps over four frames, at full game speed. It suits screens that run at 40, 80 or 120 Hz, such as the Steam Deck LCD at 40 Hz or the OLED at 80 Hz, where every frame is shown for the same time. On Android the app asks for a matching screen rate; some phones choose the rate themselves, and on a 60 Hz screen 40 fps runs unevenly (Settings says so). Keep game speed works as at 60 fps.
-
Mod SDK: dungeons in mod levels (for mod makers, preview). A mod level can now be a small dungeon: rooms taken from any game room or the mod's own models, small-key, boss and shutter doors, chests with a small key, map, compass or boss key, enemies (ChuChus, Bokoblins, Keese, Darknuts), pots and a return warp. Each mod dungeon keeps its own keys, opened chests and switches; the game's save still only stores a normal entrance. See the example "mod-stage-dungeon".
-
Mod SDK: new levels of their own (for mod makers, preview). A mod can add a new cave or dungeon level with its own rooms, reached from a box in a game level and left through a floor exit. The level is built from the player's own game files when the game starts, with the look and music of a game level the mod names; doors between its rooms work. Saving inside it is safe: the game's save always keeps a normal entrance, so the save still loads with the mod removed, and with the mod the Quest Log continues inside. Save states made in a mod level ask for its mod. The editor lists mod levels for warping. See the example "mod-stage-cave".
-
Automatic picture-in-picture shows the Wind Waker's song list (#256). With the GamePad screen set to Automatic picture-in-picture, the GamePad picture now also appears while Link conducts with the Wind Waker, with the song list and the conducting guide, and goes away again when he stops.
-
Fixed: Link's fist no longer flies in from elsewhere with frame interpolation (#255). When Link's hand pose changed (for example from standing to running, or after targeting), a hand pose could appear for one in-between frame at the spot where it was last used and fly to his hand, most visibly at 120 fps and above. A part of a model that comes back after being hidden is now drawn where it is, without blending; everything else blends as before.
-
Mod SDK v3 and the editor: Kargarocs with riders and Wizzrobe summoners (for mod makers). A Kargaroc can carry a Moblin or Bokoblin along a mod path and drop it at the path's release point. A Wizzrobe summoner teleports between the points of one path and calls waves of enemies at the points of the next, in the game's own wave sizes (up to 20); summoned enemies give no drops. The editor sets up both paths when a summoner is placed.
-
World editor: a water tool for ponds, rivers and waterfalls (for mod makers, preview). Under Add > Water, click points on an island's ground: a pond gets a level handle, a river a band with flow arrows, shallow parts to wade and a reverse button, and a waterfall forms at a river's step or from two points. Link swims, wades and falls as in the game. Banks slope into the island's own grass and sand, the water is the game's own, and foam shows only at the shores. Check marks problems in red in the picture. The same is available as MCP commands. On the sea only; a pond can't be dug into the ground, so on a slope it sits in a grassy mound.
-
Fixed: the world editor no longer crashes at start when code mods are off. With Code-mod support turned off (and in the decomp version),
--editornow starts; live editing is off and the editor says so, and edits are still saved. -
Mod SDK v3 and the editor: paths, the wall cannon, warship routes and wandering Floormasters (for mod makers). A mod can draw lines and areas in a room (up to 16 per mod) and its enemies can use them. The game's wall cannon can be placed with an area as its firing range: it turns to Link and fires while he is inside, and a bomb destroys it, with the mod's own defeat flag and drops. An enemy warship can sail a route back and forth, firing at Link, and a Floormaster can glide along a line. The editor draws and edits paths in the picture, and its Check warns when a ship's route runs over land or a Floormaster's line leaves the floor; the same is available as MCP commands.
-
Mod SDK v3 and the editor: every placeable villager can walk a route (for mod makers). The Windfall villagers without a walk of their own (the old women, the young women and the large sailors) now walk their routes with another villager's walk, fitted to their own bodies when the game starts, from the player's own files. Feet stay on the ground at any walking speed. Full save states made with the editor before this update can't be loaded.
-
Keep game speed at 60 fps holds full speed on devices just under 60 fps (#254). With Keep game speed on, a device that draws a little under 60 fps (for example a phone at 57-58 fps) no longer runs the game slightly slow, and a short hitch no longer costs game time: the game skips exactly as many in-between frames as it needs, without waiting after a skip. A slow device that takes 20-25 ms per frame now shows a third to two thirds of its in-between frames instead of almost none, at full game speed. 30 fps, 120/240 fps and Keep game speed off are unchanged.
-
Mod SDK v3 and the editor: sea and dungeon enemies (for mod makers). The Kargaroc (flying or perched, without riders), the red Wizzrobe with its fireballs, the enemy warship (at sea only; its cannonballs hit only Link and his boat), groups of one to five Gyorgs (they appear once Link has the boomerang), the Floormaster (it grabs Link and lets go again, it never takes him away) and the Big Octo as a target whose eyes are shot out (no swallowing, no whirlpool) can be placed, each with the mod's own defeat flag, drops and defeat switch. Defeating them by a mod doesn't count toward the game's sea kills.
-
Fixed: things can now be placed on top of a mod's island (houses, signs, villagers, enemies and other world objects); the island no longer counts as "in the way". Objects only block each other where their shapes really overlap, so turned buildings next to each other are no longer refused. In the editor, clicking the open sea now places an island (or anything else) on the water surface.
-
Mod SDK v3 and the editor: more native enemies (for mod makers). Stalfos, Redead, Mothula (on the ground or winged), Morth, Magtail, Poe, Armos and Armos Knight can be placed, each with the mod's own defeat flag, drops and defeat switch, live in the editor. What holds Link (a Redead's scream and bite, a Poe's possession, clinging Morths) lets go when the enemy is removed, its room changes or a state is loaded. A placed Stalfos does not split in two under a spin attack, and a placed Mothula does not release Morths; place Morths next to it instead.
-
Animated mod models can have several materials too (for mod makers): up to 16 per model, each with its own texture, opaque or cut-out (for leaves, fences, hair) and optionally double-sided, with the same texture budget as static models. They work in scenes and demo steps, with save states and in the editor. An example walker is included.
-
Mod SDK v3 and the editor: demo steps, cutscenes played by the game's own cutscene system (for mod makers, preview). A scene can now play a demo: keyframed camera, actors flying or walking along curves (game characters, villagers the mod placed, the mod's own actors, and Link in his cutscene poses), messages that wait for A, sounds and effects, one actor carried on another's joint (for example the Helmaroc King carrying someone), and time of day and rain that come back afterwards. Characters a demo needs but the room lacks are created for it. Demos can be skipped, follow each other directly, and a choice between two demo steps picks which one plays. A time change in a demo never starts a new day. In the editor, a demo step's lanes appear on the Scenes timeline with keys, clips, messages and carry markers, a preview at the cursor and curve handles in the picture; the same is available as MCP commands. Nothing changes for players or mods that don't use demo steps.
-
Mod SDK v3 and the editor: more native enemies (for mod makers). Boko Babas, red and blue Bubbles, Fire Keese, Octoroks and Seahats can be placed, each with the mod's own defeat flag, drops and defeat switch. A Boko Baba bites but never grabs Link and leaves no flying head behind; a Seahat or Octorok defeated by a mod does not count toward the game's sea kills. (The game has no Ice Keese.)
-
Fixed: Link's boomerang, arrows and bombs now hit mod enemies. Thrown, fired and exploding ones were ignored before, also by the Bokoblins, Moblins, Peahats and ChuChus placed by mods.
-
Mod SDK v3 and the editor: island grounds (for mod makers). Six islands without their buildings can be placed as ground for a mod's own island: Crescent Moon, Triangle, Five-Star, Star, Bomb and a fairy island, in the editor's new Islands list. Each is made from your own game files the first time a mod uses it, has its own collision, shows on the horizon from the neighbouring squares, and the ship stops at its shore. Holes drop Link back to the room's start.
-
Mod collision: water to swim in, shallow water, waterfalls, ice and void surfaces, and a water material for ponds (
"material": "water"). A pond placed above the room's height range is not found as water; the docs explain this. -
Fixed: mod collision marked as metal hurt Link (it was read as a damage surface, e.g. on the buoy example). Full save states made before this update keep their objects; their old collision is used until the room is next loaded.
-
Mod SDK v3 and the editor: island parts (for mod makers). Smaller pieces of other islands can be placed like the island buildings: Dragon Roost's shrine, torii, walkways, rope posts and sea rocks, Windfall's windmill cap, and two Forsaken Fortress shipwrecks. They are made from your own game files the first time a mod uses them, have their own collision and take the light of the room they stand in. Island pieces now check the textures they are built from, so existing piece caches are rebuilt once.
-
Fixed: the mod actor heap diagnostic (
WWHD_MOD_ACTOR_HEAPS) no longer crashes when a game heap isn't set up. -
Mod SDK v3 and the editor: rat holes and patrolling Moblins (for mod makers). A rat hole lets out three rats (or bomb rats, or a mix) one after another while Link is near; each defeated rat gives the hole's drops, and the hole closes once all three are beaten (its
defeat_switchis set then). A bomb rat's bomb only hurts Link and the mod's own enemies. Placed Moblins can patrol a route like Bokoblins. -
Fixed: a mod enemy, prop, switch or door that the game refuses to create no longer stops the game later.
-
Island buildings and world objects: only real conflicts refuse a place now (doors, start points, villagers and their walks, chests, event triggers); pots, signs, rupees, message and hint areas and the sea's surface no longer count. In the editor a building can be placed anywhere: on a red spot it shows as an outline with what is in the way drawn in, and it appears in the game once dragged to a green spot.
-
Mod SDK v3 and the editor: the Darknut (for mod makers), plain, with a shield, with a helmet, or the Mighty Darknut with its cape. Its sword and cape stay its own and go with it, it writes no game switch, and its defeat can open a mod door (
defeat_switch). -
Mod models can have up to 16 materials (for mod makers), each with its own texture, so mod islands can mix sand, grass, rock and wood like the game's own islands; cut-out materials (glTF alpha clip) for leaves, fences and foliage cards, and double-sided faces lit correctly on both sides. New example
world-objects-w5. -
Fixed: island buildings in released builds. The release packages lacked the converter the island buildings need.
-
Quick-use locked items (Mods > Built-in, off by default; #196, thanks mhbxyz): while locked onto an enemy, one item-button press equips and uses the bow (including fire, ice and light arrows), boomerang, hookshot or grappling rope; bombs are readied and thrown, and equipping the hammer completes one strike. A Quick-use animation speed of 1x, 1.25x or 1.5x speeds up the supported equip animations.
-
Keep game speed now holds the game's speed at 60 fps when the graphics can't keep up (#178, e.g. Steam Deck): in-between frames that don't fit are skipped instead of slowing the game to 21–25 logic steps a second. The performance overlay's slow-motion warning now appears below 29 logic steps a second (was 26) and no longer flickers.
-
Mod SDK v3: more enemies and enemy switches (for mod makers). The Peahat and a black ChuChu can be placed; enemies can open doors through a mod switch once all of them are defeated (
defeat_switch, also in the editor's Inspector); Bokoblins can patrol a route of the mod's own. -
World objects: island protection now works on the sea (for mod makers). Placement used to read sea rooms at the wrong coordinates and protected nothing there, and dungeon rooms with a turned map were checked turned. World objects now keep clear of what the island needs (villagers and their routes, doors, chests, items, switches, cutscene areas and the places where Link arrives) by their real size instead of wide 100 m zones, and may stand over grass and trees. A world object that can't stand where it is placed is left out with a log line instead of stopping the game; the editor shows its footprint in red with the reasons.
-
Mod SDK v3 and the world editor: island buildings (for mod makers). Mods can place some of the islands' own buildings as
"actor": "piece:": four Outset houses (their windows light up at night), Outset's lookout tower and well shelter, the Flight Control Platform, the Private Oasis cabana and Tingle's tower. They are made once from your own game files, lit by the island's light at every time of day and in all weather, and Link can walk on them; their doors lead nowhere. A building must keep clear of the island's villagers and their routes, chests, doors, items and cutscene areas (the editor shows what is in the way), and a room's buildings share 24 MiB. In the editor they are in the Game objects palette. -
Performance report: it says whether Keep game speed is on (and at which interpolation rate), and the log records its value and where it came from at start and on every change.
-
Controller rumble no longer stops by mistake: the safety stop for a stalled game could switch off a rumble that had just been started. The game's list of villager names (for mod makers) is now kept in the mod manager's folder; it is built once more after the update.
-
Mod SDK v3: placed villagers can walk a route. Uo1, Uo2, Uo3, Um1 and Um2 walk up to 15 points with their own walk: once, in a loop or back and forth, at their own pace or yours, with optional strolling pauses. They still stop to look at Link and talk as usual, and a walker that runs into a wall or walks off an edge is caught. Your own models' routes can also go back and forth, pause now and then, and name their walk and idle clips.
-
World editor: a Route section in the Inspector for walking villagers and your skinned models. Add points at Link or the camera, drag them in the picture, reorder or remove them, and set speed, mode and pauses; the route shows in green, and stretches without walkable ground in red. New route commands for MCP clients.
-
Mods and the world editor can place the game's own objects by name (
game:palm, trees, tables, shelves, lamps, plant pots, flowers, nests, the Rito and sea flags, the sea lookout tower, grass, flowers and small trees): they load from your own game files, never from the mod. In the editor: Add > Game objects, with Variant, Turn and Scale in the Inspector;list_game_objectsover MCP. -
Mod SDK v3: thirteen more Windfall villagers can be placed (residents uo1, uo3, ub1–ub4, uw1, uw2, um2, sa1–sa4); um3, sa5, ug1 and ug2 are refused with the reason.
-
Mod SDK v3: more enemies — red, blue and yellow ChuChus (
parameters.variant), the Miniblin, and Bokoblins with a shield or a machete, each with the mod's defeat flag and drops. The editor picks a villager or an enemy variant from a list in Add and in the Inspector. -
World editor: the Inspector no longer says an enemy's changes wait for a restart when they apply at once.
-
World editor: story changes while the game runs. Quests, quest talks (also those for the game's villagers), letters and charts change in the running game at the next calm moment, with every edit, Undo and Redo; an item's name, description, amount and use change at once. A new item, its icon, held model and hold_up, and removed charts still wait for a restart, and the status bar says which. The Quest Log is never touched: saves and save states always play with the current story, and the status bar says when a renumbered step moved a loaded quest.
-
World editor: New mod… starts a new, empty mod of your own from inside the editor (also
new_modover MCP): its own package, turned on in your mod profile and opened at once. -
World editor: quest talks for the game's villagers. The game's own villagers show their names in the picture; click one to give it a quest talk in your mod, as a new quest, a new step or a step's talk (also
list_villagers,pick_villagerandadd_villager_talk). The villager's own dialogue and save flags are never changed. -
World editor: placing and dragging fixed. Clicks find the ground under the mouse again (piers, roofs and grass were missed or hit the sea floor); residents, enemies and props appear at once also in a mod that had no actors at start-up; a dragged enemy or resident now moves with the drag instead of staying at its old spot; and a resident's type is chosen in Add and in the Inspector.
-
Story mods: Bokoblins see Link. Bokoblins placed by a mod stood blind and never attacked; they now notice Link at the game's usual range and fight. (A save state with such a Bokoblin from before puts it aside.)
-
World editor: the docked panels react to the mouse again. Since the dockable panels arrived, the full-screen picture could sit in front of the docked panels, so they got no hover or clicks on any renderer; the picture now always stays behind them.
-
Android: handhelds with a fan keep 60 fps longer (#247). Their heat guard now pauses 60 fps at a thermal headroom of 1.00 instead of 0.90 (Relaxed: 1.10); the AYANEO EVO and KONKR Pocket FIT Elite ran 60 fps well around 0.90-0.96. Phones keep their limit.
-
World editor: native scene previews after loading a save state. A scene's native version now also plays in the preview after a save state was loaded or after a preview fell back to the scene's steps, and the editor says why when it can't restore the world after a preview.
-
Without mods and without
--editor, the world editor and the Mod SDK v3 stay completely off. Nothing of theirs runs or reserves game memory then, so full save states made without mods by builds from before 17 October load again. -
Story mods: more of a quest without code (for mod makers). Content packages may hold only letters, charts, items or quests; letters can wait for a quest or flag and a number of game days (
when,after_days); characters and scenes can give a treasure chart; items withhold_upare held over Link's head when he gets them; placed chests can hold more rupees, a heart piece or container, or the mod's own items (with a "Chest holds" picker in the editor); andreset_questalso clears the quest's charts and items. -
World editor: letters, treasure charts and items (
--editorand its MCP tools, for mod makers). A new Story tab and commands create, change and remove letters on their own, treasure charts (with the X placed at Link or the camera) and items (with icon import). Removing something still in use is refused with the list of its uses. -
Android: heat guard for handhelds with a fan (#247). AYANEO, KONKR, AYN and Retroid handhelds now keep 60 fps until they are much hotter than phones, and the new Settings → Graphics → Heat guard (Normal / Relaxed / Off) sets how early 60 fps pauses when the device gets hot. Phones keep their current limit by default.
-
Android: even frame pacing at 60 fps. A frame that is ready early now waits a few milliseconds, so each frame stays on screen equally long. With Record graphics on a second thread on, a third of the frames on a 120 Hz phone screen used to stay for one or three refreshes instead of two (a slight judder); now almost all stay for two. The game's speed is unchanged. On by default on Android.
-
World editor: scene editor, live actors and smooth dragging (
--editor, for mod makers). A new Scenes window edits a scene's steps, takes camera keys from the fly camera, shows a timeline to scrub and retime, and sets choices, walking paths, triggers and the native version; scenes preview in the game with Skip and Stop. Pots, barrels, crates, switches, doors and enemies now appear and change live in the room, and dragging an actor moves it smoothly in place (one undo step). The editor and its MCP tools also cover the new quest forms: talks, flag and multi-quest conditions, finishing a quest and places inside buildings. -
Mod SDK v3 preview: world objects (for mod makers). Mods can place solid scenery and walkable islands in the sea, with collision from the model and wood, sand or grass ground; objects that bob on the waves or drift and can be ridden; surfaces Link can climb, hookshot and grapple; islands that are visible from neighbouring sea squares, get a ring on the sea chart and an arrival notice; and animated coast foam that uses the game's own foam look.
-
GamePad picture-in-picture: simpler settings (#221). Settings → Display → Picture-in-picture now has one slider each for size (5–100 %) and opacity (10–100 %). Dragging the picture places it freely, and clicking one of the nine circles in the diagram snaps it to that spot.
-
Mod quests: finishing, flags and places inside buildings (for mod makers). A character's dialogue or a scene's end can now finish a quest (the reward is given once), characters and quest steps can react to the mod's own flags or to several quests at once, a character can offer step-specific conversations, and a quest step can point into a building, cave or dungeon (the notebook shows where, and the sea chart marks the island).
-
Graphics: toon clouds, horizon haze and cloud shadows (Settings → Graphics → Effects, all optional). Cloud style adds Toon clouds (Lite / High): puffy, cel-shaded clouds that follow the game's own clouds, weather and time of day (Original stays the default; Lite is the lighter one for weaker devices). Horizon haze (100 % = original) gives a clearer, deeper blue sky when lowered together with Bloom strength. Cloud shadows (off by default) let the drifting clouds cast soft shadows on the sea, islands and characters. Stereo 3D keeps the original clouds for now.
-
Mod SDK v3 preview: native scenes (for mod makers). A scene can include an optional native
turn_cameraversion that the game's own event system plays: two residents turning toward each other and a camera move. It can be skipped with Plus and survives save states, and the scene's normal steps play whenever the native version can't run. -
Android/Vulkan: texture decoder self-test. Phones that decode compressed (BC) textures in a compute shader now check that decoder at start-up and switch to the CPU decoder if the graphics driver gets it wrong (Qualcomm's driver 762 miscompiled it, leaving speckled edges on the HUD hearts and streaks on water when that path was used). One rare case in signed BC4/BC5 textures also decodes correctly now.
-
Mouse camera: smooth while sailing (#237). Turning the camera with the mouse on the boat (sailing, paddling, salvage) now follows the mouse directly at the same sensitivity as on foot, instead of turning in jerky steps.
-
Settings dialogs and phone text size. Every dialog in Settings now has a close button in its title bar and also closes with a tap outside it, Esc, B or Back; long dialogs such as Gyro aiming keep Close on screen. On phones, Settings uses smaller text so more fits at once, while buttons stay at least 7 mm tall to tap. Tablets, handhelds and PCs look as before, and the UI size setting still wins.
-
Android: code mods (such as the story quests). Turn on Code mods in the setup app (or Settings → Mods): your device builds the game again with mod support, and builds each code mod itself the first time it's used. Uses the compiler and Python the setup already has; the download grows by only a few KB.
-
Record graphics on a second thread (Graphics → Advanced, off by default). The render thread hands recording and submitting the Vulkan commands to a second CPU thread. On a Xiaomi 14 it makes typical frames a little faster (about 20% less render-thread time) but adds short hitches (the slowest 1% of frames about 3 ms slower), so it stays opt-in everywhere for now. Steam Deck owners: please try it on and off in the same spot and tell us the fps, the 1% lows and whether the Deck runs warmer.
-
Shader cache saved more often: pipelines built while playing are now saved every few minutes and when the Android app goes to the background, so fewer are rebuilt after a crash or after Android closes the game.
-
World editor (preview, for mod makers): start the game with
--editorfor a dedicated editor mode: after the title screen and file select it opens a free camera with its own panels (toolbar, outliner, inspector, problems & export, log). Place new actors by clicking into the picture, move and turn them with handles (grid and angle snapping), import.glbmodels with clear limit checks, write dialogue with a live preview in the game's message box and choose what happens after it, change everything with undo/redo, warp to any island, room or quest place, check the package with a clickable problem list and export it. Play / Stop lets you test as Link in a test mode that never touches your real save, and Stop puts the world back. New enemies, pots, switches and doors appear after a restart. Saving writes only your mod's own package. See docs/mod-editor.md. -
World editor: Claude and other MCP clients (for mod makers). In
--editormode, Settings → Editor → Claude / MCP access lets Claude Code (or another MCP client) use the editor's commands: place and change actors, write dialogue, warp, take screenshots and check the package. It is off at every start, only reachable from your own computer with a new token each session, and removing, replacing or exporting asks you to Allow in the game first. See docs/mod-editor.md. -
World editor: visual quest editor (for mod makers). Build a quest as a graph: steps are nodes, and dragging from one step to the next chooses who moves the quest on; branches, unreachable steps and other problems show on the nodes. Start at this step jumps straight into a test of any step (test mode, only your mod's own progress is set), the quest step and your mod's flags show live while you play, and you can search, select several actors and copy/paste actors and steps, also into another room.
-
World editor: live handles, docking panels, Esc (for mod makers). Dragging a move or turn handle now moves the actor (or the whole selection) live in the game, still as one Undo step. The editor's panels dock to the screen edges and into each other as tabs, with a default layout and Reset layout. While placing, dragging or connecting quest steps, the first Esc cancels that; Esc with nothing to cancel opens Settings.
-
Mod SDK v3 preview: enemies, props, switches and effects (for mod makers). Mods can now place the game's own residents, breakable props, switches and doors, and enemies with their own state; original mod enemies take damage, react to hits, can be targeted, defeated and drop items; mod props can be carried and thrown, and original item models can sit in Link's hand; plus a curated set of the game's particle effects, simple mod effects and custom textures on placed props. New original example: a patrolling enemy.
-
Android two-screen handhelds: with GamePad screen set to Off, the game no longer takes the lower screen for a moment when it starts (#222).
-
PowerVR phones (e.g. Pixel 10): no more stretched spikes (#207). On PowerVR GPUs the game now converts vertex data on the CPU automatically, because their drivers decode some of it wrongly in the shader. Only the one kind of data they get wrong is converted (found with a tester's help), so it costs much less speed than converting all of it; Graphics → Advanced → Convert vertices on the CPU switches it off (Automatic restores it).
-
Shortcuts: remapping works, Esc opens Settings (#220). Remapped shortcuts take effect again (the Controls tab was catching the input first). Every binding clears the same way in Controls and Shortcuts (right-click, or Delete / Backspace / X on a focused binding); extra controller buttons (Capture/Share, rear paddles, touchpad click) can be bound; Home is listed under Settings. Esc now opens Settings (with a captured mouse the first Esc frees it), F1 keeps working for now, and on macOS Cmd+, still opens Settings from the app menu.
-
Steam Deck Gaming Mode: sharp picture by default (#214). In Gaming Mode the game now starts in full screen with the GamePad picture as picture-in-picture, because Gaming Mode shows one window at a time and a separate GamePad window made the picture blurry. Also with the Windows build through Proton. Your own saved choices and launch options still win; the old launch-option workaround is no longer needed.
-
Sploosh Kaboom: no more doubled hit and miss markers at higher frame rates (#179). The board's markers are moved between cells once per game step; the in-between frames no longer blend a marker from its old cell to its new one.
-
Option to turn off the letterbox bars while targeting (#114). Settings → Mods → Built-in → Camera → Letterbox while targeting (on by default). Switched off, normal Z-targeting no longer shows the black bars; cutscenes, scripted cameras, minigames and item aiming keep theirs.
-
Run/swim speed: boost bar options and "Roll, then hold A" (#233). New Show boost bar switch; with Boost time set to no limit the bar no longer appears; the boost bar and the climbing stamina wheel now hide while menus, cutscenes and conversations are on screen. New boost button Roll, then hold A: roll while running and keep A held to boost until you let go (on land).
-
Android: big update for phones and handhelds (most ideas from GreenNaugahyde's Android fork):
- Fewer stutters after Android closes the game: the shader cache is now also saved every few minutes and when the app goes to the background, so the next start doesn't rebuild what you already had (desktop benefits after a crash too).
- Display refresh rate: the game asks Android for the rate it draws (60, or 120 with 120 fps interpolation). Some phones (for example Xiaomi with HyperOS) still limit games to 60 Hz on their own.
- If the graphics driver crashes, the game offers another driver on the next start; crash reports now also cover times Android closed the game itself, and include more detail.
- Older Qualcomm (Adreno) drivers: shader pipelines are built one at a time there, which avoids crashes on those drivers.
- Less memory: shaders keep less data after compiling, and save states are written and read in small pieces instead of all at once (all platforms).
- Gyro with the phone's own sensors: Controls → Gyro… → Source: Device gyro.
- Phone vibration follows the game's rumble while you use touch controls (Settings → Controls → Phone vibration: Off, Touch only, or also when no rumble controller is connected).
- Touch layout editor: hold the on-screen controller button to move and resize the touch controls.
-
Save states: Last session and auto saves (all platforms). A Last session state is kept when you quit (on Android also when the app goes to the background); At start → Continue last session in the Saves tab picks up right where you left off. Auto save every 2, 5 or 10 minutes (off by default) into three rotating slots. These are save states, separate from the game's own save file (#234).
-
New built-in mods (Settings → Mods → Built-in, off by default): Faster ivy climbing, Faster ledge hanging, and Jump anywhere (L by default, optional double jump). Cheats gain infinite rupees, infinite bait and spoils, infinite swimming and "Fill the bags".
Please help test these: we've checked the basics on our own phone, but these need real players and other devices. If something doesn't work, open an issue with your device and the log (Settings → Graphics → Bug reports → Share log on Android):
- auto saves and Continue last session after quitting or switching apps;
- Device gyro aiming and Phone vibration;
- the touch layout editor;
- Jump anywhere, faster climbing/ledge hanging and the new cheats;
- phones with older Adreno or other GPUs, and whether 120 fps reaches your display.
-
True 60: no more crash at Orca's sword training (#223). Talking to Orca and choosing "yes" stopped the game in True 60 mode; event commands now only run on full game steps.
-
GamePad sounds through the main speakers (#218). Sounds the Wii U plays only on the GamePad's own speaker (switching items, saving and other GamePad menu sounds) are now heard during TV play too. Settings → Audio has the switch (on by default) and its own volume; sounds already on the TV aren't doubled, and Off-TV Play is unchanged.
-
Linux AppImage: code mods work again (#230). Turning on a code mod such as the story quests failed with "Guest mod build tools are missing". Setups made with an earlier start of the AppImage are repaired automatically, without running setup again.
-
Settings: Quit Game (#231). A button at the bottom right of every Settings tab, with a confirmation (Cancel is preselected), so you can quit with just a controller, e.g. on a Steam Deck in Gaming Mode or an Android handheld. On Android the game also leaves the recent apps list.
-
Graphics → Advanced, diagnostic options for broken 3D geometry (e.g. PowerVR GPUs, #207): "Convert vertices on the CPU", "Full precision in shaders" and "No vertex reuse", each off by default and applied after a restart. They help us find the cause on GPUs we can't test ourselves; the first one is slow and only meant for testing.
-
Mod SDK v3 preview: animated characters and scenes. Mods can add animated characters (a rigged glTF model with idle, walk, talk and extra clips) that look at Link, walk paths or to quest places, block Link and react to sword hits; mod code can drive them through a small C API. Scenes gain eased camera paths, follow shots, music, and the game's choice box with branches. Two original examples: a tide sprite on Windfall and a wandering creature (preview, for mod makers).
-
Mod SDK v3 preview: static mod models. A quest mod can now place its own static model (a glTF
.glbfrom Blender) in the world, lit and shadowed like the game's objects, with collision, L-targeting and a Check/Talk prompt. The model is converted on your own machine using a material from your own game, so packages never contain game files. The Windfall example gained an original carved post (preview, for mod makers). -
Android handhelds (thanks to almost-drowned-rat):
- Full screen now hides the system bars on Android 11 and newer too, so they no longer cover the top and bottom of the picture (based on GreenNaugahyde's Android fork; #212, #225).
- The app's files folder (saves, settings, mods) appears in the system Files app and file picker; the prepared game and shader caches are read-only there and console keys are never shown (#213, #226).
- The system Back button or gesture opens and closes Settings, like F1 on desktop (#215, #227).
-
Render-thread fast path (Vulkan): a draw reuses the previous draw's prepared state when only pointers or arithmetic values change, about 6–9% less render-thread CPU in tests (most on devices where the render thread limits the frame rate, like the Steam Deck), with identical pictures. On by default;
WWHD_VK_FASTPATH=0turns it off if you see wrong textures or blending, and please report it (#178). -
Android two-screen handhelds: GamePad screen Off frees the lower screen (#222). With the GamePad screen switched off, the lower screen is released to the launcher and other apps (e.g. a video on an AYN Thor); switching it back on takes it again with picture and touch.
-
Mods on Windows: a mod's preparation tool can now load its own helper files there too (the port's Python on Windows didn't look next to the tool). This stopped the GC minimap from installing on Windows; gc-minimap 0.2.2 also fixes it on its own for v0.3.0 (#224).
-
Settings → Shortcuts: remap the app's shortcuts (Settings, full screen, screenshot, save and load states, the graphics toggles), each with a key, a second key and a controller combination such as Select + D-pad Up. New actions (GamePad picture-in-picture, performance overlay, mute, volume) start unbound, and F6 now loads state slot 1. The defaults stay as they were (#220).
-
macOS setup: when macOS points to another developer folder than the installed Command Line Tools (a removed Xcode, or one whose license hasn't been accepted), setup now uses the installed tools directly instead of waiting forever, and says what to do if they still can't be used (#219).
-
Android, two screens (AYN Thor and similar): choosing GamePad screen Off (or hiding it) while the second screen is connected now turns that screen black and ignores its touches while the game plays on the main screen; the choice is remembered. Without that choice the second screen shows the GamePad as before (#222).
-
GamePad picture-in-picture placement: nine positions (corners, edge centres, centre) plus a custom one, exact size (10–50%) and opacity (20–100%), and a small screen diagram in Settings → Display where you tap or drag the GamePad picture into place; while that section is open the game shows a live, draggable preview. The default bottom-right position now sits above the rupee counter instead of covering it (#221).
-
Mod SDK v3 preview (opt-in, for mod makers): mods can place a small set of the game's own actors (chests, signs, a Windfall resident) with talk actions, and play short scenes: camera shots, dialogue, fades and the game's letterbox bars, skippable with Plus/Start. Placed chests and signs keep their state in the mod's own part of the save. Nothing changes without such a mod. See docs/mod-sdk-v3.md and the sdk-v3-windfall example.
-
Android: "Share log" in the setup app and in Graphics → Bug reports: it shares the latest game logs through Android's share sheet, with your user paths removed (as in crash reports). Android now writes a log by default (at most 64 MB per run), so there is one to share after a problem. The log also lists more about the GPU (driver, vertex formats, limits), and Graphics → Advanced has Force RGB vertex fallback for testing GPUs like PowerVR (#207).
-
Intel graphics on Windows: drivers older than 101.5000 now use the classic render-pass mode automatically, which fixes the crash at start on driver 101.3111 (Iris Xe) without setting anything (#204).
0.3.0
- Système de quêtes narratives : ajout d’un Story Notebook (journal dans le sac de livraison) listant les quêtes, avec mini-carte de la mer et marquage des objectifs.
- Livraisons de lettres : les quêtes modifiées envoient des lettres aux boîtes aux lettres Rito, avec des quêtes, objets ou cartes au trésor intégrées.
- Cartes au trésor modifiables : fonctionnalité native du jeu pour les cartes au trésor des mods (ouverture, navigation, crane et coffre).
- Mod SDK v2 : outils pour créer des quêtes (lettres, personnages, étapes, récompenses), des objets personnalisés (icônes, inventaire) et des cartes au trésor.
- Correction des sauvegardes : suppression des données résiduelles dans les logs de quêtes vides, préservation des inventaires sans mods.
- macOS (Apple Silicon, 14+) : package .dmg non signé, à lancer via System Settings (macOS 15+) ou clic droit (Open).
The Wind Waker HD, native PC port, v0.3.0
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows:
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway");windows-x86_64for x86-64,windows-arm64for Windows on ARM (Snapdragon X) - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file:chmod +xthe.AppImageand start it from anywhere (Steam Deck included); its game, code, saves and settings go to~/.local/share/wwhdand~/.config/wwhdinstead of beside it (Ubuntu 24.04+:libfuse2t64, or--appimage-extract-and-run) - Android (arm64, Android 13+, Vulkan 1.3): install the
android-arm64.apk(android-x86_64is for emulators and Chromebooks), choose your game in the app, and it builds the game on the phone (once, a few minutes). Signing certificate SHA-256:7F:F6:D3:5E:4E:45:11:5E:E4:93:65:EF:5B:40:C0:EB:83:EA:F7:6C:C1:1C:E9:67:F2:64:5C:50:4F:58:B2:13
See "Install (releases)" in the README for details.
v0.3.0: story quests and Mod SDK v2
New adventures on the Great Sea, made by the community. v0.3.0 brings a story system for quest mods, in the game's own style:
- The Story Notebook: a quest journal in the Delivery Bag. It lists your quests and shows each step, where to go and the reward. Every quest page has a mini sea chart, and you can mark a quest's goal on your sea chart.
- Letters at the Rito postboxes: quest mods send Link letters. Some bring a quest, some bring an item or a treasure chart.
- New treasure charts that work like the game's own: open the chart, sail to the light ring, use the crane, and get the chest.
- First quests in the mod catalogue: Call of the Sky (experimental) and The Old map. You install them in the game: Settings → Mods → Community. Setup installs the Story Notebook for you (it needs the internet once).
For mod makers: Mod SDK v2. Write quests with letters, characters, steps and rewards; add your own items, with icons in the bag, extra Delivery Bag pages and X/Y/R use; add treasure charts. Quests, letters, items and charts are declared in the mod's manifest; code is only needed for custom behaviour. Start with the Mod SDK guide and its worked examples.
Story quests are code mods, so they run on macOS, Windows and Linux for now. Android doesn't run code mods yet.
Also in this release:
- Graphics: a fallback for older drivers on Windows and Linux (Intel, older AMD), and one for PowerVR GPUs on Android.
- Android: a "Share log" button and system game modes.
- An optional extended enemy lock-on and a moon-jump cheat.
- Fixes for save states, the controller choice, ropes with frame interpolation and Wayland desktop scaling.
- Xbox and PlayStation button prompts with the Nintendo button layout.
The full list is below.
All changes
-
Controls: Xbox and PlayStation button prompts also with "By position" (issue #209, thanks @jamescastells): with the Nintendo button layout on an Xbox or PlayStation controller, the game's button icons now show the button that is physically in that place (for example the roll as a red B and the sword as a green A on an Xbox pad). Custom face-button mappings show the buttons they are bound to. The settings' help texts now explain the two options more clearly. "By label" and "Original" look as before.
-
Vulkan: a fallback for GPUs without 3-part vertex formats (issue #207, Pixel 10 Pro with a PowerVR GPU): some GPUs can't read three-component vertex data directly, which showed as "exploded" shapes and a black screen. The game now checks this at start and reads such data in two parts on those GPUs. Every other GPU keeps exactly the same shaders and caches as before.
-
Fixed: loading a save state switched the controller back to the one the state was made with (for example a GamePad state loaded while playing with a Pro Controller). Save states now keep your current controller, and the game follows it right away, without any menus: after loading a full state, or after switching the controller in the Input menu during play, Link moves with the controller you use and the button prompts match.
-
Fixed: after loading a save state, story mod pages fell back to their plain look (for example the Story Notebook's page). Their layouts are now built again right after the load.
-
Fixed: a story mod's treasure chart showed its X outside the map. The chart view shows a small window of the sea square; a mod chart now uses the window that contains its treasure spot, so the X sits on the map at the spot, on the TV and the GamePad.
-
Linux: sharp picture with desktop scaling on Wayland (issue #201, thanks @findel77): the game window now uses the screen's real pixel size, so with display scaling (for example 4K at 250%) the picture and the settings overlay are no longer rendered small and stretched. On older versions,
SDL_VIDEO_WAYLAND_SCALE_TO_DISPLAY=1works around it. -
Mods: development builds can install packages for the next release. A development build counts as the next version for the mod catalogue (for example v0.2.14 plus newer changes counts as 0.2.15), so packages that need the coming release, like the Story Notebook 0.6.1, install on it. Releases are unchanged.
-
Extended enemy lock-on (#192, PR #193, thanks @mhbxyz): Mods → Extended enemy lock-on, off by default. The enemy lock-on range can be raised to 1x–3x (saved per profile), and R3 while locked on to an enemy switches to the next eligible enemy, wrapping around. The game's own targeting still decides who can be targeted; talking distances to characters are unchanged.
-
For porters: more overlay switches (PR #205, thanks @Pulpparty): a port to another platform can now turn off code mods, mod downloads, the Speakers choice and the keyboard hints in the settings menu (
overlay::ext::Features). Nothing changes on Windows, macOS, Linux or Android. -
Fixed: ropes jittered with frame interpolation (issue #202, thanks @floysh and @JulianSK1999): the grappling hook's rope in Link's hand and rope bridges (for example on Outset Island in the title scene) were drawn at the exact game step while everything around them was drawn in between, so they jumped back and forth at 60, 120 or 240 fps. They now move smoothly with the rest of the picture. 30 fps and true 60 are unchanged.
-
Cheats: moon jump (idea from the GreenNaugahyde Android fork): in Gameplay → Cheats, off by default. Hold L to rise; the left stick steers relative to the camera. No fall damage after moon jump is a separate option. Works at 30 fps, with frame interpolation and in true 60; loading a state ends a flight.
-
Vulkan: textures a graphics driver cannot filter smoothly (some Android GPUs) are now sampled sharply instead of breaking Vulkan's rules. Every other device keeps the same filtering as before.
-
Fixed: leftover memory in the save file's empty Quest Logs. With story mods on, saving could copy leftover bytes into unused padding of the empty Quest Log slots. Those bytes are now always zero; the game never reads them, and the active Quest Log is unchanged.
-
Mod SDK v2: items and treasure charts for story mods (for mod makers; nothing changes without such a mod):
- Mod items: mods can declare their own items with names, descriptions, icons in the game's item pictures and stacks. Link keeps them in the Delivery Bag on extra pages, can put them in the bag's own places, and can put them, or the story notebook, on X, Y or R to use them. While Link has mod items, R in the Delivery Bag turns to the extra pages (L/R turn pages) instead of putting an item on R; X and Y still assign items.
- Treasure charts: a mod's treasure chart now works like the game's own: the light ring at its spot, the crane, the chest and its item (a game item or a mod item), then the chart counts as finished.
- Saves: mod items and charts are kept in the story mods' own part of the save, and turning the mods off shows the game's inventory exactly as before.
-
Story Notebook: a new look for mod quests (Mod SDK v2): the notebook's list and quest pages are now drawn as real game layouts, on the TV and the GamePad, with a mini sea chart on each quest page, the open book in the Delivery Bag and the game's own fonts. A quest's page says "Not started yet" with its first place, "Finished" when done, and offers "Show on chart" only for a step with a place on the sea chart. For mod makers: mods can give their items their own icons in the game's item pictures (built from your own game files on your machine).
-
Android: system game modes (idea from the GreenNaugahyde Android fork): the game declares Android's performance and battery-saving game modes, and the system no longer downscales the picture or overrides the frame rate, so the port's own resolution and frame pacing stay in charge.
-
Vulkan: a classic render-pass mode for older graphics drivers (issues #144 and #51): the game now also runs on Vulkan 1.1 / 1.2 drivers without dynamic rendering (for example older AMD drivers), and older Intel Windows drivers (before 101.2121), which crashed on dynamic rendering, use the classic mode automatically.
WWHD_VK_FORCE_RENDERPASS=1forces it for testing;=0turns it off. Everyone else keeps the current renderer path, with the same pictures and performance. -
Fixed: Windows setup stopped while linking when the folder name had an emoji or other special characters ("'charmap' codec can't encode character"). Setup now writes its linker file lists as UTF-8, so the game can be set up in any folder.
-
A new app icon (issue #199, thanks @thorazine111-coder): a sailing boat on the sea, original artwork, on Android (adaptive icon on Android 8+) and in the Linux AppImage. The game's own icon from your copy is still available as a home-screen shortcut (Android setup: Add the game icon to the home screen).
-
Story system for quest mods (letters, a quest notebook and sea-chart marks, in the game's own style). The port brings the system; all quest content comes from the mod catalogue:
- Story system (Mods > Built-in, on): it needs the Story Notebook package from the mod catalogue, which setup installs (it needs the internet once). If setup was offline, install it later in Mods: switch the Story system on, or press Install on its line. It's required for every quest mod and stays enabled. The game's start never goes online; without the package the story system stays inactive and the normal game is unchanged.
- Letters by Rito mail: a quest mod announces its quest with a letter from the Rito postbox, once Link has the Delivery Bag. The Story Notebook package's letter brings the story notebook.
- Story notebook: in the Delivery Bag. Its page lists every mod quest with the next step, where to go and its status, with an Archive tab for finished quests. "Show on chart" puts the game's red circle on the tracked step, also in the zoomed chart square, and it follows characters who walk around.
- Quests described as data: a mod's
manifest.jsonlists its quests, steps, places, characters and rewards. Steps can wait for story or item conditions ("Not yet possible: ..."). - Characters take part: a quest can give a resident new lines. When several quests want the same character, the game's own choice box asks which one. The King of Red Lions says a one-time line for the tracked quest. Residents are named by neutral ids; their names and places are read from your own game files.
- Mod charts: a quest can hand Link its own chart (by letter, in a conversation or as a reward). It appears in the MAP menu's chart list after the game's charts, opens in the game's own chart view with an X at its place, and gets the check mark when its treasure is found. "Open chart" in the notebook jumps there. Mod charts have their own numbers after the game's 61 charts and never touch the game's charts or save data.
- Progress is kept in the save file in a small block the game itself ignores. Removing the mods leaves a normal save. Details for mod authors in docs/mod-sdk-v2.md; the Story Notebook package and the example quest mods are in the mod repository.
0.2.14
- Nouvelle fonctionnalité macOS : les manettes Nintendo (Switch Pro Controller, Joy-Cons, SNES-style) affichent correctement les boutons A/B et X/Y via le mode "By position (Nintendo)", avec des icônes Nintendo et une correction des positions.
- Nouveautés majeures : ajout du stéréo 3D expérimental (Vulkan uniquement), de la sortie HDR (Windows avec Vulkan) et d’un réglage de FOV (75 % à 250 %) dans les paramètres graphiques.
- Nouveautés majeures : les ports peuvent désormais utiliser leur propre rendu graphique sans modifier le code existant via une interface d’extension.
- Correction importante : la barque tourne correctement avec le réglage "Sailing speed" activé, en conservant la vitesse boostée mais une réponse de gouvernail adaptée.
- Correction importante : suppression du doublon du réticule à 60+ FPS lors de l’utilisation du boomerang, du crochet ou du hookshot.
- Correction macOS : les fichiers de configuration et caches doivent rester dans le dossier décompressé après le déplacement de l’application (.app).
The Wind Waker HD, native PC port, v0.2.14
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows:
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway");windows-x86_64for x86-64,windows-arm64for Windows on ARM (Snapdragon X) - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file:chmod +xthe.AppImageand start it from anywhere (Steam Deck included); its game, code, saves and settings go to~/.local/share/wwhdand~/.config/wwhdinstead of beside it (Ubuntu 24.04+:libfuse2t64, or--appimage-extract-and-run) - Android (arm64, Android 13+, Vulkan 1.3): install the
android-arm64.apk(android-x86_64is for emulators and Chromebooks), choose your game in the app, and it builds the game on the phone (once, a few minutes). Signing certificate SHA-256:7F:F6:D3:5E:4E:45:11:5E:E4:93:65:EF:5B:40:C0:EB:83:EA:F7:6C:C1:1C:E9:67:F2:64:5C:50:4F:58:B2:13
See "Install (releases)" in the README for details.
What's new
-
The controller selection after the title screen is skipped (issue #189, thanks @floysh): the game no longer asks whether you play with the Wii U GamePad or a Pro Controller, because the port already knows it from Controls. It picks the matching option through the game's own selection, so everything that depends on it stays the same. To choose by hand again, turn off Controls > Skip controller selection.
-
GamePad screen "Automatic": follows the game's menus (from a play test): in the automatic GamePad screen mode, the GamePad picture now appears in the corner of the TV whenever the game opens something on the GamePad (items, maps, the collection, the Delivery Bag, save and options, song and warp lists) and goes away shortly after it closes. Before, it guessed from how much the GamePad picture changed and often missed the pause menu. Cmd+G still keeps it up, and Off-TV Play shows the GamePad picture full size as before. The other GamePad screen modes are unchanged.
-
PlayStation and Xbox button looks in the action hint near Link (issue #188, thanks @floysh): the floating hint that appears next to Link (for example "Speak" in front of a character) still showed the A button with PlayStation or Xbox button labels. It now uses the same shapes and colours as the button cluster in the corner. With the original look nothing changes.
-
Experimental stereo 3D, HDR output and a gameplay FOV setting (PR #168, thanks @pancreations): the Graphics tab gains Stereoscopic 3D (Vulkan only: Half SBS, Full SBS and top-and-bottom, with depth, convergence and eye swap; each eye renders its own view; 30 fps recommended for now), HDR output (Windows with Vulkan, when Windows HDR is on; falls back to SDR with a note if the display can't do it) and Gameplay FOV (75% to 250%; cutscenes, dialogue and menus keep their original view). All three are off / 100% by default, and the game looks and runs exactly as before until you turn them on. Settings are kept between launches, on macOS too.
-
Ports can bring their own renderer (PR #187, issue #185, thanks @Pulpparty): a platform port (for example a Switch build with deko3d) can now register its own renderer at start-up (
gfx/renderer_ext.h) without editing the renderer or GX2 code. Nothing changes for Metal and Vulkan: the renderer choice, menus, shader caches and performance stay as they were. -
Mouse buttons and the wheel can be bound in Controls (issue #165, thanks @PNOAGAMER): left, right, middle, side buttons 4/5 and wheel up/down are now bindable like keys, so the game can be played fully with mouse and keyboard together with the mouse camera (Mods > Built-in). Bound mouse buttons drive the game while the mouse camera has captured the pointer in the TV window; the settings menu, GamePad-window touch and text prompts keep the mouse as before, and "first person on the mouse wheel" keeps priority over wheel bindings. Nothing is bound by default.
-
Setup: disc images and Cemu's keys.txt (from a player support case): a
.wux/.wudneeds two keys, the disc key of your dump and the Wii U common key. Setup now accepts Cemu'skeys.txtdirectly and finds both keys in it (choose it once for either key), the disc key can also be pasted, and the keys screen explains this, including the no-key alternative (Cemu's "Convert to compressed Wii U archive (.wua)"). Clearer errors, e.g. when the common key was entered as the disc key. Key values are never shown, logged or saved. (Desktop setup; Android follows.) -
Android setup: keys.txt and safer key handling: the same
keys.txtsupport as on desktop (choose Cemu'skeys.txtonce, setup finds both keys). Key files are now only read when needed and no longer copied into the app; if a key file was moved or its access was lost, setup asks you to choose it again instead of failing. Setups started with an older version keep working. -
Less memory per shader translation (PR #184, thanks @Pulpparty): the shader translator reserves 1 MB of text per shader instead of 12 MB and grows only if needed (the largest game shader is far smaller), which helps devices with little memory. One of its text functions also no longer cuts long text short.
-
Building from a folder with spaces in its path (PR #183, thanks @Pulpparty): the shader translator and two tests no longer fail to compile when the checkout path contains a space (for example a Windows user name like
C:/Users/Jane Doe). -
macOS: Nintendo controllers have the right buttons (issue #181, thanks @Nickinfinity): with a Switch Pro Controller, Joy-Cons or an SNES-style pad, By position (Nintendo) had A/B and X/Y swapped, because macOS reports these pads by their printed letters. They now drive the right buttons and show Nintendo icons; a single sideways Joy-Con is handled too. If you swapped A/B and X/Y by hand as a workaround, choose Input > Face buttons > By position (Nintendo) or Automatic once after updating; your saved bindings are otherwise kept.
-
Steam Deck Gaming Mode: the settings menu stays open (issue #112, thanks @chaberl-art): with the TV and GamePad screens in two windows, the menu could close again right after opening. F1 now toggles once per press (a release is needed before it toggles again), keys and the save-state hotkeys (Shift+F1..F5 save, F2..F5 load) work from either game window, and switching focus between them clears held keys without closing the menu. The log now says why the menu opened or closed (
[overlay] closed (F1 key, window TV, ...)). In Gaming Mode the menu, the save-state messages and touch now follow the window that has focus, so they also show when the GamePad window is the one on screen (before, the menu could open there invisibly and hold Link in place). -
Settings overlay: extension points for other platforms (PR #175, thanks @Pulpparty): ports such as the community Switch port can add their own settings tabs, hide built-in ones, plug in a system keyboard, controller shortcuts and on-screen layers, without changing the overlay's code. Nothing changes on our platforms.
-
The aiming reticle no longer doubles at 60+ fps (issue #163, thanks @Julancho): with the boomerang, grappling hook and hookshot, the red aiming dot (and the boomerang's target markers) stayed at the game's 30 Hz position while the camera moved smoothly between frames, so it jumped back and forth during camera turns. It now moves with the camera; 30 fps is unchanged.
WWHD_RETICLE_FIX=0turns the fix off. -
No crash when memory for a shader's source runs out (PR #171, thanks @Pulpparty): the shader translator's text buffer now handles failed allocations (the shader just fails to compile and is retried) instead of writing through a null pointer. Mostly matters on devices with little memory.
-
Android: setup works again on the development build. Since the decomp version arrived in setup, the app's setup stopped right away ("No module named 'decomp_setup'"); the missing file is now packed with it. Also clearer game-icon hints: "already on the home screen" for the plain icon too, and wording that fits every launcher (PR #170, thanks @rhemfur).
-
Android setup polish (from the tester report on PR #98, thanks @rhemfur): the "Rebuild shader cache" hint names the right button on each platform (on Android: Start / resume / retry setup); tooltips no longer stay on touch screens; setup's own step reads "Reading shaders from your game files" so it doesn't look skippable, and its notification brings setup back to the front; after an app update, setup shows "Updating the game for the new version".
-
Fixed: the boat barely turned with "Sailing speed" on (issue #169). The game turns the boat more slowly the faster it sails, so the boosted speed hit its minimum turn rate. The rudder now responds like at normal speed for both sails, while the boat keeps its boosted speed; automatic wind and the jump height are unchanged.
-
Game code built with
-fwrapv(PR #172, thanks @Pulpparty): PowerPC integer arithmetic wraps around, and the compiler now guarantees the same for the recompiled game code, the decomp version and the verify tools, instead of relying on the code never overflowing. No visible change. -
Fixed: "Invert camera up/down" also inverted the Wind Waker baton (issue #167). The setting now applies only to the camera, including first-person views and item aiming (bow, hookshot, telescope, Picto Box) and the mouse camera (which now follows it too); the baton and other right-stick controls keep their normal direction.
-
Fixed: stutter at 240 fps and a slow start with "Keep game speed" (issue #164). Since v0.2.13 the game's 30 logic steps drifted against the display (59.94 Hz), so every few seconds the in-between frames bunched up and the picture hitched; the steps now follow the display's refresh. A hitch right after starting could also keep all in-between frames off (30 fps) until the frame rate was changed; that measurement is now retried. Slower PCs keep v0.2.13's smoother pacing (#125).
-
Mods tab: Built-in and Community. The Mods list is split into Built-in (the options that come with the game, such as the camera and speed options) and Community (mods from the mod catalogue, installed or ready to download, plus imported packages and graphics packs); More is unchanged. Mods now use the game ID
wwhdfor both regions; older manifests withwwhd-usakeep working. -
Fixed: Call of the Sky could not be switched on from the catalogue. After confirming the experimental warning, the install stopped with "confirm the warning first", because the save backup was skipped. The backup now always runs once before the mod is switched on, and a failed backup shows its reason.
-
Fixed: a red "conflicting ID" box in Mods › More (Code-mod support). Release builds also no longer show this debug highlight.
-
Fixed: controllers stopped responding in the game after the settings overlay or the name screen (issue #153). If a trigger or stick did not fully return to rest, the game ignored all input after closing the overlay or entering a name until the controller was reconnected. Now only the button that closed it waits for its release; everything else reaches the game at once.
-
Linux AppImage: portable use now uses the AppImage's standard portable mode (issue #55). Start the AppImage once with
--appimage-portable-home, or create a folder named like it plus.homenext to it (e.g.WindWakerHD-…-linux-x86_64.AppImage.home); the game, its code, saves, settings and caches then stay in that folder. If you used the….AppImage.datafolder from v0.2.13, it is no longer used; to keep your saves and settings, move its contents before starting the new version:….AppImage.data/share→….AppImage.home/.local/share,….AppImage.data/config→….AppImage.home/.configand….AppImage.data/cache→….AppImage.home/.cache, then start the AppImage once with--setup. -
Share your shader coverage: Settings › Graphics › Export shader template (desktop) or
tools/shaderprep.py exportsaves a code-freemy-template.bin(shader hashes and GPU settings only, no game code) from your own shader caches, so it can be contributed to the template that setup uses to prepare shaders.shaderprep.py templateno longer fails with "invalid recipe bounds" on long-played or Vulkan caches and skips damaged records instead of stopping. -
European GameCube saves can be converted to HD (
tools/savegame/gc2hd.py): PAL saves (GZLP01) are accepted, names with accents (and Œ/œ) come through, and the save's language is kept. The convertedcking.savworks with both the USA and the European HD game. -
Android handhelds and controllers (issue #152, thanks @OTPR26):
- Settings with a controller: holding Select/− now opens the settings after half a second as intended (it could take about 3 seconds on some devices), and a one-time hint says so.
- Touch buttons hide with a controller: the view and 🎮 buttons hide while a controller is connected (built-in or external) and come back for a few seconds with a tap in their corner. Settings › Display › Touch buttons: Automatic / Always show / Hide.
- AYN Thor / Odin built-in controls: A, B, X and Y now sit in their Nintendo positions, all four
can be bound in Controls, and empty bindings in
controls.jsonare repaired. - Larger settings on phones and handhelds: the settings fill most of the screen with bigger buttons, sized for the screen; Settings › Display › UI size (Automatic / Small / Medium / Large). The desktop look is unchanged.
- Texts say "Android device" instead of "phone", and the log names how Android reports a controller.
-
Fixed: Windows setup failed in deep folders (issue #144), for example in Downloads after Windows' "Extract All" puts the folder inside a folder of the same name. The compiler now unpacks with long paths, and the game and setup use much shorter names for shader caches, temporary files, code-mod builds and save backups (existing caches are reused or rebuilt automatically). Only a folder deeper than 175 characters makes setup stop right away, before downloading anything, and ask you to move it to a shorter place such as
C:\Games\WindWakerHD. -
Development builds (macOS): setup can also build the decomp version (experimental, off by default). A checkbox in setup (or
--decomp) builds, next to the normal game, a version in which the game functions of the public decompilation run as compiled source; it is built from your own game on your Mac, and the normal game is always built first and stays the default. Choose which one starts in setup, or start Wind Waker HD with--decomp. Setup downloads the decompilation's source (about 8 MB, only when the option is on) from its GitHub repository and checks it before use; the release itself does not contain it. The decomp build now uses the readable decompilation; its model data is generated from your game at build time. Regular releases are unchanged. -
Fixed: unreadable shoulder labels on the HUD (issue #143). With L1 R1 L2 R2 or LB RB LT RT as shoulder names, the labels on the HUD's shoulder buttons were white on the white plates; they are now dark like the game's own letters again (and dim the same way). Dialog labels are unchanged.
-
Mods tab redesign. Every mod has an on/off switch in one list, including mods you haven't downloaded yet: switching one on downloads it, sets it up and turns it on. When something is needed, one review asks it all at once (your GameCube game, choices, code-mod support, the experimental warning), then one progress view follows and keeps running while you play. Mod pages explain in one line why something can't change right now instead of showing greyed buttons; updating keeps a mod on or off as it was; Remove also deletes a mod's prepared files and says how much space that frees. The mod list loads by itself (cached, checked in the background; only the public list is fetched). Rarely used things (profiles, install from a file, GameCube game, code-mod support, save backups, mod list source, cheats) are under Mods › More.
-
Experimental: build the game from the decompilation (macOS, for developers). The CMake option
WWHD_DECOMP=ONcompiles the game code from the public, verified decompilation (ZeldaWWHDDecomp/wwhd, a submodule indecomp/) instead of recompiling it; the libraries stay recompiled from your game. It plays identically to the normal build but still uses more CPU, so releases stay recompiled. Off by default: normal builds are unchanged. See docs/decomp-build.md. -
Fixed: aspect ratios other than 16:9 (PR #146, thanks @fluxehub). At 16:10 (and 4:3) the extra height now shows more of the view above and below instead of cropping a 16:9 picture, and the HUD sits at the real screen edges. At 21:9 and 32:9 the button cluster and the Wind Waker's "Back" prompt keep the same distance from the edge as at 16:9, and the Wind's Requiem screen fills the whole screen instead of showing dark side bars. Layouts drawn to both the TV and the GamePad no longer flicker between the two aspect ratios, and Vulkan no longer leaves the last pixel row black at 16:10 with 1.5x. 16:9 is unchanged.
-
Android: a menu on the game widget and an "Add the game icon" button (PR #150, thanks @rhemfur). Long-press the home-screen widget, then Settings (Samsung) to export or import the save or open the game setup. The setup screen has Add the game icon to the home screen under Play for players who declined or removed it, and the automatic offer now waits until the setup screen is in front, so Android no longer refuses it on some phones. Spanish texts for these and the save export/import.
-
New gameplay mods: faster ladders, faster sidling, sailing speed and automatic wind (issues #95, #96; all off by default, Mods tab and the macOS Gameplay menu). Ladders and sidling play faster with the animation in step (1–3×); sailing speed has separate settings for the normal sail and the Swift Sail; Automatic wind makes the normal sail behave like the Swift Sail (the wind follows the boat). With the mods off the game is unchanged.
-
Fixed: ZL/ZR (LT/RT, L2/R2) prompts in dialogs showed as a white box with the face buttons set to by label (issue #141). The shoulder labels in dialogs are now drawn as pictures like the game's own icons, in every language.
-
Button prompt options (issue #143, Controls tab of the settings overlay and the macOS Controls window): Button prompts Automatic / Original / Xbox / PlayStation (Automatic shows PlayStation shapes on a PlayStation pad), Shoulder names Automatic / L R ZL ZR / L1 R1 L2 R2 / LB RB LT RT, and Coloured face buttons (on by default; off keeps the game's white buttons). The PlayStation shapes are drawn by the port, no images are included. Unassigned (dimmed) HUD buttons now keep their shape visible, and the prompt strokes are a little bolder.
Checksums (SHA-256)
42ff2863b17cfead3dd51821740beaeb1433c7a607e000b94d214c60096a6209 WindWakerHD-v0.2.14-linux-aarch64.zip
5f796f3719f046d8bfaf309da51532de7cdc1251896c01930931b188053670bf WindWakerHD-v0.2.14-linux-x86_64.zip
bc9681fcc788a6e50c27446e83c9b1c80d72e2c691653b966718a9ce744ade6e WindWakerHD-v0.2.14-macos-arm64.zip
a5694c20037de4ce4cd7970100a753dfc091529dc4b96ea473d271c94714c4e7 WindWakerHD-v0.2.14-windows-arm64.zip
bddd21a19359eb403615dd4d9fd6e62b6904be393652eec4aab3e07d8ab02f9d WindWakerHD-v0.2.14-windows-x86_64.zip
26623a152f8063a90e5fee38495712fe543df5386e52d52a046e50b49a020453 WindWakerHD-v0.2.14-linux-aarch64.AppImage
56c58ce0d58e9b4e6665fac13f29ce5d3622a6a7c4ac3f205bd5de7dae648c06 WindWakerHD-v0.2.14-linux-x86_64.AppImage
a401151bb5450dc4e094dabc5336d2d3b6e0ae11b396068bcd51440a5bf2cb6d WindWakerHD-v0.2.14-android-arm64.apk
2bc5011c39b78df9315abec44b255c2aff1af74fb8e705290f7a09f76ef8514a WindWakerHD-v0.2.14-android-x86_64.apk
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.2.14-linux-aarch64.zip: 0 of 66 engines flag it, reportWindWakerHD-v0.2.14-linux-x86_64.zip: 0 of 66 engines flag it, reportWindWakerHD-v0.2.14-macos-arm64.zip: 0 of 67 engines flag it, reportWindWakerHD-v0.2.14-windows-arm64.zip: 0 of 67 engines flag it, reportWindWakerHD-v0.2.14-windows-x86_64.zip: 0 of 67 engines flag it, reportWindWakerHD-v0.2.14-linux-aarch64.AppImage: 0 of 62 engines flag it, reportWindWakerHD-v0.2.14-linux-x86_64.AppImage: 0 of 58 engines flag it, reportWindWakerHD-v0.2.14-android-arm64.apk: 0 of 39 engines flag it, reportWindWakerHD-v0.2.14-android-x86_64.apk: 0 of 58 engines flag it, reportWind Waker HD.exe: 1 of 69 engines flag it, reportWind Waker HD.exe: 0 of 71 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (MaxSecure), reported to the vendors as false positives; see issue #58.
89
- Ajout d’un runtime type2 statique pour les AppImages Linux (v0.2.13) avec intégration de libfuse, squashfuse, zstd, zlib et mimalloc.
- Correction des problèmes de compatibilité avec les builds Linux via AppImage en verrouillant une version précise du runtime.
Pinned build input for our Linux AppImages: the AppImage type2-runtime from https://github.com/AppImage/type2-runtime/commit/8f39b89 (continuous build of 2026-09-28), the exact runtime v0.2.13 shipped. MIT licensed (see type2-runtime-LICENSE.txt); it statically links libfuse (LGPL-2.1), squashfuse (BSD-2), zstd, zlib and mimalloc; source: https://github.com/AppImage/type2-runtime/tree/8f39b89. Not a game release — downloads for players are on the other releases.
SHA-256:
- runtime-x86_64: 156f4bdbde9c52d01814600013e0a273f0118dc2de98975f3c8c63427ec79074
- runtime-aarch64: b4ff0030242d0c3bb12ce40541828303cf167493f4793456f0436edd6255c39d
0.2.13
- macOS (Apple Silicon) : Fichier .dmg non signé pour macOS 14+ (M1/M2/M3), à lancer via Privilèges ou clic droit → Ouvrir ; conserver l’application dans son dossier décompressé.
- Amélioration des performances : Préparation des shaders avant le premier lancement (réduction des stutters initiaux), avec compilation parallèle sur plusieurs cœurs (ex. : 10 s au lieu de 4 min sur Mac Apple Silicon).
- Mods expérimentaux et sauvegardes : Mods marqués Expérimental (ex. : Call of the Sky) masqués par défaut, sauvegardes automatiques avant activation, et gestion des sauvegardes dans l’onglet Mods.
- Correction des bugs critiques : Flickering de Link lors des conversations, portes rapides bloquées par les spores, et ombres floues à haute résolution.
- Contrôles améliorés : Prompts de boutons adaptés au contrôleur (ex. : étiquettes A/B/X/Y en vert/rouge/bleu/jaune), et réglage du Stick range pour les sticks usés.
- Audio : Ajout d’un curseur de volume maître avec boutons Mute et Réinitialiser.
The Wind Waker HD, native PC port, v0.2.13
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows:
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway");windows-x86_64for x86-64,windows-arm64for Windows on ARM (Snapdragon X) - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file:chmod +xthe.AppImageand start it from anywhere (Steam Deck included); its game, code, saves and settings go to~/.local/share/wwhdand~/.config/wwhdinstead of beside it (Ubuntu 24.04+:libfuse2t64, or--appimage-extract-and-run) - Android (arm64, Android 13+, Vulkan 1.3): install the
android-arm64.apk(android-x86_64is for emulators and Chromebooks), choose your game in the app, and it builds the game on the phone (once, a few minutes). Signing certificate SHA-256:7F:F6:D3:5E:4E:45:11:5E:E4:93:65:EF:5B:40:C0:EB:83:EA:F7:6C:C1:1C:E9:67:F2:64:5C:50:4F:58:B2:13
See "Install (releases)" in the README for details.
What's new
-
Linux AppImage: a portable mode (issue #55, idea by @missionfloyd). Create a folder named like the AppImage plus
.datanext to it (e.g.WindWakerHD-…-linux-x86_64.AppImage.data), and the AppImage keeps the game, its code, saves, settings and caches there instead of in~/.local/share,~/.configand~/.cache. Without that folder nothing changes. -
Profiling on Windows on ARM64: a sampling profiler for the frame threads (PR #147, thanks @rhemfur). Off unless
WWHD_SAMPLE_THREADS=is set;tools/bench/thread_profile.pyturns the samples into a report by module and function, including time inside the Vulkan driver, without administrator rights. See docs/performance.md. -
Android: a friendlier setup screen, and the app icon starts the game (PRs #128 and #129, thanks @rhemfur). Setup now guides you step by step in English, Portuguese or Spanish ("Choose your game", "Preparing the game for your phone… 20 of 80 · about 3 min left", "Your game is ready"). Once a game is set up, the app icon starts it directly ("Game setup" stays available by long-pressing the icon), and the phone offers a home-screen game icon with the game's own picture, made from your game files.
-
Fixed: crash with Quick doors when leaving a room with spores (issue #145), for example at the first door in the Forbidden Woods. Quick doors ran the spores' fade-out faster than the game draws, so their effect was removed while still queued for drawing. Doors now wait for the weather effect to finish fading (rain, stars, spores, fog and waves) and stay fast otherwise.
-
Windows, Intel UHD graphics: a workaround for a crash in Intel's Vulkan driver a few seconds after start (issue #144). On Intel GPUs every render-target view now states its purpose explicitly;
WWHD_VK_ATTACHMENT_VIEW_USAGE=0turns it off, andWWHD_VK_TRACE_PASSES=1logs each render pass once for crash reports. -
Fixed: shadows switching between sharp and blurry at high internal resolutions (issue #135). Above 1x, the sun-shadow pass rebuilt surface normals from rays one console pixel apart but depths one screen pixel apart, so depending on the camera angle shadows smeared and Link could get a dark outline. The pass now uses matching spacing, so shadows at 2x, 3x or 4K look like at 1x, only sharper.
-
Fixed: Android GPU crashes ("device lost") on some Adreno phones (issue #104). The precise GPU barriers that v0.2.12 turned on for Android caused occasional crashes with Mesa Turnip on an Adreno 650 and gave no measurable speed-up, so they are off by default again on every platform (
WWHD_VK_NARROW_BARRIERS=1still turns them on). Thanks to @rhemfur for the measurements. -
Fixed: setup stopped with "the recompiler wrote no code" (issue #136) when the install folder's path contains square brackets, for example
...\LoZ - The Wind Waker [WiiU]\data. Setup and the recompiler treated the brackets as a search pattern and then found none of their own files. -
Android setup: "Continue anyway" when it waits for the phone to cool down (issue #142). The pause now shows the battery temperature and Android's thermal status, waits only at 45 °C battery temperature (42 °C if Android also reports the phone as warm) or when Android reports it as hot, and a Continue anyway button (also on the low-battery pause) lets you go on for this run. Only Android's critical heat level still stops setup.
-
Mods: experimental mods and save backups. Mods marked Experimental (untested, may break the game or a save made while they are active; Call of the Sky is one) are hidden unless you turn on Show experimental mods in the Mods tab. Turning one on asks first and backs up your saves before it is enabled. Mods → Save backups lists the backups (the newest 10 automatic ones are kept; Back up now backups are never removed), can restore one at the next start, before the game loads any save (your current saves are backed up first, so a restore can be undone), or delete one.
-
Setup: "Preparing shaders" is much faster and shows real progress. The release now includes the native decoder for the game's compressed archives (before, setup unpacked them in slow Python) and scans them on several cores: about 10 seconds instead of about 4 minutes on an Apple Silicon Mac, with an identical result. The bar now fills as it works ("400 of 818 game archives", then the shaders and pipelines compiled), and Vulkan compiles pipelines on several threads. On Android the app now ships the same native decoder, so preparation on the phone is much faster as well.
shaders and pipelines compiled), and Vulkan compiles pipelines on several threads.
On a Mac, setup now prepares both Metal and Vulkan, so either renderer starts without first-time shader stutter.
-
Controls: in-game button prompts follow your controller (PR #110, thanks @mhbxyz). With Face buttons set to by label (or Automatic on an Xbox-style pad), dialog icons and HUD buttons use green A, red B, blue X and yellow Y, the HUD button cluster uses the Xbox positions, and shoulder prompts read R1/R2 and L1/L2 in the game's own lettering. By position keeps the original look.
-
Controls: a "Stick range" setting per stick (issue #40). For a worn stick that can't reach full deflection: raise its range (100–150 %, default 100 %) in Settings → Controls or the macOS Controls window until the input reaches full tilt, for example the Wind Waker baton's directions. It's applied after the dead zone and keeps the stick's direction.
-
Mods: a "Restart required" popup. Changes that only take effect after a restart (turning packages, graphics packs or code mods on or off, their settings, profiles, a finished one-click setup, a code-mod rebuild) now show a popup with Restart now and Later, and the Mods tab keeps a "Restart to apply" line until you restart.
-
Fixed: one-click mod setup stopped with "Package changed; refresh it and confirm its code again" after a preparation step, e.g. for the GameCube sea minimap. The mod's Python tool left cache files in the package, which made the package look changed. Setup tools now run without writing them. If you already hit this, refresh the mod in the catalogue (or delete its
tools/__pycache__folder) and press Try again. -
Vulkan: choose your graphics card in Settings → Graphics (issue #135), e.g. on laptops with an Intel and an NVIDIA GPU. The choice is remembered and applies after a restart; if the chosen card is no longer available, the game picks a usable one and says so.
WWHD_VK_DEVICE(an index or part of the name) overrides it for one start. -
Fixed: the 60, 120 and 240 fps settings dropped to about 30–50 fps on PCs that can't quite draw 60 frames a second (issue #125). A frame that misses its display refresh is now shown as soon as it's ready instead of waiting a whole extra refresh, so you get close to what Uncapped shows (e.g. 56 instead of 30 fps). Frames that are on time are paced exactly as before.
-
Fixed: the Picto Box picture stayed blurry (issue #134). The left stick zooms the Picto Box, and the game blurs the picture while zooming, so even a slightly drifting stick kept it blurry. Controller sticks now have a 15 % dead zone by default (Settings → Controls; a saved 0 from older versions becomes 15 %, an explicitly chosen 0 stays). On Metal, the photo's subject outline could also miss pixels the first time; that's fixed too.
-
Less stutter on first play: setup now prepares the shaders. After building the game, setup runs Preparing shaders: from your own game files and a small, code-free list of the game's GPU states that comes with the release, it compiles the shaders and pipelines before you play (about 15–20 s on a recent Mac). In our tests the cold first-play hitches over 50 ms went from 5–10 to 0. You can skip it in setup, and Settings → Graphics → Rebuild shader cache prepares a fresh one. Areas that aren't covered can still stutter once. On Vulkan, shaders and pipelines are also compiled in the background while you play, and the pipelines you used are rebuilt at the title screen on the next start. Your existing caches are kept when you update.
-
macOS setup: works with mismatched Command Line Tools (e.g. after a macOS beta update installed a newer SDK than the tools' linker understands: "unknown architecture arm64e.x1", "tapi error: malformed file"). Setup now links with an older installed SDK automatically, or explains how to update the Command Line Tools.
-
Audio: a master volume slider (PR #137, thanks @mhbxyz, issue #124). Settings → Audio has a Master volume slider with Mute and Default buttons. It applies immediately and is remembered for the next start.
-
Fixed: Link flickered during some conversations at 60, 120 and 240 fps (issue #126). When the camera looks over Link's shoulder, the game hides him for that shot, but the in-between frames drew him again. He now stays hidden on every frame, also in true 60. 30 fps is unchanged.
-
Faster game code: about a quarter less CPU time in the game's own code (PR #83, thanks @depende3000). The recompiler now keeps the game's registers in local variables, stores only the condition bits that are read later, and uses cheaper float compares. Measured per game step: −28 % on an Apple Silicon Mac, −14.5 % on a Galaxy S25 Ultra. Setup takes about 20 seconds longer to generate the game code. With code mods switched on, the game code stays as before for now.
-
Fixed: Cemu graphics packs that write their title IDs without leading zeros were refused (issue #123), e.g. the "Playstation UI" pack (
titleIds = 5000010143600). The IDs are now compared as numbers, the way Cemu reads them. -
Run/swim speed: a reworked boost (PR #133, thanks @mhbxyz). Separate multipliers for running (1.5x by default) and swimming (1.25x), hold or toggle, and a stamina bar: a boost lasts 5 s by default and refills over a 3 s cooldown (set stamina to 0 for the old unlimited boost). A ring under the climb wheel shows it. The boost ramps in, and Link's legs keep up with the ground instead of skating (true 60 included). Options in Mods > Run/swim speed: use the dash clip instead of walking, or a sprint pose with a forward lean and wider arm swing. Boosted runs kick up dust, and a boosted surface swim becomes a crawl with splashes and foam, all with the game's own effects. Saved settings carry over.
-
Fixed: setup's last screen briefly asked about the shortcut again after Play (PR #130, thanks @rhemfur). Once Play or Quit is pressed, the screen shows "Starting the game..." instead of the options; what you had chosen is still done.
-
Windows on ARM: a native
windows-arm64release (PR #131, thanks @rhemfur), for Snapdragon X laptops and other ARM PCs. 60 fps keeps the game at full speed there by default ("Keep game speed", as on Android). The x86-64 release still runs on these PCs too, emulated.
Checksums (SHA-256)
1c8669d49f9539547270abd108d254c4c141123de2a31a0cac8a389912fef9f0 WindWakerHD-v0.2.13-linux-aarch64.zip
50a6f208c62ea8f5b25c9ba63c2a0b625693b48b2655b88a1b345afc633f421e WindWakerHD-v0.2.13-linux-x86_64.zip
0f3d6bc195cdcdc4846b327e09df9e948d3f77cd3501cd1434a9f89096985d51 WindWakerHD-v0.2.13-macos-arm64.zip
b5b4479354634e28cb2a18ebee6d499d8ee54b14ce874bb8f601f216ca32c535 WindWakerHD-v0.2.13-windows-arm64.zip
9b5e157c62a746b6f0e4f3aa32df16adb3f40f293fa27232aee037e0b1f9e7cc WindWakerHD-v0.2.13-windows-x86_64.zip
729f93e32e43d9ad2a56468c131fc0ff8929226238f6ec44cc46c6dca764551d WindWakerHD-v0.2.13-linux-aarch64.AppImage
34d6f0a1b9fc0cf66017e8c8175f72acac108332da87fa3d02d1dd839bdc06c6 WindWakerHD-v0.2.13-linux-x86_64.AppImage
7cca16bfea663831ed1a58c3a204015d04967df68f22395e2ae58fc0c15d1747 WindWakerHD-v0.2.13-android-arm64.apk
e9d4583d76fa7d21e89ba0aaf9047e04e17322c4c040ff99752f5e15bcfd3587 WindWakerHD-v0.2.13-android-x86_64.apk
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.2.13-linux-aarch64.zip: 0 of 62 engines flag it, reportWindWakerHD-v0.2.13-linux-x86_64.zip: 0 of 62 engines flag it, reportWindWakerHD-v0.2.13-macos-arm64.zip: 0 of 67 engines flag it, reportWindWakerHD-v0.2.13-windows-arm64.zip: 0 of 66 engines flag it, reportWindWakerHD-v0.2.13-windows-x86_64.zip: 1 of 67 engines flag it, reportWindWakerHD-v0.2.13-linux-aarch64.AppImage: 0 of 63 engines flag it, reportWindWakerHD-v0.2.13-linux-x86_64.AppImage: 0 of 64 engines flag it, reportWindWakerHD-v0.2.13-android-arm64.apk: 0 of 51 engines flag it, reportWindWakerHD-v0.2.13-android-x86_64.apk: 0 of 52 engines flag it, reportWind Waker HD.exe: 1 of 69 engines flag it, reportWind Waker HD.exe: 1 of 70 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (MaxSecure, VIPRE), reported to the vendors as false positives; see issue #58.
0.2.12
- Ajout d’un mode fast-forward pour les cutscènes et dialogues (actif via ZR, réglable en 2×, 3× ou 4×).
- Surround 5.1 activable en option audio (test des enceintes intégré et compatibilité avec les sorties Wii U).
- Mods : catalogue intégré avec installation/rafraîchissement sur demande, suivi des étapes de setup (état "Done"/"To do").
- Mod SDK v2 étendu : gestion des streams audio, affichage HUD (textes/images), et nouvelles fonctionnalités pour les mods PowerPC (ex. : minimap GameCube).
- Crash dans la salle de Ganon-Poupée (Vulkan) résolu via prise en charge des textures couleur pour les comparaisons de profondeur.
- Problèmes de menu : stick gauche désactivé en zone morte pour éviter les défilements involontaires, annulation de la fermeture du menu avec B.
- Compatibilité mods : suppression des conflits entre packs graphiques Cemu, affichage des changements après redémarrage.
- Icone du jeu restaurée (générée à partir des fichiers du jeu, pas incluse dans la release).
The Wind Waker HD, native PC port, v0.2.12
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file:chmod +xthe.AppImageand start it from anywhere (Steam Deck included); its game, code, saves and settings go to~/.local/share/wwhdand~/.config/wwhdinstead of beside it (Ubuntu 24.04+:libfuse2t64, or--appimage-extract-and-run) - Android (arm64, Android 13+, Vulkan 1.3): install the
android-arm64.apk(android-x86_64is for emulators and Chromebooks), choose your game in the app, and it builds the game on the phone (once, a few minutes). Signing certificate SHA-256:7F:F6:D3:5E:4E:45:11:5E:E4:93:65:EF:5B:40:C0:EB:83:EA:F7:6C:C1:1C:E9:67:F2:64:5C:50:4F:58:B2:13
See "Install (releases)" in the README for details.
What's new
-
Android: the app is now part of every release and development build. Download
WindWakerHD--android-arm64.apk(x86_64 for emulators and Chromebooks), install it, choose your game, and setup builds the game on the phone. The APK contains no game code. It is signed with the project's key (certificate SHA-2567F:F6:D3:5E:…:B2:13, full value in the release notes), so later versions install as updates. -
Mods: one-click setup. Tick a mod (or press Set up), confirm once, and its setup runs by itself: for example the GameCube sea minimap prepares its island maps and builds itself, then turns on. If the game code first needs code-mod support, the game rebuilds and restarts and the setup continues afterwards. If a step fails: Show details and Try again. Changed packages ask for confirmation again.
-
Menu and on-screen keyboard: confirm and cancel like in the game (PR #118, thanks @rhemfur). With the default face-button preset (by position) the right button confirms and the bottom one goes back, as in the game; the on-screen keyboard types with the game's A and deletes with B. "By label" and "Automatic" are followed too.
-
Android player guide in English, Portuguese and Spanish (PR #122, thanks @rhemfur): docs/android.md.
-
Diagnostics for menu input problems (issue #111):
WWHD_OVERLAY_TRACE=1logs what the settings menu receives from the controller and every scroll change;WWHD_OVERLAY_MOUSE_HANDOFF=0turns the mouse takeover off for such a test. Steps in docs/overlay-controls.md. -
Mods tab: installed catalogue mods show where their setup stands. Each step reads "Done" or "To do" (for example the GameCube game step is done once you set it), with a Go to setup button that jumps to the mod's setup; "Up to date" replaces the greyed-out Update button.
-
Fixed: the game didn't start with a content mod (for example a translation) in the development builds (issue #109). The mod manager switched the replacement files on twice at startup and stopped with "Content overrides already activated". Content mods and code mods now start together as they should.
-
Bug reports: the log now lists every connected controller (name, vendor and product ID, type), on connect and disconnect. The game combines all controllers Windows/Linux report, so this shows when a second device (e.g. Steam Input's virtual controller) is also sending input.
-
Android: set up the game directly on the phone, no PC needed (PR #98, tested by @rhemfur). Choose your game (an extracted folder, a WUA or a WUD/WUX), and the phone translates and compiles the game code itself (several minutes; up to 4 compiler workers depending on the phone), with a progress display. Setup pauses when the phone gets too warm or the battery is low, and resumes where it stopped. Also new: the GamePad picture on a second screen (foldables, external displays).
-
Mods: one setting for the GameCube version of the game. Settings → Mods → GameCube game for mods: choose your GameCube Wind Waker disc image or folder once (it shows the recognised region), and every mod that needs it uses it. A mod whose copy is missing can't be enabled and offers a button to that setting. Changing the copy marks the affected mods for setup again (prepared files are kept).
-
Android: on-screen controls (PR #88, thanks @rhemfur). Phones without a controller can now play: the 🎮 button under the view button (top left) shows or hides two sticks, the D-pad, A B X Y, L R, ZL ZR and + − (remembered). They act like a controller, so the button mapping and a physical controller keep working; with a controller connected they hide until you touch the screen.
-
Controls: an Automatic face-button preset (PR #102, thanks @mhbxyz). It reads the labels printed on the pad that was plugged in first and follows them, so an Xbox or PlayStation pad plays by label and a Nintendo pad by position, without touching the setting.
-
Mods tab: a "Reset to default" button for the catalogue address. It puts back the official mod catalogue if the address was changed. Download errors now also show the server's status code (for example "HTTP 404"), so a wrong address is easier to tell apart from a connection problem.
-
Setup can now build with code-mod support right away. A new "Build with code-mod support" option (off by default) saves the second rebuild when you want code mods. Updates and repairs keep your choice, and Settings → Mods shows it immediately. Details: docs/setup-code-mods.md.
-
Fixed: the settings menu scrolled back up after the left stick had been used (issue #111). A left stick that rests slightly off-centre kept scrolling the menu, even while you scrolled with the mouse. Now the mouse takes over as soon as you move, click, scroll or drag the scroll bar; the controller takes over again with its next new input. Controls: docs/overlay-controls.md.
-
Fixed: in development builds every catalogue mod showed "Unavailable for this port version". Development builds now carry the last release's version plus the commit (for example
v0.2.11-devel.1a2b3c4d), so the catalogue can check compatibility. -
macOS: the game has its icon again. Setup now gives the installed app the game's own icon, made from your game files (the release can't ship it), and the game shows it in the Dock while it runs. Existing installations get it with the next update or repair.
-
macOS: Vulkan is now included in the release. Pick it in Graphics > Renderer; nothing to install. The Vulkan loader and MoltenVK come with the game and are always the ones it uses (never a Homebrew copy). Metal stays the default, and if Vulkan can't start, the game falls back to Metal and says why. This also makes Cemu graphics packs with GLSL shaders usable on the Mac.
-
5.1 surround sound (issue #115). Settings → Audio → Speakers: Surround 5.1 (restart after changing it) sends the game's six separate surround channels, as the Wii U does with its Surround TV setting. Test speakers plays a tone on each speaker in turn and names it, so the wiring is easy to check. Stereo stays the default; if the output can't do 5.1, the game stays in stereo and says so. Details: docs/surround-audio.md.
-
Fixed: text fields in the settings overlay didn't accept typing or pasting (for example the catalogue address and the mod search; only deleting worked). Typed text, Ctrl+V / Cmd+V and copy now work on all platforms; on Android the on-screen keyboard opens for these fields.
-
Cemu graphics packs that conflict can no longer both be switched on (issue #68). The Mods tab shows "Conflicts with …" before you enable a pack; enabling it asks whether to switch (the other pack is turned off). Each pack shows what is active now and what changes after a restart, with a Restart now button. Profiles that had two conflicting packs on are repaired once, with a note.
-
Fixed: with Fast scene changes on, Grandma kept her back to Link when handing over the shield (issue #116, found and fixed by GreenNaugahyde). The mod no longer creates the new scene's characters ahead of time; fades and scene changes stay almost as fast.
-
Fixed: crash when entering the Puppet Ganon room (issue #90, Vulkan). The room uses a colour texture for a depth comparison, which the Vulkan renderer didn't support, so it stopped with an error. It now handles it. Such internal errors are also no longer lost: they are written to the log and the crash log with their message before the game stops, also on Windows. After updating, setup compiles the game code once more.
-
The mouse pointer now hides when you don't use the mouse (issue #109). After 2 seconds without mouse movement it disappears from the game window, in full screen and in a window, on Windows, Linux and macOS; moving the mouse shows it again. It stays visible while the settings overlay is open.
-
Fixed: the aspect ratio wasn't remembered (issue #108). The choice in Settings → Graphics → Aspect ratio (or the macOS menu) now stays after a restart, like the other graphics options.
WWHD_ASPECTstill overrides it. -
Mod SDK v2: audio streams. Code mods can now play their own sound: up to four 48 kHz streams per mod, mixed into the game's audio and following its volume and mute (and fast forward). The dragon example mod uses it for its melody. Mods without audio don't change anything.
-
Fixed: the settings overlay scrolled by itself, and B closed it while assigning a button (issue #111). A drifting controller stick no longer scrolls the menu: the right stick no longer scrolls it at all (the D-pad, left stick and mouse wheel do), and the left stick has a dead zone there. Assigning B to a control no longer also closes the overlay.
-
Mod SDK v2: more for code mods. New public declarations (actor profiles, save inventory, animation, matrix emitters, flight position and lighting, song handling) and HUD clipping, used by the two example mods in the mod repository: a GameCube-style minimap and the Valoo dragon ride.
-
Setup now uses Python 3.14 (bundled on Windows, downloaded on Linux and macOS as before). Mod setup steps can now read GameCube disc images in RVZ format, not only ISO.
-
Setup: more reliable compiler download (issue #113). If the download of the compiler (about 190 MB on Windows) is interrupted, setup now retries and resumes where it stopped instead of failing. If it still can't download it, you can download the file in your browser and put it in the Wind Waker HD folder: setup checks it and uses it. On Windows, when the secure connection can't be verified ("unable to get local issuer certificate", usually a root certificate Windows hasn't fetched yet), setup now downloads with Windows' own curl instead.
-
Fixed: the boat's sail fluttered too fast at 60, 120 and 240 fps (issue #68). The sail cloth was drawn with its exact pose against the in-between camera, which added an extra jump on every in-between frame. Its drawing is now interpolated, and so are the other cloth pieces drawn the same way: pirate sails and skull flags, fortress flags, buoy flags and their poles, and capes such as Phantom Ganon's. 30 fps is unchanged.
-
New Gameplay mod: fast forward cutscenes and dialogue (off by default; Settings → Gameplay). Hold ZR during a cutscene or a conversation and the game runs 2×, 3× or 4× faster (your choice; the button can be changed). Nothing is skipped: the game plays every frame, only faster, so the story and events end exactly as without it. Questions still wait for your answer, holding the button in normal play does nothing, and letting go returns to your frame rate setting. Sound is muted while fast-forwarding (it would play sped up); that can be turned off. Idea and clock from GreenNaugahyde's Android fork.
-
Performance overlay: GPU, driver and per-thread timing. Settings → Graphics → Performance overlay now also shows the GPU and its driver, the CPU time of the game and render threads and the GPU time per frame (each with its average), so you can see at a glance whether the CPU or the GPU is the limit. On Android it adds the system's thermal state and the battery temperature next to the GPU load and temperatures. Copy performance report includes all of it; please paste it into performance bug reports. Ideas and the Android battery handling come from GreenNaugahyde's Android fork.
-
Fixed: mini-game countdowns ran too fast at 60, 120 and 240 fps (issue #105). The letter sorting on Dragon Roost could not be won at 60 fps or more; its 30-second limit ran out in 15 (at 120 fps in about 8). The game's shared countdown (also used by the Windfall auction, the boat race and the timed challenges) now counts game steps, not displayed frames, and its display stays smooth. 30 fps is unchanged.
-
The log file is now off by default. Turn it on in Settings (F1) > Graphics > Bug reports > Write a log file; from the next start the game writes
captures/wwhd.login its data folder (the previous run's is kept aswwhd-previous.log), with your user paths removed as in crash logs. Please turn it on before reproducing a bug and attach the file to the report.WWHD_LOG_FILE=1turns it on for one run,WWHD_LOG_FILE=writes it elsewhere,WWHD_LOG_FILE=0turns it off. -
Mod SDK v2, phase 2: HUD drawing for code mods. PowerPC code mods can now draw on screen (text, images, gauges) on both Metal and Vulkan, ship their own original images and content files in one package, and read port settings such as the resolution. See
examples/guest-mods/hud-demoandbutton-icons. Code mods stay off unless you turn on Enable code mods. -
Mods panel: Browse catalogue. Search, install and update mods from a mod catalogue inside the game. It only downloads when you press Refresh, checks every package's size and SHA-256, and installs packages disabled. Setup steps (choosing your game dump, preparing files locally, building a code mod for your game version) run from the panel. The official mod catalogue is not public yet;
WWHD_MOD_CATALOGUEpoints the panel at another index.
Checksums (SHA-256)
e190898a93b920aa18fb786c07b40811da8e5991ed6a388365f4cee903d61aad WindWakerHD-v0.2.12-linux-aarch64.zip
1fd67b9c127aa6c16183f855b62854fc1ad3dc650aad1e6cd05cdd7242880994 WindWakerHD-v0.2.12-linux-x86_64.zip
fbe7e063d2e1529e428ee4e46bcafc81ee5669433c93e2862a1aba9f06e50130 WindWakerHD-v0.2.12-macos-arm64.zip
919abfebbaf41e4fe4d3e2741da80434464cc4f65b4faed79a13cb71e2c3a088 WindWakerHD-v0.2.12-windows-x86_64.zip
9c29995f35dbf43eac2e4efe32f3cdd7a6c898b5e5852ea69c2a44a0b8642373 WindWakerHD-v0.2.12-linux-aarch64.AppImage
c6c753cd5bb8f1c792ca0e8fd5d1182dd9668721c2ab5d5753cd7489b1b19a09 WindWakerHD-v0.2.12-linux-x86_64.AppImage
a8a3b6d0e3abf369d291568ac926dd0e8ba6c2da6b4b1c2dec5c9e86c4717239 WindWakerHD-v0.2.12-android-arm64.apk
35a4eaccccedfc303b09f31ca54075ff9581fb7d83db9f90338342f83bf099bb WindWakerHD-v0.2.12-android-x86_64.apk
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.2.12-linux-aarch64.zip: 0 of 63 engines flag it, reportWindWakerHD-v0.2.12-linux-x86_64.zip: 0 of 61 engines flag it, reportWindWakerHD-v0.2.12-macos-arm64.zip: 0 of 64 engines flag it, reportWindWakerHD-v0.2.12-windows-x86_64.zip: 1 of 67 engines flag it, reportWindWakerHD-v0.2.12-linux-aarch64.AppImage: 0 of 63 engines flag it, reportWindWakerHD-v0.2.12-linux-x86_64.AppImage: 0 of 63 engines flag it, reportWindWakerHD-v0.2.12-android-arm64.apk: 0 of 50 engines flag it, reportWindWakerHD-v0.2.12-android-x86_64.apk: 0 of 48 engines flag it, reportWind Waker HD.exe: 1 of 70 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (VIPRE), reported to the vendors as false positives; see issue #58.
0.2.11
- Nouveauté majeure : ajout d’un système de mods en code natif (Mod SDK v2, désactivé par défaut), compatible avec les versions USA et européenne, compilé localement depuis des fichiers C.
- Amélioration des contrôles : configuration des boutons Face par label (layout Xbox) dans les paramètres, pour une compatibilité avec les manettes Xbox.
- Correction graphique : résolution du problème de la carte noire dans le jeu de tri postal des Rito, via une émulation corrigée de la multiplication GPU.
- Compatibilité Cemu : prise en charge des packs graphiques européens et correction partielle des packs Vulkan (pixel shaders) depuis la version 0.2.10.
- Optimisations CPU : réduction de 2/3 de l’usage du thread audio pour deux boucles critiques, et suppression d’un débordement signé dans le recompileur.
- macOS (Apple Silicon) : version .dmg non signée pour macOS 14+, avec instruction explicite pour contourner la sécurité (clic droit > Ouvrir ou Paramètres Système > Sécurité).
The Wind Waker HD, native PC port, v0.2.11
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file:chmod +xthe.AppImageand start it from anywhere (Steam Deck included); its game, code, saves and settings go to~/.local/share/wwhdand~/.config/wwhdinstead of beside it (Ubuntu 24.04+:libfuse2t64, or--appimage-extract-and-run)
See "Install (releases)" in the README for details.
What's new
-
Linux: one-file AppImage (issue #55, PR #101, thanks @mhbxyz), next to the zip. Download it, make it executable, run it. It keeps the game, its compiled code, saves and settings in your user folders (
$XDG_DATA_HOME/wwhd, usually~/.local/share/wwhd);--data-dirpicks another folder. On distributions without libfuse2 (e.g. Ubuntu 24.04+) start it with--appimage-extract-and-run. The zip stays as it is. -
Face buttons by label (Xbox layout) (issue #78, PR #97, thanks @mhbxyz): settings overlay → Controls → Face buttons (also the macOS Controls window and Input menu). By position (Nintendo) stays the default; by label (Xbox) makes the button named A act as A, so on an Xbox pad A accepts and B goes back.
-
Ultrawide and tall screens: menus fixed (issue #76, building on PR #16 by @arcadematicas): at 21:9, 32:9, 16:10 and 4:3 the pause menu, inventory grid, cursor, map and the tabs stay centred at 16:9 and line up again; backgrounds and the sepia filter still fill the picture.
-
Fixed: black letter card in the Rito mail-sorting game (issues #28, #69, PR #39, thanks @Sean13128): the GPU's "0 × anything = 0" multiply is emulated now (as in Cemu). The shader caches rebuild once after updating, so expect a brief stutter on the first start.
-
Fixed: Cemu graphics packs
- packs that replace pixel shaders (e.g. Contrasty, NoSSAO, RemoveHUD) partly didn't apply on Vulkan since v0.2.10 (PR #87, thanks @rhemfur);
- packs for the European version were refused with "Cemu pack does not target WWHD USA"
(issue #103). A pack is now accepted when its
titleIdsname the version you installed; SDCafiine-style folders named after the title ID follow the same rule.
-
Smoother in busy views on Windows and Android: the Vulkan buffer cache is now on by default everywhere. It keeps unchanged vertex, index and uniform data on the GPU instead of copying them every frame: on an RX 6700 XT 13–19% less render-thread time and half the uploads (issue #91, thanks @darklinkpower), on a Galaxy S25 Ultra about 34 → 47 fps in heavy Outset views (issue #56, thanks @rhemfur). If you see broken or flickering geometry, start with
WWHD_VK_BUFFER_CACHE=0and please report it. -
Less CPU work:
- native versions of the game's two hottest audio loops (PR #81, thanks @depende3000): the audio thread uses about two thirds less CPU, with bit-identical sound (also on the European version);
- the scheduler sleeps while nothing is waiting, and GPU context switches copy only the registers that changed;
- the recompiler no longer emits signed overflow for
mulli/mullw/neg(PR #82, thanks @depende3000), a latent bug a newer compiler could have turned into wrong behaviour.
-
Android:
- when the system driver is too old for the renderer, Adreno phones offer Install GPU driver… right in the error message (PR #92, thanks @rhemfur);
- on one-screen views the GamePad screen appears automatically while the game is paused (map, menus, save prompt) and the TV picture comes back when you resume (PR #59, thanks @rhemfur);
- precise Vulkan synchronization (barriers) is on by default, where tile-based GPUs are expected to
gain the most (issue #104). On desktop it's opt-in for testing:
WWHD_VK_NARROW_BARRIERS=1.
-
Save states remember the controller mode (Pro Controller or GamePad) and restore it on load.
-
"Keep game speed" explained: with it off, the whole game runs in slow motion whenever the frame target isn't reached (e.g. 120/240 fps at 2x). The setting says so now, is marked as recommended, and the performance overlay warns when it happens (issue #91).
-
A log file for every run:
captures/wwhd.login the game's data folder (the previous run's is kept aswwhd-previous.log), with your user paths removed as in crash logs. Please attach it to bug reports.WWHD_LOG_FILE=writes it elsewhere,WWHD_LOG_FILE=0turns it off. -
Code mods (Mod SDK v2, off by default): mods written in C for the console's CPU, translated and built on your machine when you install them, for the USA and the European game. Turn them on in Settings → Mods → Enable code mods (this rebuilds the game code once; with it off nothing changes). For modders: docs/mod-sdk-v2.md.
-
Smaller fixes:
WWHD_SHADOW_FIXis gone, useWWHD_SHADOW_SCALE=1for console-sized shadow maps (issue #67: since v0.2.9 both sizes look practically the same); the buffer cache's verify mode no longer reads GPU memory (it ran at ~1 fps on some Windows drivers); a crash at exit with SDL 3.4 on Linux is fixed.
Checksums (SHA-256)
6e1bb12e2fbdf0a686bc8c26babf256e5f255008ae726d144aabc259eee97f4f WindWakerHD-v0.2.11-linux-aarch64.zip
02dd618ee9177e23cf158ac7b0394a226edf2af2b59c98f3bccdfc29940f2854 WindWakerHD-v0.2.11-linux-x86_64.zip
f909ad996d6e83b88b1358298d5bf25d3777844c0d13a8db8d40f8a46e049042 WindWakerHD-v0.2.11-macos-arm64.zip
6b2a938192197b69cd4d1e72ad09ca970c394ff3849e508f55d16038d05db92d WindWakerHD-v0.2.11-windows-x86_64.zip
58f4c39187586a8d6dd1328ea194563f0f0a39d2cd561d4a18bcc1654291ec98 WindWakerHD-v0.2.11-linux-aarch64.AppImage
c12388c21ffd6bc46fda38a018ac6f2d8cce95d0610580c68c7292672015b0f7 WindWakerHD-v0.2.11-linux-x86_64.AppImage
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.2.11-linux-aarch64.zip: 0 of 65 engines flag it, reportWindWakerHD-v0.2.11-linux-x86_64.zip: 0 of 63 engines flag it, reportWindWakerHD-v0.2.11-macos-arm64.zip: 0 of 66 engines flag it, reportWindWakerHD-v0.2.11-windows-x86_64.zip: 8 of 66 engines flag it, reportWindWakerHD-v0.2.11-linux-aarch64.AppImage: 0 of 62 engines flag it, reportWindWakerHD-v0.2.11-linux-x86_64.AppImage: 0 of 64 engines flag it, reportWind Waker HD.exe: 9 of 71 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (ALYac, Arcabit, BitDefender, CTX, Emsisoft, GData, MicroWorld-eScan, Microsoft, VIPRE), reported to the vendors as false positives; see issue #58.
0.2.10
- Correction majeure : les cheats (comme "Donner tous les objets") écrivaient incorrectement dans les données de sauvegarde et risquaient de les corrompre.
- Correction critique : le cheat "Épée Maîtresse + Bouclier Miroitant" empêchait Medli de réapparaître sur le Rocher du Dragon, bloquant l’histoire.
- Amélioration Vulkan : les shaders pixel sont correctement liés à leurs shaders vertex, résolvant des problèmes de pipelines refusés par certains pilotes.
- macOS Apple Silicon : version .app non signée pour macOS 14+ (15+ nécessite une autorisation manuelle).
The Wind Waker HD, native PC port, v0.2.10
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Fixed: the cheats in v0.2.9 wrote to the wrong place in the save data (Give all items, Master Sword + Mirror Shield, 20 hearts / double magic / 5000 rupees) and could damage the save. They write to the right place again.
- Fixed: Medli missing on Dragon Roost after using the Master Sword cheat (issue #85). The cheat
gave the full-power Master Sword as owned, which the game treats as story progress, so Medli (and
later Makar) stayed away and the story couldn't continue. The cheat now only equips the Master
Sword and Mirror Shield until the next reload. Saves already affected can be repaired with
tools/savegame/wwsave.py repair-medli(it keeps a backup; see the save tools README). - Vulkan: pixel shaders are now linked to their vertex shader when they are translated, so drivers that refused some pipelines get correct shaders from the start (PR #54 by @rhemfur, the proper fix for #30).
Checksums (SHA-256)
e9cc89f3a2a2a2439c5f7751def594fd4d2a081e5e71755a073ab5ce9f4088e9 WindWakerHD-v0.2.10-linux-aarch64.zip
64e912cb7ac46bdd6329386f725eea217a5b09f13551bbbeb346d954eac58791 WindWakerHD-v0.2.10-linux-x86_64.zip
8ee8d70aa9c409f1b90ea3bd419ca0844f673ce072933955960cecffce220571 WindWakerHD-v0.2.10-macos-arm64.zip
6e456d8179ef946c08e5991b9e508a94da254c577a348eca6f0539bc3b256c34 WindWakerHD-v0.2.10-windows-x86_64.zip
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.2.10-linux-aarch64.zip: 0 of 65 engines flag it, reportWindWakerHD-v0.2.10-linux-x86_64.zip: 0 of 64 engines flag it, reportWindWakerHD-v0.2.10-macos-arm64.zip: 0 of 59 engines flag it, reportWindWakerHD-v0.2.10-windows-x86_64.zip: 11 of 58 engines flag it, reportWind Waker HD.exe: 13 of 70 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (ALYac, AVG, Arcabit, Avast, Avira, BitDefender, CTX, Cynet, Emsisoft, F-Secure, GData, MicroWorld-eScan, Microsoft, VIPRE), reported to the vendors as false positives; see issue #58.
0.2.9
- Lancement direct de la version européenne : le port accepte désormais le jeu européen (ID 00050000-10143600) sans dépendre de la version américaine, avec ses propres langues (allemand, italien, espagnol, français, anglais britannique).
- Rétablissement des effets visuels : retour du bloom, de la brume de distance et de l’éblouissement solaire, recalculés via Metal/Vulkan, avec un réglage dédié (0–200%) et prise en compte du profil couleur des écrans Mac.
- Correction des bugs critiques : pause menu fonctionnelle à 120/240 fps, suppression des artefacts sur les drapeaux, objets et étoiles en mouvement entre les frames (60/120/240 fps).
- Sauvegarde des captures d’écran : touche F10 enregistre automatiquement le rendu en cours (format PNG) dans un dossier dédié (~/Library/Application Support/wwhd/screenshots), avec option pour inclure l’écran GamePad.
- Compatibilité macOS : binaire .app pour Apple Silicon (M1/M2/M3+) et macOS 14+, non signé par Apple (autorisation manuelle requise sur macOS 15+ via Privacy & Security). Doit rester dans le dossier décompressé.
⚠ Known issue in v0.2.9: the cheats (Settings → Mods → Cheats) write to the wrong place in the save data and can damage your save. Fixed in v0.2.10, please update (it also fixes the Master Sword cheat hiding Medli on Dragon Roost, #85). The other mods and all other features are not affected.
The Wind Waker HD, native PC port, v0.2.9
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
-
Play the European version directly (title 00050000-10143600): setup now also accepts the European game on its own, without the USA version, and builds the port from it through an address map derived from the two executables (every function and call matched; contributed by @ElFDA, PR #77, with ideas from GreenNaugahyde's Android fork). German, Italian, British English, French and Spanish are its own languages then. Hooks, mods and save states work as on the USA version.
-
Bloom, distance haze and the sun's glare are back: the game builds its glow from smaller copies of the picture, which the port never made; now it does, on Metal and Vulkan, so the picture looks like on the Wii U again. The sun's corona and lens flare react to whether the sun is hidden (adapted from GreenNaugahyde's Android fork). New Settings → Graphics → Effects → Bloom strength (0–200%, default 100%). On Macs, colours now go through the display's colour profile, as with Vulkan.
-
Android: phones whose GPU can't read the game's compressed textures (many Mali and PowerVR GPUs) now decode them on the GPU instead of showing black or broken textures; on Snapdragon phones you can install and select custom Vulkan drivers such as Turnip (Settings → Graphics; a driver that crashes or hangs in its first seconds falls back to the system driver on the next start). Both follow the approach of GreenNaugahyde's Android fork, rebuilt on our renderer. Not yet tested on real Mali/PowerVR/Snapdragon devices: reports welcome.
-
Run and swim faster (optional, Mods tab, off by default): hold L3 (or toggle) to boost Link's running and swimming speed, 1.25x to 4x; works with true 60. The idea comes from GreenNaugahyde's Android fork.
-
Average frame rate in the performance overlay (and GPU load and temperatures on Android where readable); crash logs now include the settings in use, with your user paths removed, and Android offers to share the log after a crash.
-
Vulkan: the compressed-texture feature is now enabled as the Vulkan specification requires.
-
Screenshot key: F10 saves the TV picture as a PNG in a
screenshotsfolder next to the save states (~/Library/Application Support/wwhd/screenshots,%APPDATA%\WWHD\screenshots,~/.config/wwhd/screenshots;data/user/screenshotsin a release folder), namedWindWakerHD_YYYY-MM-DD_HH-MM-SS.png. It is the frame shown when you press the key (also at 60/120/240 fps), at the internal resolution and aspect ratio (2x at 21:9: 3414x1440), with the game's own effects and FXAA when on, but without the settings overlay or notices; "Screenshot saved" shows briefly. The key can be changed (or a controller button added) in Controls ("Photo"); the Saves tab has Open screenshots folder and an option to also save the GamePad screen (..._GamePad.png) while it is shown. Saving happens in the background: the game does not stutter. Both renderers, all platforms. -
Frame interpolation fixes (60/120/240 fps and true 60): the waving flags on Dragon Roost no longer turn into huge stretched polygons on the in-between frames (issues #36, #70); the boat's sail and yard and items Link carries (a bomb) no longer jump for single frames (issue #68); the stars in the night sky no longer wobble when the camera turns (issue #68). 30 fps is unchanged.
-
Fixed: the pause menu would not close at 120/240 fps (issues #64, #74; probably also #73, no control after an item-get message). The HD screens (the TV pause screen and others) advanced on every drawn frame instead of once per game step, so the TV pause screen reopened itself right after closing. They now update once per step, which also gives their fades their 30 fps speed back at 60/120/240 fps.
Checksums (SHA-256)
2f1e7c8b6b1286e97d2f31cebb7cb5384848f0b2d56ea55756795985ddb12f00 WindWakerHD-v0.2.9-linux-aarch64.zip
7990acd2f8388525007b1237e0b1cbbb1d0904de99ee4d60cc94b1243245ddb6 WindWakerHD-v0.2.9-linux-x86_64.zip
0dce7748fe24159567a9ac39ac5262c8c41b6e8f8fb038fed2e80673e0389461 WindWakerHD-v0.2.9-macos-arm64.zip
476c104511e50257285d8b4a8f929cd51270a97dbf4151386ea58b8c72e2b440 WindWakerHD-v0.2.9-windows-x86_64.zip
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.2.9-linux-aarch64.zip: 0 of 61 engines flag it, reportWindWakerHD-v0.2.9-linux-x86_64.zip: 0 of 64 engines flag it, reportWindWakerHD-v0.2.9-macos-arm64.zip: 0 of 65 engines flag it, reportWindWakerHD-v0.2.9-windows-x86_64.zip: 9 of 65 engines flag it, reportWind Waker HD.exe: 12 of 70 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (ALYac, AVG, Arcabit, Avast, Avira, BitDefender, CTX, Emsisoft, GData, MicroWorld-eScan, Microsoft, VIPRE), reported to the vendors as false positives; see issue #58.
0.2.8
- Fonctionnalité macOS : fermeture de la fenêtre TV ferme le jeu (option de confirmation ajoutée, désactivable via WWHD_QUIT_PROMPT=0).
- Correction macOS : suppression du gel au démarrage (0 FPS) sur certains Mac (notamment MacBook Air M1) via une rélecture mémoire des boucles de spin-wait.
- Nouveauté : support expérimental de 7 langues (allemand, italien, anglais britannique, français européen, espagnol européen, japonais) avec des dumps régionaux.
- Nouveauté : intégration de traductions fan (arabe, hébreu) en mode texte droit-gauche via le gestionnaire de mods.
- Amélioration : états de sauvegarde réduits à quelques Ko (portables) pour les rapports de bugs, avec récupération partielle de la progression.
- Correction : stabilisation des portes "rapides" évitant les crashes liés à la suppression prématurée d'acteurs.
- Amélioration : ajustement des contrôles gyroscopiques (3 modes : espace joueur, yaw, roulis) et meilleure gestion des capteurs (redémarrage automatique, logs de diagnostic).
The Wind Waker HD, native PC port, v0.2.8
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Fixed: the game could freeze at startup with 0 fps on some Macs (issue #62, MacBook Air M1). Newer Apple compilers turned the game's spin-wait loops into endless loops that never saw the other core release the lock. Every loop in the game code now re-reads memory on each pass; no measurable speed cost.
- Fixed: Android crashed when changing the aspect ratio or internal resolution on some phones (issue #72, Adreno 830). Phones whose driver cannot blit depth buffers now copy them with a small draw instead; nothing aborts any more if a device can do neither. Thanks to @Blivii for the analysis and the patch.
- Fixed: grid pattern in contact shadows at higher internal resolutions (issue #66). The game's
shadow and ambient-occlusion blur now covers the same area as on the console at every resolution;
1x is unchanged and there is no measurable speed cost. Shadow maps still scale with the internal
resolution for sharp shadows;
WWHD_SHADOW_FIX=1keeps them at the console's 1024x1024 instead, for soft edges that never shimmer (issue #67). - More languages (experimental): with your own dump of the European or Japanese game, the port can use its text, fonts and menus: German, Italian, British English, European French and Spanish, or Japanese. See docs/language-packs.md.
- Fan translations as content mods, including Arabic and Hebrew drawn right to left (issue #60), see docs/mod-manager.md and docs/rtl-text.md.
- macOS: closing the TV window quits the game (issue #65), as on Windows and Linux. During a game
it asks first: Quit, Cancel or Save State and Quit.
WWHD_QUIT_PROMPT=0turns the question off. - Faster on Linux and Steam Deck (Vulkan): the guest buffer cache is now on by default on desktop
Linux, as on macOS. It keeps unchanged vertex, index and uniform data on the GPU instead of copying it
every frame, which removed a 20 fps lock in busy views on an RK3588 board (issue #50). If you see broken
or flickering geometry, start with
WWHD_VK_BUFFER_CACHE=0and please report it. Windows and Android stay opt-in (WWHD_VK_BUFFER_CACHE=1). - Save states are now small and can go into bug reports. The Save state button (and
Shift+F1–F5, the Save States menu) now writes a portable state,
slotN.wwstate: a few KB with your progress (the same save data the game writes intocking.sav) and where Link stands (stage, room, position, facing, time of day). It contains no game code and no game data, so you can attach it to an issue; Copy save for bug report in the Saves tab copies the paths of the state and of yourcking.sav. Loading one puts that progress into the running game and takes Link there; it is not an exact snapshot (enemies, a running cutscene and other actors start fresh). The old full states (the whole running game, ~300 MB, contain game data: never share them) are still there for debugging: Saves › Full save states, orWWHD_FULL_SAVE_STATES=1. Loading a slot loads either kind; an older full state in a slot is kept and the Saves tab says so. A portable state can only be saved while you control Link (not during a cutscene or dialogue); one saved on the boat puts Link back on the boat. See docs/portable-save-states.md. - Fixed: "Quick doors" could crash the game going through a door (issue #61, "PROGRAM HALT J3DPacket.cpp:157"; reported in Tingle's jail on Windfall). The extra game steps that make doors quicker also deleted actors (a pot, a rat, Tingle) faster than the game allows: an actor that removed itself while a door opened was freed before its last drawn frame was done with. Deleting now keeps its normal pace; doors are as quick as before.
- Gyro aiming fixes (issues #45 and #71): a new Turn left/right by setting (settings overlay →
Controls → Gyro…) with the usual gyro conventions: Player space (default: turn the controller
left or right about the real vertical, however you hold it), Yaw (its own vertical axis) or Roll
(tilt it like a steering wheel). Before, rolling the controller turned the view and turning it depended
on how you held it. The default sensitivity is lower (0.5x, about one to one with your controller; the
range now goes down to 0.05x), and settings that still have the old default start at the new one.
Gyro aiming now also works in Pro Controller mode. For reports that the gyro stops after a while:
the port no longer stops when a controller's sensor timestamps stall, switches to the controller you
move when several are connected, turns a controller's sensors on again when they fall silent, and logs
[gyro]lines that say why motion stopped (including a drifting right stick, which makes the game ignore the gyro). "Recenter" is now Recalibrate (learns the gyro's offset anew).
Checksums (SHA-256)
a5ab53458e18a3c8c9dfb1ad3d96dc0ee6790e2020014b276ee4f5187cabfcd8 WindWakerHD-v0.2.8-linux-aarch64.zip
0385371860ed8b7a43a2d2d0a000cb210683c95b73a700c25935a7759cd3a86d WindWakerHD-v0.2.8-linux-x86_64.zip
de132e5d3ba466b3fa707e370ab1b8c0b5db0c5dd0cf8b493a5e2f4b22cb9b96 WindWakerHD-v0.2.8-macos-arm64.zip
579750a4621f04329dd06760c5443ab5fe1b109e6db3f4ada72f6dc41cc78640 WindWakerHD-v0.2.8-windows-x86_64.zip
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.2.8-linux-aarch64.zip: 0 of 65 engines flag it, reportWindWakerHD-v0.2.8-linux-x86_64.zip: 0 of 62 engines flag it, reportWindWakerHD-v0.2.8-macos-arm64.zip: 0 of 56 engines flag it, reportWindWakerHD-v0.2.8-windows-x86_64.zip: 8 of 66 engines flag it, reportWind Waker HD.exe: 8 of 71 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (ALYac, Arcabit, BitDefender, CTX, Emsisoft, GData, MicroWorld-eScan, VIPRE), reported to the vendors as false positives; see issue #58.
0.2.7
- Prise de vue avec le Picto Box corrigée : les textures 3D de gradation s’affichent désormais correctement en Vulkan et Metal, évitant les crashes et les photos en noir.
- Ombres noires supprimées sur macOS (Metal) : le rendu des ombres est stable après compilation de shaders, sans dépendre du cache macOS.
- Support natif des fréquences 120 Hz et 240 Hz : interpolation de 3 ou 7 frames entre les étapes logiques du jeu (30 fps), avec détection automatique du taux d’actualisation.
- Mode "Uncapped" en debug : désactive toute limite de frames et le vsync pour mesurer le FPS maximal (via WWHD_UNCAPPED=1 ou menu Graphics).
- Réinitialisation plus rapide après un lag : les frames interpolées ne sont plus bloquées après un ralentissement ponctuel (shader, chargement).
- Optimisation mémoire sur Mac et GPU intégrés : vérifications de réutilisation des données uploadées simplifiées (suivi de la correction v0.2.5).
The Wind Waker HD, native PC port, v0.2.7
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Fixed: taking a picture with the Picto Box crashed the game (Vulkan) (issue #53). Right after the shot the game renders small 3D colour-grading textures slice by slice, which the Vulkan renderer did not support; on Metal the preview was black. Both renderers now render into 3D textures, and the saved pictures show up in colour in the Picto Box album (they were black on both renderers before).
- Fixed: black shadows on macOS (Metal) (issue #47). When macOS had to compile the game's shaders from scratch (first start, or after a macOS update cleared its shader cache), the ambient-occlusion pass could be skipped at the title screen while its shader was still compiling; the light buffer was then created with the wrong layout and stayed wrong for the whole session, turning shadowed areas black until a restart. Render targets no longer depend on that timing, and draws whose result the game reuses are never skipped. A cold start now spends about 0.7 s more on the title screen once.
- Windows setup without PowerShell (issue #58): the setup no longer runs a PowerShell script or
removes the "downloaded from the internet" mark, and
Wind Waker HD.exedownloads nothing: the official, signed embeddable Python now ships in the release (the Windows zip grows to about 19 MB). The programs carry version information and a manifest. Some antivirus engines (BitDefender and engines using it) may still flag the unsigned exe; that is a false positive and has been reported. - 120 and 240 fps (settings overlay → Graphics → Frame rate, or the macOS Graphics menu): frame interpolation now also draws 3 or 7 blended frames between the game's 30 logic steps a second, for 120 Hz and 240 Hz displays. Camera, models, particles, sea and every other blended effect move at even steps between two game steps; input, sound and menus behave as at 30 fps. The game detects the display's refresh rate (ProMotion Macs: 120 Hz; Windows, Linux and Android: the monitor's or phone's current rate, and Android phones are asked for their fast mode) and the overlay shows it ("Your display: 120 Hz"). A rate the display cannot show is capped to it: 240 fps on a 120 Hz display draws 120, and 120 fps on a 60 Hz display draws 60. Keep game speed is on by default at 120/240 fps: when the computer cannot draw every frame, the game still runs at full speed with fewer in-between frames. Measured on an M3 Max with its 120 Hz display (Outset Island): 120 fps draws 115 frames a second on screen with Vulkan and 108 with Metal, at 29.1–29.7 game steps a second; without presenting, 119.3 frames and 29.9 steps. 240 fps is limited by the renderer on that machine (about 146 frames a second when not capped to the display), so on a 120 Hz screen it draws the same as 120 fps.
- "Uncapped" debug switch (settings overlay → Graphics; not saved): no frame limit and no
vsync, to see how many frames a second your computer can draw (window title and performance
overlay). The game counts frames, so it runs faster than normal while it is on: not for playing.
Metal and Vulkan;
WWHD_UNCAPPED=1turns it on at start. - Keep game speed recovers faster after a hitch (all frame rates): one slow frame (a shader compile, a scene load) no longer turns the in-between frames off for several seconds.
- Android: full-size occlusion depth is off by default (it halved the worst GPU waits on an Adreno 830, issue #56); the settings overlay can still turn it on.
- Smaller fixes: cheaper reuse checks of upload memory on Macs and integrated GPUs (follow-up to the v0.2.5 fix for issue #44), time limits for the Android CI build, and "mouse as gyro" no longer loses part of a movement when a frame stalls.
Checksums (SHA-256)
a0840b305daa55fd27d539eb4b557e6a3da14129e65c69d75a5208cdd5435558 WindWakerHD-v0.2.7-linux-aarch64.zip
a94fd9bbab979d079f3450454699f6b5289c80ef61eca19504766044d5db9230 WindWakerHD-v0.2.7-linux-x86_64.zip
50be28e8ac878f2e3d7fb6c132a84f9affbbb8b6febfe67b06015a518fc8f355 WindWakerHD-v0.2.7-macos-arm64.zip
0aa05ed2d51ebb413a7490010358ef2d41bac768f8123b0293ada52e882479f0 WindWakerHD-v0.2.7-windows-x86_64.zip
VirusTotal
Scan results of this release's files at publishing time (results can change as engines update):
WindWakerHD-v0.2.7-linux-aarch64.zip: 0 of 66 engines flag it, reportWindWakerHD-v0.2.7-linux-x86_64.zip: 0 of 61 engines flag it, reportWindWakerHD-v0.2.7-macos-arm64.zip: 0 of 66 engines flag it, reportWindWakerHD-v0.2.7-windows-x86_64.zip: 8 of 67 engines flag it, reportWind Waker HD.exe: 8 of 71 engines flag it, report
Detections on the Windows files are generic heuristics on an unsigned program (ALYac, Arcabit, BitDefender, CTX, Emsisoft, GData, MicroWorld-eScan, VIPRE), reported to the vendors as false positives; see issue #58.
0.2.6
- Optimisation majeure du rendu Vulkan : réduction drastique des traductions de shaders et pipelines (jusqu’à 90 % moins de ressources) via un système de cache intelligent.
- Ajout d’en-têtes d’identification dans les rapports de performance, indiquant la version, le système d’exploitation, le matériel graphique et les paramètres non par défaut.
- Support officiel pour macOS 14+ (Apple Silicon uniquement), avec une application .app non signée nécessitant une autorisation manuelle.
- Installation portable : le dossier complet doit être déplacé (pas seulement l’application) pour préserver les données locales.
The Wind Waker HD, native PC port, v0.2.6
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Far fewer shader translations and pipelines, fewer stutters in new areas, less memory (Vulkan): the renderer now keys a translated shader only on the state that actually changes its translation (for example, only the textures a shader samples and the vertex inputs and outputs it uses), so the same shader is no longer translated again and again for different render states. Starting from an empty shader cache, Outset Island needed 569 translations and 204 pipelines instead of about 6,100–6,700 and 3,200–3,500, and Windfall 829 and 236 instead of about 4,300–5,000 and 2,300–2,700. That takes about 100–115 MB less memory, cuts the frames that take over 50 ms by about a third, and lowers render-thread CPU time by 4–12%. It supersedes PR #46 by rhemfur, whose idea (keys that translate to the same shader share it and its pipelines) is part of it.
- Performance reports say which build and system they come from (issue #44): Copy performance report now starts with the version and commit, the operating system and version, the graphics card with its driver and Vulkan version (or the Metal device), and the rendering switches that are not at their defaults (buffer cache, CPU paths turned off, lazy DrawDone / async present turned off, the gyro source). The log's first lines name the version and system too, so crash logs carry them.
Checksums (SHA-256)
55242cdac9546154d60becf9356dcd705c3e8223651ddc550daff4df240f01e1 WindWakerHD-v0.2.6-linux-aarch64.zip
bf842387537d737cd9c84bf13e59f3892f1d0c6f306683075d89a0b2c9f4242c WindWakerHD-v0.2.6-linux-x86_64.zip
95e79566bbab23e2bf316a4b2da33454fdae000f54efe02df20b10385ec11c93 WindWakerHD-v0.2.6-macos-arm64.zip
3c6563e09f140365aba9179ef5fb8b0e9806a30abdeda7c1e163ccb013f54182 WindWakerHD-v0.2.6-windows-x86_64.zip
0.2.5
- Ajout du tir à la gyro pour les armes (arc, crochet, boomerang, etc.) via DualSense, DualShock 4, Joy-Con ou serveur Cemuhook (paramétrable en sensibilité et inversion).
- Correction majeure des FPS sur Windows/Linux avec GPU dédié (Vulkan) : suppression des lectures lentes de la mémoire GPU upload, amélioration des buffers d’index.
- Support natif macOS Apple Silicon (M1/M2/M3+) avec build .app non signée, compatible macOS 14+ (nécessite autorisation manuelle pour macOS 15+).
- Installation portable : l’application doit rester dans le dossier décompressé (déplacer le dossier entier, pas seulement l’application).
The Wind Waker HD, native PC port, v0.2.5
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Fixed: much lower frame rate on Windows and Linux PCs with a dedicated graphics card (Vulkan) (issue #44). Three renderer shortcuts that v0.2.4 turned on for all platforms compared new vertex and uniform data against the previous copy in the GPU's upload memory; reading that memory back is very slow on AMD and NVIDIA cards (one report went from 30 fps in v0.2.1 to 12 fps). The renderer now keeps those comparison copies in normal memory and never reads GPU upload memory, which also speeds up an older index-data path when the buffer cache is off.
- Gyro aiming (issue #45; settings overlay → Controls → Gyro…): aim the bow, hookshot,
boomerang, telescope, Picto Box and grappling hook in first person by moving your controller, as
with the Wii U GamePad. Sources: the gyro of a DualSense, DualShock 4, Switch Pro, Joy-Con or
Steam Deck controller, a Cemuhook (DSU) server (DS4Windows, BetterJoy, phone apps;
127.0.0.1:26760 by default), or the mouse (for Steam Input's "gyro to mouse"). Sensitivity,
invert and a recenter button are adjustable. Off by default; the game's own Options → Gyro
switch still applies. See
docs/gyro.md.
Checksums (SHA-256)
66419ebe6b83082bd26c563b850e4d448f55d9b98df4bb98cd7fafcf5f1b1839 WindWakerHD-v0.2.5-linux-aarch64.zip
3309cfba63b5a1b89f3ff39722a954b955a283cc2dc651f1bf7ce01a03723183 WindWakerHD-v0.2.5-linux-x86_64.zip
a94a5be2542e28eeca1badb6e03e6172251bb0056952cb57364508e1617a6046 WindWakerHD-v0.2.5-macos-arm64.zip
97d60fdc054f90ef8160fa8b128c7d7f8727f381320599a740fbb5ca0fbac8c3 WindWakerHD-v0.2.5-windows-x86_64.zip
0.2.4
- Amélioration majeure des performances : le rendu en 60 fps est plus fluide sur les PC lents (Vulkan) grâce à un rendu multithreadé CPU/GPU sur macOS, Windows et Linux.
- Réduction du travail CPU par frame : 15 optimisations de rendu (exclusives Android) activées partout, et sur macOS suppression des copies inutiles de données GPU (vertex, index, uniform).
- Rapport de performance intégré : export d’un détail du temps passé par frame dans le rendu (via l’overlay Graphics).
- Correction macOS : ouverture directe possible depuis le dossier téléchargé sans erreur, avec messages clairs en cas de problème.
- Son activé en mode GamePad-only : résolution du bug de silence en Off-TV Play (bouton Minus).
The Wind Waker HD, native PC port, v0.2.4
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app) - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Smoother 60 fps on slower PCs (Vulkan): the render thread no longer waits for the GPU after every frame on Windows, Linux and macOS (the way Android already worked), so CPU and GPU work in parallel. Where the render thread is the limit, this is the difference between slow motion and full speed: in our load tests the game went from 35–40 fps with only a third to half of the 60 fps in-between frames drawn to a steady ~59 fps with almost all of them, at full game speed. Without a frame limit it renders 13–53% more frames per second, depending on the scene. (Issues #7, #44)
- Less CPU work per frame (Vulkan): 15 renderer shortcuts that were Android-only are now on
everywhere (8–14% less render-thread time), and on macOS vertex, index and uniform data the game
does not change stay on the GPU instead of being copied again for every draw (another 6–17% less
render-thread time and 43–64% less data uploaded per frame). Windows, Linux and Android players
can try that cache with
WWHD_VK_BUFFER_CACHE=1;docs/vulkan.md("Guest buffer cache") says what to report. - Performance report (settings overlay → Graphics → Copy performance report): copies a breakdown of the render thread's time per frame to the clipboard, for bug reports about speed.
- macOS: setup works when the app is opened straight from the downloaded folder (issue #48). Every setup error now says what failed, what to do, and where the log is.
- Sound in GamePad-only mode (Off-TV Play, the Minus button): the game's sound now plays through your speakers instead of going silent (issue #49).
Checksums (SHA-256)
f0a87129c6930c8e351e4cf2576533061fc7a15bee238a67f1a31ac19eb381c1 WindWakerHD-v0.2.4-linux-aarch64.zip
5e9331cdefbae28a7c5ba49664bb2142d77e12abd8c2d57e8ead033c4d940790 WindWakerHD-v0.2.4-linux-x86_64.zip
fb6670d1645bb3082800e07b38a1345e41ecd381e56e75e268ef6c4025ebe5fd WindWakerHD-v0.2.4-macos-arm64.zip
be39745c2ed5efb0c46a5adaaf29ab030a9aa140d84d4d97e111422f2aa59b68 WindWakerHD-v0.2.4-windows-x86_64.zip
0.2.3
- Ajout d’un gestionnaire de mods intégré avec liste recherchable, support des packages .wwhdmod et des profils, incluant mods de contenu, packs graphiques Cemu et mods natifs (avec confirmation avant activation).
- Packs graphiques Cemu (rules.txt) importables avec leurs présets et règles de résolution, nécessitant le rendu Vulkan pour les shaders.
- Mods natifs (avec code compilé) exécutés en mode permissions complètes, nécessitant une validation manuelle avant activation.
- Build macOS disponible uniquement pour Apple Silicon (ARM64) avec macOS 14+, sous forme d’application .app non signée (nécessite autorisation manuelle sur macOS 15+).
- Installation locale : pas de fichiers de jeu ou de clé fournis, extraction et préparation depuis un dump Wii U ou archive Cemu.
The Wind Waker HD, native PC port, v0.2.3
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Mod manager (settings overlay → Mods): the built-in mods (direct and mouse camera,
first-person shortcut, wall climbing, quick doors, fast scenes) in one searchable list, plus
installable mod packages from a folder or a
.wwhdmodZIP, with profiles, dependencies and per-mod options. Everything starts off; nothing from a package loads until you enable it.- Content mods replace game files without touching your game folder.
- Cemu graphics packs (
rules.txt) can be imported, with their presets and resolution rules; shader packs need the Vulkan renderer. Code patches from Cemu packs are not supported. - Native mods (packages with their own compiled code) ask for a one-time confirmation before
they are enabled, because they run with the game's full permissions; only enable mods from
sources you trust.
See
docs/mod-manager.mdfor the package format and the mod SDK.
Checksums (SHA-256)
6fd1bf9d9b8f01e3b391a8bdea58e777458b10d274c5f10015db76e1318e5571 WindWakerHD-v0.2.3-linux-aarch64.zip
7612b0df82f24e4daf86f43dd158614561a8794663343e7e035097a67cb74e05 WindWakerHD-v0.2.3-linux-x86_64.zip
051a927b9ed52545d69e9862b51480118f34e25ea1b4931381a7688c4b98e853 WindWakerHD-v0.2.3-macos-arm64.zip
f7a8c46dcbde02792c64fa0671986064c06fe239856561d380f23fca132bb2dd WindWakerHD-v0.2.3-windows-x86_64.zip
0.2.2
- Rumble des manettes corrigé : le vibreur s’arrête désormais systématiquement (quitte, crash, pause, fond) et suit les patterns du jeu.
- Compatibilité avec les pilotes graphiques obsolètes : les builds Windows/Linux acceptent les drivers sans Vulkan 1.3 via l’extension VK_KHR_dynamic_rendering.
- Langues limitées et message de redémarrage : seule les langues présentes dans la version du jeu sont proposées, avec un avertissement de redémarrage nécessaire.
- Mise à jour instantanée des textures : les modifications en mémoire sont réuploadées immédiatement sur Metal et Vulkan (plus de délai de quelques frames).
- Mode plein écran mémorisé : l’état (plein écran/fenêtré) est maintenant sauvegardé sur Windows et Linux comme sur macOS.
- Logs de crash améliorés : les erreurs externes (ex : pilotes) et les couches Vulkan activées sont clairement identifiées.
- Build macOS Apple Silicon : .app non signée pour macOS 14+ (autorisation manuelle requise sur 15+).
The Wind Waker HD, native PC port, v0.2.2
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Controller rumble fixed (issue #35): rumble now follows the game's patterns exactly and always stops: on quit, after a crash, when the game hangs, while the settings menu is open and when the window is in the background. Before, a controller could keep vibrating until it was switched off. New Rumble on/off option in the settings overlay (Controls tab).
- Older graphics drivers (issue #37): Windows/Linux builds no longer refuse to start with
"Entry Point Not Found" on drivers without Vulkan 1.3; they use the
VK_KHR_dynamic_renderingextension where the driver offers it, and otherwise show a clear message naming the GPU, its driver version and what is missing. - Language tab: only the languages your game contains can be chosen (the USA version has English, French and Spanish), and a changed language says that it applies after a restart.
- Textures update exactly: textures the game changes in memory are now always re-uploaded (on Metal and Vulkan); before, a change could show up a few frames late.
- Full screen is remembered on Windows and Linux too (issue #43), as it always was on macOS: leave the game in full screen and it starts in full screen next time.
- Better crash logs: a crash outside the game code names the library it happened in (for example the graphics driver), and the log lists the Vulkan layers that overlays add, so crash reports can be answered much faster.
Checksums (SHA-256)
6ea90a398ac29e9d51e94f89695c6c3eaa1cf54b909e903cf2da8bd3a249cc1d WindWakerHD-v0.2.2-linux-aarch64.zip
f083ba7065b9515d8cb39e3683d077478e51e678808dee1821d6f5757489de4f WindWakerHD-v0.2.2-linux-x86_64.zip
1955181f94285e6c93b510b96d062852e31a227606749c285e61701bb4d6c0ac WindWakerHD-v0.2.2-macos-arm64.zip
a551afa521989bace5a00150a4738cbe5de96ae7f49f9c4903119ec2a3a61040 WindWakerHD-v0.2.2-windows-x86_64.zip
0.2.1
- Prise en charge des archives Cemu (.wua) : le jeu accepte désormais les archives .wua déjà décryptées, sans nécessiter de clés.
- Saisie de texte à l’écran : ajout d’un clavier virtuel pour les contrôles (manette/mouse) lors de la saisie du nom.
- Sauvegarde des préférences de manette : le choix entre GamePad et Pro Controller est mémorisé entre les lancements.
- Correction des cheats : les cheats fonctionnent maintenant sur les sauvegardes contenant des morceaux de cœur.
- Suppression du crash au démarrage : résolution du plantage rare lié à l’initialisation des shaders AGL.
- macOS (Apple Silicon) : build .dmg non signé pour macOS 14+ (15+ : autorisation manuelle requise).
The Wind Waker HD, native PC port, v0.2.1
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (glibc 2.35+, Vulkan):
wind-waker-hd;linux-x86_64for x86-64,linux-aarch64for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops)
See "Install (releases)" in the README for details.
What's new
- Cemu archives (
.wua) (issue #27): the setup now also takes a Cemu.wuafile; it is already decrypted, so no keys are needed. Every source (disc image,.wua, extracted folder) is checked for the right game version first (USA, version 0), with a clear message if an update is merged in or the region is different. - Linux on arm64 (aarch64): a separate
linux-aarch64download (Raspberry Pi 5, Asahi Linux, ARM laptops). - On-screen text entry (issue #29): the name screen now shows a text window over the game, with an on-screen keyboard for controllers and the mouse; typing on the keyboard goes straight into it.
- Boot crash fixed: the rare crash right after start ("Prepare Thread", agl shader setup) is gone. GX2CopySurface now completes before it returns, as the game expects; before, a late render thread could write into memory the game had already reused (about every 15th start under load, every start on some phones).
- GamePad / Pro Controller choice is saved between launches (issue #26).
- Cheats now also work on saves with heart pieces (PR #25 by Sean13128).
- Android (rhemfur, PRs #30, #31): pipelines the Adreno driver refuses no longer close the game,
the game threads use at least two fast cores, and arm64 builds treat
charas signed, as on the console.
Checksums (SHA-256)
db2cd5e5c1240833ca0718a3c17cdf8507122f4b8c4573a18446b8e02945d3e5 WindWakerHD-v0.2.1-linux-aarch64.zip
0e8067b116a2b3750b10d690549e6d0b2ee722f6f5017651bba66c36b5019f03 WindWakerHD-v0.2.1-linux-x86_64.zip
f97d4e673f1ee7b0eaa4c68177820cef171dbfaf469f72faafa3588791e9ac6e WindWakerHD-v0.2.1-macos-arm64.zip
e245bcf62e946ca9996ad3f3a07ebc17819a2baaa525a84d0be4b4b24361b566 WindWakerHD-v0.2.1-windows-x86_64.zip
0.2.0
- Portabilité totale : installation dans n’importe quel dossier, sans installation système, avec génération locale du jeu depuis votre dump (fichiers et sauvegardes restent dans le dossier d’extraction).
- Menu de configuration intégré (via F1 ou Cmd+, sur macOS) regrouper tous les paramètres (graphismes, contrôleurs, mods, triche) avec affichage visuel des boutons de manette en temps réel.
- Corrections majeures sur macOS : suppression des goulots d’étranglement CPU sur Metal, résolution du plantage avec Homebrew boost, et sauvegarde des paramètres graphiques entre les sessions.
- Prise en charge native d’Apple Silicon : build .dmg pour macOS 14+ (non signé), avec avertissement Apple à contourner manuellement sur macOS 15+.
- Ajout de triches (via menu ou variable WWHD_CHEATS) : objets illimités, santé/magie infinie, progression accélérée (à tester sur sauvegarde dédiée).
- Améliorations Vulkan : modes de présentation (Vsync, Low latency, Off) configurables en temps réel, et priorité des threads optimisée pour Windows/Linux (comme sur macOS).
- Compatibilité GameCube : outil intégré (tools/savegame) pour importer des sauvegardes de The Wind Waker (GameCube) vers la version HD.
The Wind Waker HD, native PC port, v0.2.0
This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), or an already extracted game folder. The installer builds the game from it on your machine.
Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.
- macOS (Apple Silicon, macOS 14+):
Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open - Windows (x86-64):
Wind Waker HD.exe(SmartScreen: "More info" > "Run anyway") - Linux (x86-64, glibc 2.35+, Vulkan):
wind-waker-hd
See "Install (releases)" in the README for details.
What's new
- v0.2.0: portable releases. Unzip anywhere and start Wind Waker HD: the first start prepares
the game once from your own dump (releases never contain game code, so it is built on your computer);
later starts launch the game directly. Everything — the built game, the game files, saves,
settings, save states, shader caches, logs and the downloaded compiler — stays in the release
folder; nothing goes to your user folders unless you ask for a shortcut. An extracted game folder is
used where it is instead of being copied. Saves and settings can be copied over from an earlier
installation. Hold Shift while starting (or
--setup) to repair, update or change the game. - Settings overlay (Dear ImGui): an in-game menu for everything in one place — save states and Crash Recovery, graphics (renderer, frame rate, resolution, aspect ratio, AO, filtering, FXAA, performance overlay), display, gameplay mods and cheats (Graphics also has the Vulkan presentation mode), controls and language. Open it with F1 (Fn+F1 on most Mac keyboards), Cmd+, / Settings… on macOS, or hold Select / press Home on a controller; it works with mouse, keyboard and controller on every platform and renderer. The Controls tab shows the controller drawing with live feedback of pressed buttons. Shift+F1 still saves state slot 1; slot 1 now loads from the overlay.
- Performance pass (PR #15 by Sean13128): much less render-thread CPU on Metal (no more stutter while the shader cache warms up), a lighter vsync wait on Vulkan, and a fix for the both-renderer build crashing with Homebrew boost installed.
- Cheats (Gameplay menu / overlay, PR #15): all items, best sword and shield, 20 hearts, double magic, 5000 rupees, infinite health/magic/ammo, and story cheats (songs, Triforce shards, dungeon items, keys) — use a spare save file for those.
- Graphics options are remembered between launches (macOS since PR #15; Linux/Windows in
settings.ini). - Controller rumble (PR #13 by arcadematicas).
- Linux/Windows: GamePad touch with the mouse in the GamePad window, F11 / Alt+Enter full
screen, closing the TV window quits (closing the GamePad window hides it), the name-entry text
prompt works again (PR #14 by rhemfur), 1 ms timer resolution on Windows for smoother frame pacing
(PR #12 by rhemfur), and a
--unwindlib=libgccbuild note for clang setups with libunwind. - Console language:
WWHD_LANGUAGE=(or the overlay's Language tab) picks the game's language from those on the disc. - Native Windows LLVM builds (PR #17 by resadent): build with clang and Visual Studio's Windows SDK, without MSYS2 (missing dependencies are built from pinned sources); smoother Vulkan frame pacing on Windows via SDL's high-resolution sleeps.
- Vulkan presentation mode (overlay → Graphics): Vsync (FIFO, default), Low latency
(MAILBOX, where the driver offers it) or Off (IMMEDIATE); switches live and is remembered.
WWHD_VK_PRESENT_MODEoverrides it. - Faster Vulkan on Windows/Linux (PR #18 by resadent): bounded draw batching and a higher game/render thread priority are now on by default, as on macOS.
- GameCube save converter (
tools/savegame): bring your GameCube save file into HD — see Optional: bring your GameCube save to HD.
Checksums (SHA-256)
36243b945b59f07987fe70ce1fb36950b2700a919c97799c8ca50ce249a7ebd6 WindWakerHD-v0.2.0-linux-x86_64.zip
abcb50004950184a5b93f467cf96fb5ac67ab590c899d49ffe47b175fc46a99e WindWakerHD-v0.2.0-macos-arm64.zip
013a5094d66cd28fdd4ec7d442f9e8ca787b8ba77bd0a57197c987f43ee86263 WindWakerHD-v0.2.0-windows-x86_64.zip
Réagir sur le forum
Une question, un retour d’expérience ? Ouvrez la discussion sur le forum.