Savage Wind Recomp is a work-in-progress static recompilation of The Legend of Zelda: Breath of the Wild (Nintendo Switch, version 1.8.2) 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.

1. Download SavageWind-0.2.0-alpha.2-windows.zip from Releases and extract it to a folder you can write to (not Program Files): your game files, saves and settings are kept in that folder.
2. Run savagewind.exe. The first time it asks for your game files: pick the folder with your own extracted game (exefs/ and romfs/, version 1.8.2, see below) and choose Set up game files. It checks the version, copies the files, builds the data image and recompiles the game code on your machine - once, and it takes a while (about 40 minutes with a 12-thread CPU). Your own files aren't changed. When it's done the game starts.
3. From then on savagewind.exe goes straight into the game. The settings, including the text and voice languages, are in the game's Options (pause menu > System > Options, or Options on the title screen).
4. Savage Wind Configuration (Savage Wind Configuration.exe, in the same folder) opens the configuration screen: Play, Settings, your game files (set them up again, rebuild the game code, delete them) and Quit. In game, Quit to Start Screen also comes back to it. (Built from source on Linux or macOS: --config, the AppImage's Savage Wind Configuration desktop action, or Option held while opening the Mac app.)

The setup and configuration screens show Savage Wind's own art. To see a picture of your own there instead, put it next to savagewind.exe as splash.jpg or splash.png; it's only read from your folder and never part of Savage Wind.

Needs Windows 10 or later, a CPU with AVX2, a GPU with Vulkan 1.3 and about 35 GB of free disk space.

• Your own Breath of the Wild (cartridge or digital) and its 1.8.2 update, extracted from your own console:
  • the ExeFS of 1.8.2 (main, main.npdm, rtld, sdk, subsdk0)
  • the RomFS with the update applied (base game and 1.8.2 merged)
• DLC: not supported yet (planned, see the roadmap).
• Windows 10 or later (x86-64, a CPU with AVX2) or Linux (x86-64), and a GPU with Vulkan 1.3.

The files go in extracted/ next to the program (git ignores this folder):

extracted/
  exefs/   main, main.npdm, rtld, sdk, subsdk0
  romfs/   the complete RomFS (base game + 1.8.2 merged)

The main module's build id tells the exact version; python tools/sw_probe.py (it reads extracted/exefs) prints it and what the recompiler will find there.

Estimates of where each part stands. "Tested in game" is how much of the game has been played through on Savage Wind so far.

	Part	Progress	What it means
✅	Recompiler		The whole game (main, sdk and multimedia modules) recompiles to native code
✅	Game files setup		Version check, copy, data image and code build, all from your own files
✅	Latest game version		Version 1.8.2, the latest
✅	Text and voice languages		Any of the game's 15 text languages with any of its 8 voice languages
✅	Menus in 11 languages		Savage Wind's own screens follow the text language
✅	Sound and voices		Mixed by the game SDK's own audio renderer, with room reverb
✅	Keyboard and mouse		Every key and mouse button remappable, mouse camera
✅	Settings in the game's Options		Video, audio, controls and language pages drawn by the game itself
✅	Direct start + Configuration		savagewind.exe goes straight into the game; Savage Wind Configuration has the rest
✅	Window sizes and fullscreen		The sizes your display can show; windowed, borderless or exclusive
✅	Internal resolution and FSR 1		Native resolution up to 4K, or AMD FSR 1 quality modes
✅	Shader and pipeline cache		Places you've already seen don't stutter again
✅	Frame rate		60 fps by default, or 30, 90, 120 or no limit, with the game at the same speed; menus, cutscenes and conversations at 30, as on the console
🔧	Horizon OS services		Threads, files, controllers, applets and time: all the opening and the Great Plateau use
🔧	Maxwell shader translator		Every shader seen so far translates to Vulkan
🔧	Graphics (NVN on Vulkan)		Shrine and Great Plateau look right, shadows included; two save-screen glitches and a black pause menu background after an in-game restart left
🔧	Controllers		Any controller SDL knows, by button position; automatic recognition is next
🔧	Steady 60 fps in the open world		60 fps in a scripted walk at 2560x1440 (RTX 3060, Ryzen 5 5600X); real play still drops to 45-50 fps in places, and the first time an effect appears it stutters while its pipeline is made
🔧	Tested in game		The Shrine of Resurrection and the Great Plateau; the rest of Hyrule is untested: report what breaks
🗺️	Linux		Builds and runs on x86-64 (from LAS Recomp); not yet tested with this game
🗺️	AMD FSR 3 + frame generation		Planned: motion vectors from depth and the camera, FidelityFX SDK
🗺️	NVIDIA DLSS (RTX)		Planned, after FSR 3; under NVIDIA's own SDK license
🗺️	Variable refresh rate (VRR)		Planned: on G-SYNC and FreeSync displays every frame shows as soon as it's ready, without tearing or vsync stutter
🗺️	Faster game code build		Planned: the one-time setup build in about 20 minutes instead of about 40 (12 threads)
🗺️	Full shader precompilation		Optional, at setup or in Configuration: no first-time stutter anywhere
🗺️	Mods		Planned
🗺️	Accessibility options		Planned: text size, colour-blind filters and toggles in place of held buttons; enemy and Link health, damage dealt and damage taken
🗺️	Button icons for your device		Planned: the game's button prompts show your keyboard and mouse keys, or the buttons of the controller you're using
🗺️	DLC		Later
🗺️	amiibo rewards without figures		Planned

✅ done · 🔧 in progress · 🗺️ roadmap

Any controller SDL knows works, by button position. Keyboard and mouse defaults:

Every key and mouse button can be remapped in the game's Options (the Keyboard pages), next to the mouse sensitivity and Y inversion (Controls). Esc frees the cursor, a click in the window takes it back. F10 cycles the performance overlay (off, FPS, full).

More detail in docs/BUILD-windows.md.

1. One-time setup, in PowerShell from the repository root: powershell -ExecutionPolicy Bypass -File tools\setup_windows.ps1. It installs MSYS2 (UCRT64: clang, make, SDL3, FFmpeg, Vulkan, shaderc) and Python for the tools, and switches the clone to LF line endings.
2. From an MSYS2 UCRT64 shell (or Git Bash with export PATH="/c/msys64/ucrt64/bin:/c/msys64/usr/bin:$PATH"):
   • make -j builds the app, build/savagewind.exe.
   • Put your files in extracted/ (above), then make gen (recompiles the game code into generated/, about a minute) and make -j again (builds it into build/swgame.dll; the first build takes 15-20 minutes).
   • build/savagewind.exe extracted --build-romfs packs your RomFS into the image the runtime reads (extracted/romfs.bin, about 15 GB).
3. Run: build/savagewind.exe extracted --play, from a shell with C:\msys64\ucrt64\bin on PATH.

See docs/linux.md: the same steps with the distribution's clang, SDL 3, FFmpeg, shaderc and Vulkan Memory Allocator (build/savagewind, build/swgame.so).

Developer notes (in Spanish) - what was changed from LAS Recomp, how the boot got this far, and the debugging switches - are in docs/SAVAGE-WIND.md.

• The Legend of Zelda: Breath of the Wild is © Nintendo. This is a fan project. It is not affiliated with, endorsed by or sponsored by Nintendo. Nintendo Switch and The Legend of Zelda are trademarks of Nintendo.
• This repository contains no game files, no game code (also not the C code the recompiler generates from it), no assets, no fonts, no keys - and release builds won't either.
• The game code you generate and the build made from it contain Nintendo's code. They are for your own use only: don't share them, upload them or ship them.
• Issues, pull requests or discussions that contain game files, keys, generated code or links to pirated copies will be removed. Piracy is not supported in any way.
• Follow the copyright laws of your country. Dumping a game you own for personal use is legal in some countries and not in others; that is your responsibility.

• LAS Recomp by peiikai - the recompiler, the runtime and most of what this project is built on (MIT).
• Ryujinx (MIT) - its shader decoder was the reference for instruction field layouts.
• envytools - NVIDIA GPU documentation used for the shader translator.
• The Switch homebrew community's documentation (Switchbrew).
• Ghidra and the Switch Loader - used for reverse engineering (not bundled).
• Libraries: SDL 3 (zlib), FFmpeg (LGPL), Dear ImGui (MIT), Vulkan Memory Allocator (MIT), SMAA (MIT), AMD FidelityFX Super Resolution 1 (MIT), Fira Sans (SIL OFL 1.1), stb_image (public domain / MIT), shaderc (Apache 2.0), Zig (MIT), Capstone (BSD), Unicorn (GPL 2.0), python-lz4 (BSD).

Savage Wind Recomp's own code is open source under the MIT License, as is LAS Recomp's, on which it builds. Third-party components in third_party/ keep their own licenses. The license covers this project's code only: it grants nothing for Nintendo's game, which you must supply yourself.

The Windows release zip also bundles, unchanged unless noted, under their own licenses:

• FFmpeg 9.0.2 (libavcodec, libavformat, libavutil, libswscale), LGPL 2.1 or later: built from the official source as LGPL only, without GPL or nonfree parts, by tools/build_deps_windows.sh. They are separate DLLs: you can replace them with your own build of the same version.
• From MSYS2 (UCRT64, sources there): SDL 3.4.18 (zlib), shaderc 2026.4 (Apache 2.0), libiconv 1.19 (LGPL 2.1 or later), the GCC 16.2 runtime (libgcc, libstdc++: GPL 3 with the GCC Runtime Library Exception) and winpthreads (MIT and BSD).
• Zig 0.17.0 (MIT; its bundled LLVM, Clang and LLD: Apache 2.0 with LLVM Exceptions; the MinGW-w64 headers and runtime: their own permissive licenses), trimmed to what the game code build uses.
• swgen/, this project's generator frozen with PyInstaller 6.22 (GPL 2.0 with the bootloader exception): Python 3.14 (PSF License), Capstone 5.0.9 (BSD), Unicorn 2.1.4 (GPL 2.0, source at that link) and python-lz4 4.4.5 (BSD).
• The Fira Sans font, Medium and SemiBold (SIL OFL 1.1, FiraSans-OFL.txt).