Find your guide

Independent port guide.

Installation Guide · Wind Waker HD Recomp

How to Install Wind Waker on PC

Unpack HD Recomp, start Wind Waker HD, select your own supported Wii U game and let setup prepare it for your computer. The start-up app, also called the launcher, prepares the game on first use and opens it directly on later starts.

On this page

Before You Start

  • Choose the package matching your system and processor on Download.
  • Match your own HD USA/Europe version-0 input with Game Files.
  • Check the OS and graphics requirements on System Requirements.

Setup translates and compiles the game automatically; desktop preparation takes about two minutes, depending on your computer and the work needed. Choose one system tab and follow its steps through the first launch; phone installation has separate Android and iOS guides.

Install on Windows

1 Choose the Windows package

Use the x86-64 ZIP for Intel/AMD Windows 10 1903+ or Windows 11. Windows 11 on ARM uses the ARM64 ZIP. Download identifies both filenames.

2 Unpack the whole folder

Extract the complete ZIP to a writable folder, including on an external drive if you prefer. Keep the executable, tools/, sdk/ and portable.txt together.

3 Start the launcher and select your game

Open Wind Waker HD.exe. Choose your WUD/WUX image, WUA archive or extracted game folder containing code, content and meta. For a disc image, supply your existing disc/common keys when asked; the format table identifies the inputs.

4 Finish preparation

Let setup extract, translate and compile the game. The package includes Python and downloads its pinned compiler into the release folder without administrator rights. Complete the offered save import if you want existing progress, then launch the game.

Desktop preparation takes about two minutes, depending on your computer and the work needed. For a stopped stage, use setup checks or Troubleshooting.

Install on macOS

1 Choose the Apple Silicon ZIP

Use macOS 14 or newer on an Apple Silicon Mac, a Mac with an Apple processor, and get the Mac package from Download.

Apple menu → About This Mac shows Chip on an Apple-chip Mac and Processor: Intel on an Intel Mac. The HD Recomp Mac package requires an Apple chip; use the Intel Mac emulator choices for a different route.

2 Keep the entire release together

Unpack to a writable folder and leave Wind Waker HD.app beside its supporting files. Move the whole folder when changing its location.

3 Open the app and choose your game

Start Wind Waker HD.app and provide Apple’s Command Line Tools when setup offers them. To install those tools yourself, open Terminal, run xcode-select --install and finish the installer. If macOS blocks the first opening, go to System Settings → Privacy & Security → Open Anyway, then confirm opening the app. Select your supported image, archive or extracted folder; the Game Files checks identify the required edition and layout.

4 Finish preparation and play

Let the local extraction, translation and compilation finish, then complete an optional save import and launch. Desktop preparation takes about two minutes, depending on your computer and the work needed. Metal handles graphics on Mac. Later launches use this same app.

Install on Linux

1 Choose the matching AppImage

Use the x86-64 AppImage, a single-file Linux app, on an Intel/AMD PC or Steam Deck, or the aarch64 AppImage on an ARM64 Linux device. Check glibc 2.35+ and the required Vulkan features, the graphics interface used to draw the game, before starting.

2 Make the file executable

In the file manager, open the AppImage’s Properties → Permissions, enable Allow executing file as program, then open it. Alternatively, open a terminal in its folder and run:

bash
chmod +x "WindWakerHD-v0.5.0-linux-x86_64.AppImage"

For ARM64, replace the filename with WindWakerHD-v0.5.0-linux-aarch64.AppImage. Ubuntu systems with a FUSE startup error can use libfuse2t64, or start with the --appimage-extract-and-run option.

3 Select the game input

Choose your supported disc image, WUA or extracted parent containing all three game folders. An existing extracted folder stays in place.

4 Finish setup and launch

Linux uses your Python 3 and downloads a compiler for preparation. Let extraction, translation and compilation finish, then launch the prepared game; desktop preparation takes about two minutes, depending on your computer and the work needed. You can add the executable AppImage to Steam as a non-Steam game. On Deck, follow the 30 FPS starting recommendation.

Alternative route

Using BlueWake Instead?

Get the Windows ZIP or Linux single-file app from Download → BlueWake, then use your GameCube USA ISO/GCM, game ID GZLE01, revision 0.

Windows: unpack the complete BlueWake ZIP and open BlueWake.exe. Linux: make its x86-64 AppImage executable and open it. Select your own disc image on first start; convert RVZ to ISO in Dolphin first.

On Apple-chip Macs, build BlueWake yourself from source using its personal build instructions. Run this from the project source folder, using your own ISO path:

bash
scripts/builder/build.sh /path/to/your/GZLE01.iso --platform macos --out build/macos

For iPhone or iPad, follow the separate iOS guide.

After Installing

Start or reopen setup

Open the Wind Waker HD launcher to play. Hold Shift at launch on Windows/Mac, or use --setup on Linux, to repair or change the selected game.

Keep your data together

Portable ZIP releases store prepared game data, saves and other local files under data/. AppImage stores game data under ~/.local/share/wwhd and settings under ~/.config/wwhd. An AppImage sitting on an external drive still uses those per-user folders by default.

Open the settings menu

Use F1, or Cmd+, on Mac; controller Home or held Select/Minus also opens Settings. Test the input mapping in Controls, where pressed buttons and stick movement are shown. Save in game, open Settings and choose Quit Game, the exit command.

If Setup Stops

  1. 1
    Check the selected region and version against Game Files.
  2. 2
    Keep the complete release in a writable folder, with its tools beside the launcher.
  3. 3
    Read data/setup-window.log for a portable release, then reopen setup to repair or change the input.

Free Up Space After Installing

You can remove

  • The downloaded compiler can be removed at the end of setup; a later repair downloads it again.

Keep

  • Keep the prepared game data, saves and settings, and keep any extracted input folder that setup uses in place.