elliotttate/Wind-Waker-Recomp v0.1.0-macos.3

Wind Waker Recomp 0.1.0 for macOS (Apple Silicon) and Windows (x64) — macos.3

on GitHub

Wind Waker Recomp for Apple Silicon Macs and Windows PCs: The Legend of Zelda: The Wind Waker statically recompiled to run natively, with Metal (Mac) and Direct3D 12 (Windows) rendering, Smooth Motion (60 or 120 frames a second from the game's 30), widescreen, controller, keyboard and mouse support, and Better Wind Waker's settings.

New: Windows x64. WindWakerRecomp-0.1.0-windows-x64.zip is the same game for Windows 10 and 11: unpack it, run BlueWake.exe and choose your disc image. Smooth Motion is on at 60 FPS by default (F10 turns it off and on; the settings choose 120 on a display of 100 Hz or more), and an experimental 60 Hz gameplay mode runs the game itself at 60 on a fast CPU.

New in macos.3: the app's own windows are native. Choosing the disc image, error messages and a progress window for unpacking and preparing it are now built into the app instead of going through AppleScript, so the first launch works the same on any Mac.

macos.2 added compressed disc images: Dolphin's .rvz, .gcz, .wia and .ciso are unpacked once (about a minute) into a plain image in the app's data folder.

You supply the game. The downloads contain the recompiled game code and the runtime, but no disc image, game files, textures, audio or saves. At the first launch the app asks for your own disc image of The Wind Waker, USA (GZLE01), revision 0 (.iso, .gcm, .rvz, .gcz, .wia or .ciso), checks it, and prepares what it needs from it. Other regions and revisions are refused.

Requirements

• Mac: an Apple Silicon Mac (M1 or newer) on macOS 15 or later
• Windows: Windows 10 or 11 (64-bit), a Direct3D 12 GPU, and a CPU with AVX2 (Intel Haswell, AMD Zen or newer)
• Your own legally obtained GZLE01 revision 0 disc image

Install

Mac

1. Download WindWakerRecomp-0.1.0-macos-arm64.zip, unzip it and drag Wind Waker Recomp.app to Applications.
2. Open it. The app is ad hoc signed, not notarized: if macOS blocks it, use System Settings → Privacy & Security → Open Anyway.
3. Choose your disc image when asked.

Windows

1. Download WindWakerRecomp-0.1.0-windows-x64.zip and unpack the whole folder anywhere.
2. Run BlueWake.exe. It is not signed: if Windows says it protected your PC, choose More info → Run anyway.
3. Choose your disc image when asked. An .rvz is unpacked once (a few seconds) to an ISO in %APPDATA%\BlueWake; later launches start the game straight away. To use another image: F1, Sound and files, Choose another disc image.

Keyboard: WASD moves, TFGH turns the camera, J/K/U/I are A/B/X/Y, E/R/Q are L/R/Z, Return is Start. Click the game to steer the camera with the mouse; Esc or F1 opens the options (Smooth Motion 60/120, aspect, resolution, texture packs, Better Wind Waker). On Windows, Space jumps, Shift sprints, F11 or Alt+Enter is fullscreen, F10 toggles Smooth Motion and F9 the frame rate. Saves and settings live in ~/Library/Application Support/Wind Waker Recomp on the Mac and %APPDATA%\BlueWake on Windows.

Full guides: docs/MACOS_RELEASE.md and docs/WINDOWS.md.

Known issues

• Lava around Dragon Roost renders as flat orange instead of its bright pattern (Mac).
• The busiest scenes can dip below 120 at 120 Hz Smooth Motion; 60 is steadier. On Windows, 120 is used only on a display of 100 Hz or more (60 otherwise), and 120 on a 120 Hz display has not been measured on Windows yet.
• The first minutes of a new install hitch while rendering pipelines compile.
• 60 Hz gameplay (Windows, experimental): dialogue, cutscenes and transitions keep their original timing.
• Windows was checked on one PC (Core i9-13900KF, RTX 5090): Smooth Motion 60 FPS shown with the game at its full 30 while running on Outset, 60 Hz gameplay at 59-60. AMD GPUs and CPUs, slower PCs and game controllers have not been tried on Windows yet.

BUILD.json (Mac) and BuilderProvenance.json (Windows) record the exact source revisions and checksums; the zips' SHA-256 are in the .sha256 files. The Windows app was built from windows-release at 640094e; WindWakerRecomp-0.1.0-windows-source.zip is that branch at 459edfe (640094e plus the packaging script, docs and two fixes for building from source).

Not affiliated with or endorsed by Nintendo. The Legend of Zelda: The Wind Waker is Nintendo's.