README

Savage Wind Recomp

 [!IMPORTANT]
 This project is made almost entirely with AI. Nearly all of the code, tooling, reverse engineering and
 documentation here is written by an AI (Anthropic's Claude, through Claude Code), directed, tested and reviewed by
 a human. It builds on LAS Recomp, which was made the same way. If you don't
 trust code written by AI, you can simply ignore this project. As with anything on the internet, you run the code at
 your own discretion.

Savage Wind Recomp is a work-in-progress static recompilation of The Legend of Zelda: Breath of the Wild
(Nintendo Switch, version 1.9.0) into a native application for Windows and Linux. The goal is a full PC
version of your own copy of the game: a launcher, PC-style graphics options, mods, any controller, keyboard and
mouse, and its text and voices in any of its languages.

 [!WARNING]
 The whole game can be finished from start to end. Savage Wind plays the game at 60 fps with sound, voices,
 the HUD, saving and loading. Players have finished the base game from the start, through Calamity Ganon to Dark Beast
 Ganon (419, 436), and the four Divine Beasts have been completed:
 Vah Ruta (335), Vah Naboris
 (380) and, by a player's report, all four and the DLC
 (391). Expect bugs, white screens or crashes in some
 places, and some mechanics that break above 30 fps (425).
 Bugs in cutscenes are a known issue: if a cutscene freezes or breaks, lower the frame rate to 30 fps
 (Options  Video  Frame rate) for that scene to get past it, and open an issue
 with your save so we can fix it.
 This is an alpha, a preview for testers. If you
 find a bug, please report it on GitHub: every
 report shows how far the game really works.

 [!TIP]
 Want to contribute? Look at the test branch first.
 It has every change that is implemented and being tested, ahead of the latest release, so you don't start on
 something that's already done or in progress. Base your work on test and open pull requests against it: main
 only moves for a release. See CONTRIBUTING.md.

 [!NOTE]
 No game files are included. Savage Wind Recomp needs your own legally obtained copy of the game, updated to
 version 1.9.0, dumped from your own Nintendo Switch. This project does not include, and will not
 provide, game files, keys, firmware, dumping or decryption tools, or instructions on how to obtain any of them.
 Savage Wind never decrypts anything: it only reads files you have already extracted yourself. The recompilation of
 the game code happens locally, on your machine, from your files.

 Before you report a bug

- Use the latest release and game version
  1.9.0: 1.8.2 isn't supported, and many bugs of older releases are already fixed.
- Search the existing issues first.
- Attach savagewind.log. On Windows it's next to savagewind.exe, in the Savage Wind folder; on Linux, in
  ~/.local/share/savagewind/. The game writes a new one each time it starts, so take it right after the bug.
- Crash or cutscene bug? Attach your save too. Cl

Top issues