Native port, to be completed before release.
Games included
The games this software runs.
The Legend of Zelda : The Wind Waker
Maritime adventure in cel-shading: an ocean to sail across, islands to explore, and a young Link on a quest to save his sister.
Architecture
Download and links
- Download The Legend of Zelda : The Wind Waker
- Source code 643 GitHub stars
- License : GPL-3.0
Version history
0.10.0
- Amélioration des performances : jusqu’à 14 % de gain sur Steam Deck et 6 à 11 % sur Mac (M3 Max) et PC, via une optimisation des registres et des données de collision.
- Correction visuelle majeure : suppression de l’halo sombre autour de Link et des ombres clignotantes dans le mode HD, avec ajustement des nuages, torches et ombres solaires.
- Étoiles réintégrées dans le ciel nocturne, stables avec le Smooth Motion, pour toutes les plateformes.
- Suppression du blocage audio sur macOS : le son ne ralentit plus le jeu comme sur les autres plateformes.
- Nouvelle fonctionnalité pour iPhone/iPad/Android : export des logs de quête au format .gci lisible par Dolphin.
- Prise en charge native du contrôleur Nintendo Switch : bascule automatique des boutons A/B et X/Y, avec un commutateur dédié.
- Construction macOS : uniquement via compilation source depuis un dépôt, avec sauvegardes conservées dans ~/Library/Application Support/BlueWake.
BlueWake 0.10.0 makes the game faster on every platform, most of all on the Steam Deck and slower PCs, fixes the HD look's dark outline around Link and its flickering shadows, puts the stars back in the night sky, and brings the first ready-made Linux AppImage. Every version needs your own USA (GZLE01) disc image. The ready-made Windows and Linux builds include the game code translated from my disc; nothing else from the game is included.
Install
Windows: download BlueWake-v0.10.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Your saves and settings in %APPDATA%\BlueWake carry over. You need Windows 10 or 11 and a CPU with AVX2. SHA-256 of the zip: c56325884ef6f3f4cc502dd6c129e16a6d66316082a546bb3a99476dcd668f66. BlueWake.exe isn't code-signed, so a new build can be flagged by mistake; check the SHA-256 and see If Windows says it's a virus.
Linux and Steam Deck: download BlueWake-v0.10.0-linux-x86_64.AppImage, make it executable (chmod +x, or Properties › Permissions on the Deck's desktop) and run it. On its first start it asks for your disc image. Your saves in ~/.local/share/BlueWake are kept. You need a CPU with AVX2. SHA-256: 2f5c1305de1bf934fdbace34e559fe1c3781380323380c17b73135e3ad1510fc. To build it yourself instead, see docs/LINUX.md.
iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.10.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc. Install it over your current BlueWake to keep your saves.
Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.
Android (experimental): build it yourself from your own disc, as docs/ANDROID.md describes. It now runs on Android 10 and newer.
What's new
Faster everywhere (thanks to irregularthanis and pdale-boop)
- The translated game spends less time saving and restoring registers, and finding where the game keeps its collision data. Against 0.9.0 on the benchmark tour it's 7 to 11% faster at every stop on my Mac (M3 Max) and 8 to 11% on my iPad Pro. Contributors measured about 14% on a Steam Deck (one lava cave a third faster) and about 6% on Windows and Linux PCs. Every build you make trains on its own, so this needs nothing from you.
The Wind Waker HD look (thanks to pdale-boop, for #491)
- No more dark outline around Link, and no dark patch on the floor in front of him.
- Shadows no longer flicker when a hit shakes the camera, the clouds keep their shading, the sky stays sharp, torches are softer, and sun shadows no longer stripe walls or shade islands in blocks.
- A switch for each part of the look, in Wind Waker HD look settings under the look on the Display tab. Sun shadows moved there from Mods › Experimental, and F2 now turns them off with the rest of the look.
- New, off until you turn them on: HD's sky and light (Wind Waker HD's sky colours and sunlight for the hour, with choices for how strong the sunlight is and how dark the sun shadows are), and HD's clouds in the sky. Both read your own Wind Waker HD files, so import your HD textures again to get them. Sun shadows are also timed and shaped as in Wind Waker HD.
Fixes
- The stars are back in the night sky, for everyone, and stay steady with Smooth Motion (thanks to pdale-boop).
- Linux and Steam Deck: closing BlueWake from Steam's menu no longer resets all your settings (#511).
- Mac: the audio no longer holds the game back on top of the clock, as on every other platform (#509).
- Building with PadMint works again on Macs that use Apple's own Python 3.9 (#496).
- Linux's first start says when the data folder is out of space, instead of blaming the disc (thanks to jkoehler11, #479).
- The Windows builder finds the Windows SDK on PCs where a policy blocks
reg.exe(thanks to imcamilouribe).
Menus and controls (thanks to pdale-boop)
- Nintendo button layout: one switch that swaps A and B, and X and Y, so a Switch controller's buttons do what their letters say. It turns on by itself the first time BlueWake starts with a Switch controller or Joy-Cons. It replaces Swap A and B and Swap X and Y: if you had only one of those on, check Controls.
- A setting your settings file left empty now shows its real state (Direct right-stick camera showed off while it was on).
- With a controller, the menu scrolls on to the notes at the end of a tab, and a greyed setting says which switch turns it on.
- Smooth Motion under sustained load: Automatic, or Never pause, for when Smooth Motion keeps pausing while the game holds 30 FPS (thanks to irregularthanis, #473).
Saves
- Export Dolphin Save… on iPhone, iPad and Android writes your three quest logs out as a
.gcithat Dolphin opens. Your card is only read (thanks to jkoehler11, #508).
How it was checked
I built 0.10.0 and 0.9.0 for the Mac from my own disc the same way and ran the benchmark tour on both, alternating, from one saved moment: 0.10.0 was 7 to 11% faster at every stop (Outset, Windfall, Dragon Roost Cavern, Forest Haven, the sea by the Fortress), and both builds reached exactly the same game state at every checkpoint. All 468 places in the stage select ended the same way as in 0.9.0, with my save untouched. With the HD look off the picture matches 0.9.0's, except that the night sky has its stars again; with it on, Outset's pier has no outline around Link and no dark band on the sea. I installed 0.10.0 on my iPad Pro, where the same tour ran 8 to 11% faster than 0.9.0 did last week. PadMint made a complete iPhone and iPad build of this release on a Mac the way a player's PadMint does, from a fresh copy of the source with Apple's Python. Exporting a Dolphin save from my own card wrote all three quest logs and left the card as it was.
I built the Windows version on my PC (Ryzen 7 5700U) from my own disc and the same commit: it started with Direct3D 12 and quit cleanly. I didn't play it on Windows this time, so the HD look, the stars, saving and the controller menu haven't been checked by hand there, and I haven't measured its speed against 0.9.0 myself. The Linux AppImage was built on the same PC from the same commit in the Linux CI container; it passed its compatibility check (it needs nothing newer than glibc 2.38) and started to the title screen. I haven't played it on Linux or a Steam Deck myself; contributors have played these changes on Linux and measured them on a Steam Deck.
Known problems
- On slower CPUs the game can still dip below full speed where its own thread is the limit, at Outset most of all (#215, #427).
- With the HD look's sun shadows, Outset at sunrise shows streaks.
- Dragon Roost Cavern can flicker on Windows at 60 FPS and above (#483); it's being looked into.
- Some flags and the poles on the barrels are missing their textures (#505, #69).
- The Wind Temple's rooms R04 and R08 need an opt-in switch to load from the stage select (#318).
Thanks to pdale-boop, irregularthanis, jkoehler11, imcamilouribe, and everyone who reported a bug.
Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows; ~/.local/share/BlueWake/logs on Linux; ⋯ › Help & Feedback › Share Session Log on iPhone and iPad).
0.9.0
- Performances optimisées sur Mac, iPhone et iPad : les builds locales atteignent désormais les mêmes performances que Windows/Linux (jusqu’à +79 % de FPS sur iPad Pro M2/M3).
- Correction du dip de caméra en mode "Direct right-stick camera" (tous les quelques secondes).
- Suppression du flicker avec Smooth Motion au-delà de 60 FPS (HD, nuages, vagues, natation).
- Menu unique pour Windows, Mac et Linux, avec navigation au pad, ajustement de contraste et taille de texte.
- Contrôleurs : possibilité de jouer en arrière-plan même si une autre fenêtre est active (option désactivée par défaut).
- HD textures : import depuis une image disque Wind Waker HD (WUD/WUX) avec gestion des clés (fichier ou keys.txt).
- Partage de logs sur iPhone/iPad/Android : inclut la session précédente pour les rapports de crash post-redémarrage.
BlueWake 0.9.0 makes the Mac, iPhone and iPad builds as fast as the PC builds, fixes the camera dipping with the right-stick camera, stops the flicker with Smooth Motion, and brings one settings menu to every computer. Every version needs your own USA (GZLE01) disc image. The ready-made Windows build includes the game code translated from my disc; nothing else from the game is included.
Install
Windows: download BlueWake-v0.9.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Your saves and settings in %APPDATA%\BlueWake carry over. You need Windows 10 or 11 and a CPU with AVX2. SHA-256 of the zip: 3c0edc36241fc1783693e1a9fa942995f4f32efec14fb3a9afc889a595da61ce. BlueWake.exe isn't code-signed, so a new build can be flagged by mistake; check the SHA-256 and see If Windows says it's a virus.
iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.9.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc, now with the faster preparations below. Install it over your current BlueWake to keep your saves.
Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.
Linux: build it from this release's source with python3 scripts/linux/build.py /path/to/GZLE01.iso (steps in docs/LINUX.md). The container build works again at the player's CPU target. Contributors have built the AppImage from this release's commit with their own discs; a ready-made one will be added to this release once it's checked and uploaded.
Android (experimental): build it yourself from your own disc, as docs/ANDROID.md describes; the builder now runs on a Mac as well as Windows.
What's new
Much faster on Mac, iPhone and iPad
- Builds you make with PadMint or the builder now get the same module preparations and behaviour timing as the Windows and Linux builds. On the benchmark tour that's 75 to 79% more game frames a second on an iPad Pro (M2) and 64 to 77% on an M3 Max, with a smaller game module and a much shorter build. At normal speed the iPad's game thread is about half idle.
--conservativebuilds it the old way.
Fixes
- The camera no longer dips for a frame every few seconds with Direct right-stick camera and aiming on (thanks to jslay88).
- No more flicker with Smooth Motion above 60 FPS in the HD look, the clouds, the wave crests and swimming (thanks to pdale-boop).
- Linux builds at the player's CPU target again (thanks to jslay88).
One menu on every computer (thanks to pdale-boop)
- Windows, Mac and Linux draw the same settings menu from one list, with controller navigation, contrast and text size, a Config tab, greyed settings that say why, and pausing under the menu as a setting.
Controls
- A controller can keep playing while another window is in front (Controls, off by default).
- Keep the right-stick camera but aim with the left stick: turn off The right stick aims too (first person, items).
- On iPhone and iPad, the menu's switches keep the menu open, so you can change several settings in one visit.
HD textures from a real Wind Waker HD disc image (thanks to jkoehler11)
- The importer reads the content a real WUD/WUX stores, takes a key file, a pasted key or an emulator
keys.txtas it is, keeps the form after a mistake, and says what it imported and skipped.
Also new
- Sun shadows from a shadow map in the HD look, so what's off screen still casts a shadow (thanks to pdale-boop). Off by default, under Mods › Experimental.
- A sea compass switch: the red end points the way you're sailing (thanks to jslay88). Off by default, with Better Wind Waker's settings.
- On iPhone, iPad and Android, Share Session Log includes the session before, so a crash can be reported after relaunching.
How it was checked
I built the Mac and iPad versions from my own disc and played the iPad build: steady at 30 FPS with no dips, Smooth Motion and the touch controls fine. On the iPad Pro the benchmark tour (Outset, Windfall, Dragon Roost Cavern, Forest Haven, the sea by the Fortress) ran 75 to 79% faster than 0.8.0 at every stop, with my save untouched. On the Mac all 468 places in the stage select ended the same way as in 0.8.0, and a scripted stand-still with the right-stick camera showed no dips in three minutes, against one every few seconds without the fix. I built the Windows version on my PC (Ryzen 7 5700U) from my own disc, from the same commit, in 85 minutes; it started, drew with Direct3D 12 and quit cleanly after a long run at the title and opening. I didn't play it on Windows this time, so the camera, Smooth Motion and saving haven't been checked by hand there. I built the iPhone and iPad app without game code from this release's commit and checked that it holds no game code. PadMint then made a complete iPhone and iPad build from it on a Mac the way a player's PadMint does, from a fresh copy of the source.
Known problems
- 0.9.0 doesn't make Windows, Linux, the Steam Deck or Android faster than 0.8.0. On slower CPUs the game can still dip below full speed where its own thread is the limit (#215, #427); that's the next version's focus.
- The Wind Temple's rooms R04 and R08 need an opt-in switch to load from the stage select (#318).
Thanks to pdale-boop, jslay88, jkoehler11, irregularthanis, benwolfram, cforain, LiquidAzir and Elliott Tate.
Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows; ⋯ › Help & Feedback › Share Session Log on iPhone and iPad).
0.8.0
- Ajout d’un rendu HD inspiré de The Wind Waker HD (désactivé par défaut), incluant brouillard de profondeur, occlusion ambiante, ombres de nuages et éclairage doux, contrôlable via F2 ou les mods.
- Intégration de textures HD personnalisées depuis une sauvegarde Wii U décryptée ou une image WUD/WUX, via Mods › Wind Waker HD textures › Import from Wind Waker HD…, sans dépendance à Python.
- Amélioration des performances par défaut sur Windows et Linux (7 à 11 % de gain sur Intel, 9 % sur Steam Deck) grâce à l’optimisation des timings et des appels système.
- Uniformisation des menus et raccourcis (F1 à F10) et prise en charge des contrôles (D-pad, gyroscope, écrans 21:9) sur toutes les plateformes.
- Correction de bugs critiques : Lenzo accepte désormais les bonnes photos, les cartes d’île s’affichent correctement, et le marchand de Greatfish reste en place.
BlueWake 0.8.0 brings the Wind Waker HD look, HD textures you make from your own Wind Waker HD game inside the app, more speed by default on Windows and Linux, the same menus on every computer, and an experimental Android build. Every version needs your own USA (GZLE01) disc image. The ready-made Windows build includes the game code translated from my disc; nothing else from the game is included.
Install
Windows: download BlueWake-v0.8.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Your saves and settings in %APPDATA%\BlueWake carry over. You need Windows 10 or 11 and a CPU with AVX2. A Direct3D 12 GPU is best. On older GPUs BlueWake now tries Direct3D 11 instead of showing a black screen; I haven't been able to check that on such a PC yet, so tell me how it goes.
Linux: build it from this release's source with python3 scripts/linux/build.py /path/to/GZLE01.iso (steps in docs/LINUX.md). A ready-made AppImage will be added to this release once one is built and checked.
iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.8.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc. Install it over your current BlueWake to keep your saves.
Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.
Android (experimental): build it yourself from your own disc on a Windows PC, as docs/ANDROID.md describes (thanks to LiquidAzir). It's checked on one phone so far.
What's new
The Wind Waker HD look, off by default
- Islands on the horizon from further away, bloom, the far-distance blur, ambient occlusion, cloud shadows, and edge and torch light, kept gentle so the game keeps its colours. Press F2 on Windows, Mac and Linux, or turn it on under Mods on iPhone and iPad. Each piece can be turned off by itself (
docs/WWHD_LOOK.md).
HD textures from your own Wind Waker HD game
- Mods › Wind Waker HD textures › Import from Wind Waker HD… makes the texture pack, HD menus and HUD included, from your decrypted HD dump or a USA WUD/WUX image with its keys, on Windows, Mac, Linux, iPhone and iPad. No Python, and nothing from the Wii U game is included in BlueWake.
Faster
- Behaviour timing is on by default on Windows and Linux: 7 to 11% faster on Intel desktops and 9% on the Steam Deck.
- Lighter checks around the game code (thanks to pdale-boop) and Elliott Tate's faster returns and calls.
- On Wayland the game runs at full speed (thanks to jslay88).
The same menus and keys on every computer (thanks to pdale-boop)
- F1 settings, F2 the HD look, F5 and F8 save and load state, F7 the stage select, F9 the frame rate, F10 Smooth Motion, F11 fullscreen. The Windows menu works with a controller, and Linux gets Restart now and safe mode.
Controls
- The D-pad moves the cursor in Items and Quest Status, gyro aiming with a DualSense, DualShock 4, Switch Pro or Steam Deck, swapping L and R, and 21:9 widescreen.
Fixes
- Lenzo accepts the right Picto Box photos (thanks to jslay88).
- Each island's sea chart shows its own map.
- The Greatfish merchant stays on his raft (thanks to jslay88).
- Resizing the window on Linux no longer crashes (thanks to pdale-boop).
Also new
- The developers' stage select, off by default, with 468 places to jump to from your own file (thanks to pdale-boop).
- Linux: portable mode, a working texture-pack folder picker (thanks to jkoehler11), and the build container (thanks to cforain).
How it was checked
I built the Windows version on my PC (Ryzen 7 5700U) from my own disc, from the same commit, in 81 minutes. It starts, draws with Direct3D 12 and quits cleanly; I only tried it briefly at Outset this time. I built the iPhone and iPad app without game code from this release's commit and checked that it holds no game code. PadMint then made a complete iPhone and iPad build from it on a Mac the way a player's PadMint does, from a fresh copy of the source. I also built the Mac version from my own disc: all 468 places in the stage select were tried (446 load; the rest are test rooms, known crash rooms and story scenes my file hasn't reached), and the benchmark tour ran through Outset, Windfall, Dragon Roost Cavern, Forest Haven and the sea by the Fortress with no slowdowns.
Known problems
- With Smooth Motion above 60 FPS, clouds and the HD look can flicker on some PCs (#136). pdale-boop's fix is in progress (#371).
- The Wind Temple's rooms R04 and R08 need an opt-in switch to load from the stage select (#318).
- Busy scenes can still run below full speed on slower CPUs, including the Steam Deck (#215). Speed stays the main focus.
Thanks to Elliott Tate, pdale-boop, jslay88, cforain, jkoehler11, LiquidAzir and irregularthanis.
Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows).
0.7.0
- Améliorations de performance majeures : optimisation des copies de blocs (5 à 12 % de gain) et fusion des dessins graphiques (jusqu’à 60 % de FPS en plus sur CPU lentes, via AVX2).
- Correction des bugs de contrôleurs : détection automatique du contrôleur en port 1 au démarrage, rumble ciblé sur le contrôleur actif, et gestion du stick gauche pour la Pictobox.
- Stabilité améliorée : suppression d’un crash rare (unmapped pc=0x8180fff0) et gestion des sessions log plus détaillée (API graphique affichée).
- Personnalisation étendue : positionnement du compteur FPS en coin et option de zoom caméra (main droite + stick droit).
- Build macOS : compilation depuis le source avec scripts/builder/build.sh (sauvegardes conservées dans ~/Library/Application Support/BlueWake).
BlueWake 0.7.0 is faster, especially on older and smaller CPUs, and fixes several controller problems. Every version needs your own USA (GZLE01) disc image. The ready-made Windows build includes the game code translated from my disc; nothing else from the game is included.
Install
Windows: download BlueWake-v0.7.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Your saves and settings in %APPDATA%\BlueWake carry over. You need Windows 10 or 11, a Direct3D 12 GPU, and a CPU with AVX2.
iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.7.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc. Install it over your current BlueWake to keep your saves.
Linux: build it from this release's source with python3 scripts/linux/build.py /path/to/GZLE01.iso (steps in docs/LINUX.md). A ready-made AppImage, with a setup window that asks for your disc the first time, comes with 0.8.0.
Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.
What's new
Faster
- Elliott Tate's lean block copies are now how BlueWake builds the game: 5 to 12% faster, most on slower CPUs (measured by pdale-boop).
- Windows: Elliott's draw fusion sends the graphics card about a tenth as many draws, so busy places like Forest Haven, Hyrule and boss fights no longer wait on graphics. On slower CPUs he measured 30 to 60% more frames there.
- Faster single-precision float loads in the game code, also from Elliott.
- Linux: the game compiles about twice as fast when you build it, and runs up to 10% faster on slower CPUs (pdale-boop).
- Building your own copy is faster everywhere: the optimization training takes about 12 minutes instead of 30 (pdale-boop), and a second build into the same folder works again.
Smoother
- With Smooth Motion on, CPUs with 8 threads or more no longer drop to 30 for seconds after a hitch.
Controllers
- A controller that's already plugged in when BlueWake starts now gets the smooth stick and plays as player 1 (#138).
- With a GameCube adapter, press a button on your controller and it becomes player 1, even if it isn't in port 1 (#155).
- Rumble only shakes the controller you're playing with (#190).
- The left stick works at the Pictobox's "keep this picture?" and in the gallery (#191).
- New, optional: hold the right-stick click and move it up or down to zoom the camera, under Controls (thanks to cforain).
Fixes and more
- A rare crash that could stop the game anywhere (
unmapped pc=0x8180fff0), tracked down by pdale-boop. - Windows: the window opens where you left it (thanks to saulob), and portable mode keeps your remaps and window layout in its own folder (#64).
- You can place the FPS counter in a corner, under Display (thanks to saulob).
- The session log names the graphics API in use, and Linux says when it fell back to a much slower renderer because Vulkan is missing.
How it was checked
The Windows build was made on my PC (Ryzen 7 5700U) from my own disc, and it starts, runs and quits cleanly there. Every change passed the Windows and Linux builds and tests. The speed changes were measured before they went in: lean blocks by pdale-boop on Windows and Linux, including a 15-minute play session, and draw fusion by Elliott, who checked that the game plays the same. I built and checked the iPhone and iPad app without game code, the source and the PadMint recipe on a Mac. I haven't yet played this build with a controller on every platform, so if something doesn't work on your setup, please tell me.
Known problems
- Draw fusion is on for Windows only for now. On Linux and Mac you can try it with
DOL_GX_FUSE=1; tell me how it looks. - Busy scenes can still run below 30 FPS on slower CPUs, including the Steam Deck (#86, #137, #159, #215). Speed stays the main focus.
- Clouds and distant waves can flicker at 60 and 120 FPS on some NVIDIA GPUs (#136).
- Some controllers, like the 8BitDo GameCube mod kit in Android mode, can have a scrambled layout from
gamecontrollerdb.txt(#61).
Thanks to Elliott Tate, pdale-boop, jkoehler11, cforain, saulob and LiquidAzir.
Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows).
0.6.0
- Restauration des cartes de donjons : affichage à nouveau des grilles et des pièces dans les donjons (#74).
- Correction du silence lors de l’intro historique : la musique de l’intro après l’écran de titre est rétablie sur toutes les plateformes (#97).
- Contrôleurs fonctionnels : détection et utilisation des contrôleurs (y compris ceux via gamecontrollerdb.txt) en tant que joueur 1 (#61).
- Suppression du miroir du bâton du vent : la conduite avec le bâton du vent n’est plus inversée (#156).
- Stick gauche corrigé : suppression de la zone morte et des sauts brutaux, accélération progressive (#138).
- Option d’inversion du stick gauche : possibilité d’inverser haut/bas du stick gauche pour le ciblage en première personne ou avec un objet (#154).
- Construction depuis les sources : prise en charge de Visual Studio 2022 pour les builds (#153).
BlueWake 0.6.0 is for Windows, Mac, iPhone and iPad. It fixes the most reported problems since 0.5.0: dungeon maps, the silent intro, controllers that did nothing, the reversed Wind Waker baton and the left stick's dead zone. Every version needs your own USA (GZLE01) disc image. Nothing from the game is included.
Install
Windows: download BlueWake-v0.6.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Your saves and settings in %APPDATA%\BlueWake carry over. You need Windows 10 or 11, a Direct3D 12 GPU, and a CPU with AVX2.
iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.6.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc. Install it over your current BlueWake to keep your saves.
Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.
What's new
- Dungeon maps show their grid and rooms again (#74).
- The history intro after the title screen has its music again on every platform, even when you wait for the title music first (#97).
- Controllers that were detected but did nothing now play as player 1. That includes ones recognized through
gamecontrollerdb.txt, and a second controller left over after the first is unplugged (#61). - Conducting with the Wind Waker on a controller is no longer mirrored (#156).
- The left stick has no big dead zone or sudden jump anymore, and reaches full speed near the end of its travel (#138).
- New option under Controls: invert the left stick's up and down while aiming in first person or with an item (#154).
- iPhone and iPad: touch controls are released when Apple's menus open, so a button no longer stays pressed.
- iPhone and iPad: the app without game code now says so plainly on its first screen, with a How to Add the Game button, and explains why a picked file was refused (for example a Dolphin
.rvzthat needs converting to ISO). - Quitting is cleaner on every platform, thanks to a fix from the Linux port.
- Building from source works with Visual Studio 2022 again (#153).
- The session log names the controller mapping in use, which helps with controller reports.
How it was checked
I built and checked the iPhone and iPad app without game code, the source and the PadMint recipe on a Mac (M3 Max), and made a full PadMint build from my own disc. The intro's music was confirmed in captured audio on the Mac and in the iPad simulator, and the dungeon map, save loading and the game's start were checked on the Mac. The Windows build was made on my PC (Ryzen 7 5700U) from my own disc, and a long session there played the fixed intro to its end. The new controller fixes are covered by tests with the real controller libraries, but not yet with a physical controller on every platform, and the dungeon map hasn't been checked on Windows yet. If something doesn't work on your setup, please tell me.
Known problems
- Some later cutscenes can still lose their music or sound, such as the bird dropping Tetra (#65).
- Clouds and distant waves can flicker at 60 and 120 FPS on some NVIDIA GPUs (#136).
- HD texture packs can cause dark shading on some AMD GPUs (#80).
- Busy scenes run below 30 FPS on many CPUs, including the Steam Deck (#86, #137, #159). Performance is the next big focus.
- Some controllers, like the 8BitDo GameCube mod kit in Android mode, can have a scrambled layout from
gamecontrollerdb.txt(#61).
Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows).
Files
BlueWake-v0.6.0-windows-x64.zip: the Windows build. It contains code translated from the game, so it needs your own disc image to play.BlueWake-v0.6.0-source.zip: the source for this release.BlueWake-v0.6.0-ios-unsigned.ipa: the iPhone and iPad app without game code, for PadMint.BlueWake-v0.6.0-padmint.json: the recipe PadMint follows for this version.SHA256SUMS: checksums for all of the above.
0.5.0
- Nouveautés majeures : ajout du mode "Exact" pour le son sans crash, restauration du sol sableux de Molgera dans le Temple du Vent, et activation du menu "Quitter le jeu" dans le menu F1.
- Améliorations des contrôles : remappage des boutons de manette et du clavier/mouse pour les boutons GameCube, avec support des layouts Nintendo (échanger A/B ou X/Y).
- Corrections techniques : suppression du redémarrage automatique des paramètres au lancement, suppression des blocages lors de la prise de photos avec le Pictobox.
- Stabilité et compatibilité : message d'erreur clair si le CPU ne supporte pas AVX2, suppression de la logique expérimentale 60 FPS, désactivation par défaut de Smooth Motion et Jump/Run.
- Mac : construction depuis les sources avec script intégré, sauvegardes conservées dans ~/Library/Application Support/BlueWake, support natif du remappage clavier/manette et du fichier gamecontrollerdb.txt.
BlueWake 0.5.0 is for Windows, Mac, iPhone and iPad. On Windows, it's the first build made from BlueWake's own code, and it replaces the Wind Waker Recomp 0.4.0 build. Every version needs your own USA (GZLE01) disc image. Nothing from the game is included.
Install
Windows: download BlueWake-v0.5.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Then choose your disc image (.iso or .gcm). To use a Dolphin .rvz, convert it to ISO in Dolphin first: right-click the game and choose Convert File. You need Windows 10 or 11, a Direct3D 12 GPU, and a CPU with AVX2 (Intel Haswell from 2013, AMD Ryzen, or newer). Your saves in %APPDATA%\BlueWake carry over from 0.4.0. For a portable install, put an empty portable.txt next to BlueWake.exe, and saves, settings and logs stay in a user folder beside it.
iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.5.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc. Install it over your current BlueWake to keep your saves.
Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.
What's new on Windows, compared with 0.4.0
- Choosing "Exact" sound no longer crashes the game (#58). If a launch ever does crash, the next one starts safely with the mods off, keeps a copy of your settings, and tells you what happened.
- Molgera's arena in the Wind Temple has its sand floor again (#126).
- On a processor without AVX2, BlueWake now shows a message instead of closing without a word (#77).
- Portable mode with
portable.txt(#64). - You can change which keyboard key and which mouse button presses each GameCube button (F1 › Controls). For example, right-click can be B.
- Controller button remapping (#66), plus Swap A and B and Swap X and Y for Nintendo-style layouts (#55).
- Controllers SDL doesn't recognize (#61): put
gamecontrollerdb.txtfrom SDL_GameControllerDB in the folder with your saves. - The camera no longer flips direction in water (#73), and the controller's camera invert setting works everywhere.
- "Quit the game" is in the F1 menu, and Brisk Sail, Unrestricted boat and Invert camera now explain what they do.
- Settings no longer reset themselves when the game starts.
- Taking a Pictobox photo no longer freezes the picture (#13).
- Smooth Motion (in-between frames) is off by default (#79). Press F10 to turn it on. 0.4.0's experimental 60 FPS game logic is gone.
- Jump and Run are off by default (#71). Turn them on under F1 › Mods.
- Elliott's work since 0.4.0: HD texture packs without shimmer, the Wind Waker HD texture importer, Forest Water options, and steadier Smooth Motion.
- The first-launch disc prompt explains how to convert an
.rvz.
What's new on Mac, iPhone and iPad, compared with 0.2.0
- Molgera's sand floor in the Wind Temple (#126), on every platform.
- Mac: change which keyboard key and mouse button presses each GameCube button. Controller button remapping (#66), and
gamecontrollerdb.txtsupport (#61). - Mac: the camera invert setting also applies when the game's own camera has the view (#73). Jump and sprint are off by default.
- PadMint and the builder work with the Python that comes with macOS. Builds used to fail with a
write_text()error.
How it was checked
Windows was built from this release's commit and checked on one PC, a Ryzen 7 5700U with integrated Radeon graphics. Checked there: the game runs, the intro plays all its sound, Exact sound starts, crash recovery, the AVX2 message, portable mode, keyboard remapping and the Molgera floor. Not tried on Windows yet: mouse-button remapping, the Quit button and option notes, the camera invert, and controllers. Other GPUs and long play sessions also aren't covered yet.
On the Mac, the Molgera floor and keyboard and mouse remapping were checked in the game. The iPhone and iPad app starts in the iOS Simulator, but it hasn't been run on a device with this release.
Known problems
- Dungeon maps show the room markers but not the map itself (#74). The cause is known, and the fix is next.
- Some cutscenes lose their music or sound on Windows (#65, #97), for example when Aryll is taken on the bridge. Reports link it to mods, HD textures or the mouse camera.
- Slow scenes: the bird scene at the start (#59), and busy places like Outset and the open sea on some PCs (#86).
- In portable mode,
imgui.iniis still written to%APPDATA%\BlueWake(#64). - The pirate ship's flag may still lack its texture (#69).
- The Tingle Tuner isn't supported: it needs a Game Boy Advance linked to the GameCube. Better Wind Waker's "Tingle Chests without the Tingle Tuner" option, on by default, opens the chests with ordinary bombs.
Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows).
Files
BlueWake-v0.5.0-windows-x64.zip: the Windows build. It contains code translated from the game, so it needs your own disc image to play.BlueWake-v0.5.0-source.zip: the source for that build.BlueWake-v0.5.0-ios-unsigned.ipa: the iPhone and iPad app without game code, for PadMint.BlueWake-v0.5.0-padmint.json: the recipe PadMint follows for this version.SHA256SUMS: checksums for all of the above.
0.2.0
- Intégration du travail de recompilation d’Elliott’s Wind Waker : mode Smooth Motion optionnel (60, 120 ou 240 FPS), améliorations visuelles (eau, HUD, vêtements, couleurs), support du 16:10, sauvegardes, escalade murale, portes rapides, caméra fast stick, vibrations de contrôleur et gestion des packs de textures HD sans scintillement.
- Correction du blocage de la Pictobox et de la caméra inversée dans l’eau, avec une indication claire du mode Smooth Motion suspendu dans le compteur FPS.
- Construction et installation via PadMint sur macOS : mise à jour possible en écrasant l’existant pour conserver les sauvegardes, sans téléversement de données locales.
- Optimisation des performances : stabilisation du Smooth Motion, compilation multithread des shaders et cache intégré plus volumineux pour réduire les calculs graphiques.
- Ajout de logs de session détaillant les causes des ralentissements et le statut des musiques streamées, utiles pour les rapports de bugs.
Windows: download BlueWake-v0.4.0-windows-x64.zip, unpack the whole folder, run BlueWake.exe and choose your own disc image (.iso or .gcm). It is Elliott's Wind Waker Recomp 0.4.0 build with the same program files, unchanged in this release. It needs Windows 10 or 11, a Direct3D 12 GPU and a CPU with AVX2 (Intel Haswell from 2013, AMD Ryzen, or newer). A Dolphin .rvz must be converted to ISO in Dolphin first. This build has Smooth Motion (in-between frames) on by default; press F10 to turn it off. The next Windows build from BlueWake starts with it off.
Mac, iPhone and iPad: BlueWake 0.2.0. Build it from your own disc with PadMint; it downloads the app below (no game code) and adds the game made from your disc. Nothing from your disc is uploaded. If you're updating, install over your existing BlueWake to keep your saves.
What's new since 0.1.0
- Elliott's Wind Waker Recomp work, merged: optional Smooth Motion at 60, 120 or up to 240 FPS (off by default) with smoother water, HUD, cloth and colours; widescreen 16:10; save states; climbing any wall; quick doors; the fast stick camera; controller vibration; HD texture packs without shimmer; the Wind Waker HD texture importer; Forest Water options.
- Fixes: the Pictobox freeze; the camera turning the other way in water; the FPS counter now says "Smooth Motion paused" instead of showing 60.
- Speed: steadier Smooth Motion pacing, shaders compiled on several threads, a larger built-in shader cache, and lighter graphics work.
- Apple TV builds (experimental).
- Session logs name the cause of each slow second and show whether a scene's streamed music started; attach one to bug reports.
Files
BlueWake-v0.2.0-ios-unsigned.ipa: the iPhone/iPad app without game code.BlueWake-v0.2.0-padmint.json: the recipe PadMint follows for this version.BlueWake-v0.4.0-windows-x64.zipandBlueWake-v0.4.0-windows-source.zip: the Windows build and its source.SHA256SUMS: checksums.
0.1.0
- Portage natif de The Legend of Zelda: The Wind Waker pour iPhone/iPad via PadMint, nécessitant un Mac Apple Silicon avec Xcode et ~25 Go d'espace.
- Processus manuel : conversion du disque GameCube USA (GZLE01, révision 0) en module personnalisé via PadMint, sans partage des données du disque.
- iOS/iPadOS minimum requis : version 17 ou ultérieure, compatible avec les appareils A13 ou plus récents.
- L’IPA fournie (BlueWake-v0.1.0-ios-unsigned.ipa) est vide et affiche un message d’erreur sans module de jeu.
- Sauvegardes et paramètres compatibles avec les versions précédentes de Wind Waker Recomp via PadMint.
- Pas de build précompilé pour macOS ou iOS : construction obligatoire depuis le code source et un disque propriétaire.
Windows: download BlueWake-v0.4.0-windows-x64.zip, unpack the whole folder anywhere, run BlueWake.exe and choose your own disc image the first time. This is Elliott's Wind Waker Recomp 0.4.0 build, now published here with the same program files. Saves and settings from Wind Waker Recomp carry over (%APPDATA%\BlueWake).
- Needs Windows 10 or 11 (64-bit), a Direct3D 12 GPU and a CPU with AVX2 (Intel Haswell, AMD Zen or newer).
- Your own GameCube The Wind Waker, USA (
GZLE01, revision 0), as an.isoor.gcm. A Dolphin.rvzmust first be converted to ISO in Dolphin: right-click the game, Convert File, format ISO. - BlueWake is not signed, so Windows may say it protected your PC: choose More info, then Run anyway.
- The download contains the recompiled game code, but no disc image, game assets or saves. Play it from a disc you own.
Mac, iPhone and iPad: build your own from your disc with PadMint, below or in the README. No prebuilt app with game code is provided for these.
BlueWake 0.1.0 for iPhone and iPad: The Legend of Zelda: The Wind Waker, running natively. The app below contains no game code: you make the game part yourself with PadMint on an Apple Silicon Mac, from your own disc. Nothing from your disc is uploaded.
What you need
- Your own GameCube The Wind Waker, USA (
GZLE01, revision 0), as a disc image. - An Apple Silicon Mac with Xcode, and about 25 GB of free space.
- An A13 or newer iPhone or iPad on iOS/iPadOS 17 or later, and AltStore Classic, SideStore or Sideloadly.
Get it
- Download PadMint, unzip it and double-click
PadMint.command(the first time, macOS asks you to allow it in System Settings → Privacy & Security → Open Anyway). - Choose BlueWake and drag in your disc image. PadMint downloads
BlueWake-v0.1.0-ios-unsigned.ipabelow, checks it, builds your game module from your disc and adds it. The first build takes well over an hour; it tunes the game on your Mac. - Install the IPA PadMint saves with your sideloading tool, over an existing BlueWake to keep your saves, then copy the same disc image to the device (Files › BlueWake). The IPA contains code made from your disc: keep it to yourself.
Without the module, the app opens and shows "Translated game code: Missing".
Files
BlueWake-v0.1.0-ios-unsigned.ipa: the app without game code (built from 8049773; content check passed).BlueWake-v0.1.0-padmint.json: the recipe PadMint follows for this version.BlueWake-v0.4.0-windows-x64.zip: the Windows build (Wind Waker Recomp 0.4.0, built from 7ca0cb9; contains game code).BlueWake-v0.4.0-windows-source.zip: the source of that Windows build.SHA256SUMS: checksums of all four.
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.