Wind Waker PC Troubleshooting: Crashes and Graphics
Match your symptom and project below: HD Recomp and BlueWake use different game inputs, graphics paths and saved-data locations. For a first installation, begin with the installation guide.
On this page
Find Your Symptom
Symptom First thing to try Detailed helpFixed in newer versions
| Symptom | Fixed in | Detailed help |
|---|---|---|
| HD Recomp old RX 6700 XT output stays near 30 FPSUpdate the old build. | v0.2.5 | Older graphics |
| BlueWake old sea chart repeats an islandUpdate the old build. | v0.8.0 | Older graphics |
| BlueWake GameCube controller adapter is ignoredUpdate; press a button on the controller at the title. | v0.7.0 | Menu and controllers |
| BlueWake old intro or scripted-scene audio missingUpdate the older program. | v0.6.0 | Audio |
Game Won't Start or Setup Rejects Files
- Open the start-up app from the complete unpacked release:
Wind Waker HD.exe,Wind Waker HD.app, or the Linux single-file app (AppImage). - Keep the release in a writable folder with its
tools/,sdk/andportable.txt. - Select the supported USA/Europe base game, version 0; for an extracted folder, choose the parent containing
code,contentandmeta. - Reopen setup with Shift at launch on Windows/Mac or --setup on Linux to repair or change the input.
Setup checks code/cking.rpx, the HD game’s program file, before translating; a folder with update files copied over it can fail that check. Use Game Files for the accepted fingerprints and layout.
BlueWake startup
Use your own GameCube USA ISO/GCM, game ID GZLE01, revision 0, with AVX2 CPU support for Windows/Linux. On Windows, unpack the entire program ZIP before opening BlueWake.exe; on Linux, make the AppImage executable before opening it. Use BlueWake installation for that route’s launch steps.
First launch is preparing graphics
- Check the progress stage and read
data/setup-window.logon a portable desktop installation. - Reopen setup with Shift at launch on Windows/Mac, or --setup on Linux, to repair or change the selected input.
- On Android, continue with Start / resume / retry setup; cancelling model preparation keeps completed work.
Desktop preparation takes about two minutes, depending on the computer and work needed. Shader preparation builds small graphics programs from your own game; a scene outside that preparation can still stutter on first use. On Android, model-graphics preparation can take about 40 minutes on a recent phone and longer on older ones.
Black window or an immediate exit
- Check your operating system, processor and graphics support on System Requirements.
- Open the start-up app from the complete writable release folder, keeping
tools/,sdk/andportable.txttogether. - Keep
data/setup-window.logordata/captures/crash-*.logfrom the failing run and use the report checklist.
Graphics Glitches
BlueWake clouds and waves
The cloud/wave fix for Smooth Motion, which adds pictures between original frames, shipped in v0.9.0. Update an older copy using Updates. If the flicker continues with Smooth Motion, switch that experimental option off with F10 or its Display-menu control. If it still flickers, describe the scene and attach your session log to the BlueWake flicker thread.
BlueWake current graphics issues
For Dragon Roost Cavern flicker on Windows at 60 FPS and above, switch Smooth Motion off with F10 and check the same scene again. For missing flag/barrel-pole textures or sunrise shadow streaks, note the scene and send it with your session log to BlueWake Issues.
Graphics-pack conflicts
If graphics changed after adding packs, check which packs alter the same effect and keep conflicting changes separate. Use the manager’s setup and restart status when applying a change, then reopen the game for changes marked Restart to apply. The complete manager workflow is on Mods.
Older graphics problems
| Older symptom | Released action |
|---|---|
| HD Recomp output stuck near 30 FPS on RX 6700 XT | Fixed in v0.2.5; upgrade the old installation. |
| BlueWake repeating the first sea-chart island | Fixed in v0.8.0; upgrade the old installation. |
| HD Recomp Pixel 10 Pro graphics missing | Update HD Recomp; if it continues, keep the failing log for a report. |
Crashes During Play
Slow game or low frame rate
For HD Recomp on Deck, start at 30 FPS using the device frame-rate choices. If BlueWake slows down at Outset, include the scene, settings and session log in the BlueWake Deck thread.
Audio Problems
Use v0.6.0 or newer if BlueWake’s Windows intro music or scripted-scene music is missing. Update the old installation, keeping the save folder.
Controller and Menu Problems
HD Recomp menu scrolling or menu button
If the F1 menu keeps scrolling, open Input → Controls and check which buttons or sticks show as pressed or moving. If scrolling continues, keep the failing run’s log and use the report checklist. For Deck’s menu shortcut, follow the Deck controls.
BlueWake GameCube controllers
For a MayFlash adapter, which connects a GameCube controller to the computer, use v0.7.0 or newer and press a button on your intended controller at the title screen. That keeps an empty adapter port out of player selection. For the 8BitDo GameCube mod kit, update to v0.6.0 or newer for the player-one fix. For a different mapping, use BlueWake controls.
Update or Game Files Not Working
- 1Check the base game against Game Files.
- 2Use HD USA/Europe version 0; an update placed over the base folder changes the executable used for preparation.
- 3Reopen setup to change the input, or use Updates to replace the port program while keeping progress.
How to Get Help
Use HD Recomp Issues or BlueWake Issues, keeping the log from the failing run.
- Project version and original game edition/version.
- Operating system, CPU/GPU, renderer and graphics driver.
- The failing area, steps and changed settings.
- Setup or crash/session log from that run.
Project version and original game edition/version: Operating system, CPU/GPU, renderer and graphics driver: The failing area, steps and changed settings: Setup or crash/session log from that run:
| Project / installation | Log location |
|---|---|
| HD Recomp portable desktop | data/data/; |
| HD Recomp Linux AppImage | captures/ under its game-data root |
| BlueWake Windows | %APPDATA%\ |
| BlueWake Linux | ~/ |
Review personal paths before sharing logs; keep game files and keys out of the report.
Sources
Checked November 4, 2026.
- Wind Waker HD Recomp project github.com
- Wind Waker HD Recomp v0.5.0 release github.com
- Project feedback github.com
- HD Recomp startup and data locations github.com
- BlueWake desktop help github.com
Zelda PC Guide