Skip to content

About

A mod for Savage Wind Recomp that adds Cemu's Clarity look to Breath of the Wild, with all 20 presets. Made with AI (Claude).

Topics

Resources

Stars

16 stars

Watchers

0 watching

Forks

Repository files navigation

Clear Skies

Clear Skies is a mod for Savage Wind Recomp, the native PC version of The Legend of Zelda: Breath of the Wild. It brings over Clarity, the much-loved look from Cemu's Breath of the Wild graphic pack, with all 20 of its presets. You get less haze, less blown-out bloom and richer colour, without changing a single file of Savage Wind.

⬇ Download Clear Skies · All releases · Install it · The presets · Help test it

Caution

No game files are included, and none ever will be: not in the code, the releases, the issues or the wiki. Clear Skies doesn't include Savage Wind either. You need your own working copy of Savage Wind, set up with your own game files, dumped from your own Switch. Please don't post game files, dumps, keys or an installed copy here.

Important

Made with AI. Every line of code in Clear Skies, every test, the icon, the banner and this page were written or made by Claude, Anthropic's AI, through Claude Code. A human, devall96, came up with the idea, directs it and plays every build, but no human reviews the code line by line. Who did what has the details. If you don't want to run code written that way, don't run this. As with anything on the internet, you run it at your own risk.

Warning

Early, and tested on one PC. Clear Skies has run in the game on one Windows PC with an AMD Radeon RX 9070 XT, using Serfrost's preset with HDR off. Every preset is tested automatically on that GPU. The Linux AppImage has been tested on Ubuntu 26.04 LTS and works fine in short testing. NVIDIA, Intel, HDR output, other Linux distributions and the Steam Deck haven't been tried yet. Clear Skies doesn't touch your saves, but it's still worth keeping a copy of any you care about.

Note

Not official. Clear Skies is a fan-made mod. It isn't made by, affiliated with or endorsed by the Savage Wind Recomp team, the Cemu team or Nintendo. Please don't report Clear Skies problems to Savage Wind or Cemu: open an issue here instead.

Why this exists

This Clarity port started in a personal, experimental build of Savage Wind, as a proof of concept. Clarity can't be added to Savage Wind itself, and that's fine: Savage Wind doesn't need to be everything to everyone. Clear Skies is for the people who loved Cemu's Clarity and want it back.

So instead of a fork, it's a separate, add-on mod. It works with Savage Wind as it is and keeps up with its updates, it can be turned off by starting the game normally, and it brings every one of Cemu's presets along, not just the three the proof of concept had.

Screenshots

A golden evening in Hyrule Field Morning in Hyrule Field
The Great Plateau The road to Hyrule Castle
Kakariko Village Hateno Village
Rito Village Gerudo Desert

These were taken with Serfrost's preset in a personal, experimental build of Savage Wind, the proof of concept this Clarity port started in. If you take good before-and-after shots with Clear Skies, share them in an issue.

The Clear Skies launcher: choose a look, point it at savagewind.exe, press Play

What it adds

The look

  • Cemu's Clarity for Breath of the Wild in place of the game's own tone mapping: Clarity GFX by Jamie and Kiri with Crementif
  • All 20 presets from Cemu's graphic pack, from Serfrost's recommended preset to Filmic, Survival of the Wild and Hexaae's Clear
  • All 65 of Clarity's settings, with the same names as in Cemu's pack, adjustable on top of any preset: bloom, fake HDR, sharpening, ten tone maps, levels, Technicolor, colour matrix, filmic pass, DPX, curves, lift / gamma / gain and vibrance

The launcher

  • A small themed window: choose a look, point it at savagewind.exe, press Play
  • Remembers your choice, warns you if Savage Wind isn't set up yet, and has command-line options for shortcuts

How it stays out of the way

  • Nothing in Savage Wind's folder is changed. Clear Skies runs as a Vulkan layer, switched on only for the game it starts. Start savagewind.exe directly and you get the original look.
  • Nothing is installed system-wide. Delete the folder and it's gone.
  • Your saves aren't touched. The layer only replaces one shader on its way to your graphics card.
  • Works with Savage Wind's updates, as long as the game keeps building that shader the same way (the log tells you if it doesn't)

How to install

  1. Have a working Savage Wind first: set up with your game files, and started at least once. For the smoothest first run, also use Precompile shaders in Savage Wind Configuration.
  2. Download the newest Clear Skies and unzip the ClearSkies folder anywhere. Its files must stay together.
  3. Run ClearSkies.exe, choose a look, click Browse to find your savagewind.exe, and press Play.

From then on, start the game with ClearSkies.exe whenever you want Clarity. To change the look, pick another preset and press Play again: the game needs a restart to switch.

Shortcuts and command line

ClearSkies.exe --play Start straight away with the saved preset
ClearSkies.exe --preset filmic --play Choose a preset (it's saved) and start
ClearSkies.exe --game "D:\Savage Wind\savagewind.exe" Choose the game
ClearSkies.exe -- --config Anything after -- goes to Savage Wind

Uninstalling: delete the ClearSkies folder. Nothing else was changed.

On Linux and Steam Deck

Savage Wind runs natively on Linux as an AppImage, and so does Clear Skies: one file, ClearSkies-<version>-x86_64.AppImage, with the same window as on Windows. It works the same way too: the layer is switched on only for the game it starts, and nothing is installed system-wide.

  1. Have a working Savage Wind AppImage first (Savage_Wind-…-x86_64.AppImage), set up with your game files and started at least once.
  2. Download the newest Clear Skies for Linux (ClearSkies-<version>-x86_64.AppImage) and put it anywhere.
  3. Allow it to run: right-click it, open Properties, and tick Allow executing file as program (or run chmod +x ClearSkies-*-x86_64.AppImage). Then open it.
  4. Choose a look, click Browse to find your Savage Wind AppImage (or drag it onto the window), and press Play. If the Savage Wind AppImage isn't allowed to run yet, Clear Skies offers to allow it.

From then on, open Clear Skies whenever you want Clarity. Your choices are saved in ~/.config/ClearSkies/clearskies.ini (an AppImage can't change itself), and the layer's log, clearskies.log, is written next to it. Edit settings opens that file.

Command line

./ClearSkies-*.AppImage --play Start straight away with the saved preset and game
./ClearSkies-*.AppImage --preset filmic --play Choose a preset (it's saved) and start
./ClearSkies-*.AppImage --game ~/Games/Savage_Wind-…-x86_64.AppImage --no-play Only save the choice
./ClearSkies-*.AppImage --list List the presets
./ClearSkies-*.AppImage --play -- --config Anything after -- goes to Savage Wind

Steam and Steam Deck: add the Savage Wind AppImage to Steam as a non-Steam game (native, without Proton), then set its launch options to:

/home/deck/Applications/ClearSkies-0.2.1-x86_64.AppImage %command%

Use the path where you keep Clear Skies. The game then starts with your saved preset. To change it, open Clear Skies in Desktop Mode, pick another look and close the window (or run it with --preset <name> --no-play).

The layer uses the shaderc library that the Savage Wind AppImage ships, so nothing else needs to be installed. If that copy can't be found, it falls back to the system's shaderc (libshaderc1 on Debian and Ubuntu, libshaderc on Fedora, shaderc on Arch), and clearskies.log says which copy it used. The Troubleshooting table below applies on Linux too.

The presets

preset = From Cemu's pack
serfrost Serfrost's Preset (Recommended), the default
serfrost_dim Serfrost's Preset (Dim Display)
serfrost_bright Serfrost's Preset (Bright Display)
bruz Bruz's Preset
cellhunter CellHunter's Preset
jamie Jamie's Preset
t3nka t3nka Neutral+
complaining_gamer The Complaining Gamer's Preset
viskclarity ViskClarity Preset
contrasty Contrasty Preset
filmic Filmic Preset
sotw_warmer Silentverge's Survival of the Wild Preset (Warmer)
sotw_colder Silentverge's Survival of the Wild Preset (Colder)
godot_mexican Godot's Mexican Preset
hexaae_clear Hexaae's Clear Preset
maranbr MaranBr Preset (Little More Intense)
yemaowuxin_bright YeMaoWuXin's Preset (Bright colors)
yemaowuxin_vivid YeMaoWuXin's Preset (Vivid and clear)
cobalt Cobalt's Preset (Saturated & Bright)
custom User-Defined Preset: Cemu's starting values, for building your own
off The game's own look

Making your own

clearskies.ini (the launcher's Edit settings button) lists every one of Clarity's settings, using the names from Cemu's pack. Remove the ; in front of a setting to change it on top of the chosen preset:

[clarity]
preset = serfrost
bloomFactor = 0.2
VibranceRGBBalance = 1.0, 1.0, 1.4
Tone_map = 9

Switches are 1 (on) or 0 (off), and colours are three numbers. Tone_map picks the tone map: -1 none, 0 BotW, 1 ReShade, 2 linear, 3 Reinhard, 4 luma Reinhard, 5 white-preserving Reinhard, 6 RomBinDaHouse, 7 filmic, 8 Uncharted 2, 9 ACES. Changes apply the next time the game starts. If a value can't be used, the log says so and that one setting keeps the preset's value.

How it works

Breath of the Wild finishes every frame with one shader. It adds the bloom to the HDR image and tone-maps the result for your screen. On the Wii U, Cemu's Clarity pack replaces that shader. Clear Skies replaces the same shader in Savage Wind:

  1. ClearSkies.exe starts savagewind.exe with the Vulkan loader told to load the Clear Skies layer, for that one process only.
  2. clearskies_layer.dll sits between the game and the graphics driver and looks at every shader the game creates. It recognises the tone-mapping shader by what's inside it: its two textures, and the constants BotW's tone map uses (the 10000 clamp, the 0.2989 luma weight and −log₂ e).
  3. When it finds it, the layer builds Clarity with your preset's settings, using the shader compiler that ships with Savage Wind, and hands that to the driver instead. Every other shader passes through untouched.

The Clarity code itself comes from Cemu's pack: tools/gen_presets.py reads the presets and the shader's functions straight out of Cemu's files (kept unchanged in third_party/cemu), so nothing is retyped by hand. The only changes are what Savage Wind needs: the shader's inputs, the pixel size, and clamps that match the game's own shader (LICENSES.txt lists them).

Troubleshooting

Every run writes clearskies.log next to clearskies.ini. A working run looks like this:

Clear Skies loaded into C:\...\savagewind.exe
preset: serfrost (Cemu's "Serfrost's Preset (Recommended)")
watching shaders on a new Vulkan device
Clarity compiled (32140 bytes of SPIR-V)
Clarity replaces the tone-mapping composite (shader 1)
What you see What it means
Savage Wind opens its setup screen That copy of Savage Wind isn't set up yet. Finish its setup, then use Clear Skies.
No log, or no loaded into line The layer didn't load. Start the game from ClearSkies.exe and keep all of Clear Skies' files together.
failed to compile A value in clearskies.ini can't be used. The message says which. Remove that line.
Loaded, but never replaces the tone-mapping composite Your Savage Wind builds that shader differently. Please report it with the log.
Stutters the first time you see places That's Savage Wind compiling shaders. Run Precompile shaders in Savage Wind Configuration.

Help test it

So far Clear Skies has been tested on one Windows PC and briefly on Ubuntu 26.04 LTS, so reports from other hardware are the most useful thing you can send. That goes for NVIDIA and Intel cards, older AMD cards, HDR monitors, laptops, other Linux distributions and the Steam Deck. Good news helps too: "it works on this card" tells me what works.

To report, open an issue with:

  • Your graphics card and driver version
  • Which preset, and whether HDR is on in Savage Wind
  • clearskies.log from the Clear Skies folder, and savagewind.log from Savage Wind's folder
  • A screenshot if something looks wrong

Never attach game files, dumps, keys or saves.

Build it yourself

On Windows you need Zig (a complete C compiler in one download) and Python 3:

git clone https://github.com/devall96/ClearSkies
powershell -ExecutionPolicy Bypass -File build.ps1 -Zig C:\path\to\zig.exe

This writes the mod to dist\ClearSkies. To test the layer on your own GPU against every preset, point the test at a Savage Wind folder (it uses that folder's libshaderc_shared.dll):

powershell -ExecutionPolicy Bypass -File tests\run_tests.ps1 -SavageWind "C:\Games\Savage Wind"

The Linux AppImage is built on Ubuntu 22.04 (glibc 2.35, like Savage Wind's), as GitHub's check does: install the packages listed in the appimage job of .github/workflows/linux.yml, then run the build. It downloads SDL 3.4.16, appimagetool and the AppImage runtime (each checked against its SHA-256) and writes dist/ClearSkies-<version>-x86_64.AppImage. The second command tests it the way players use it, with a fake game standing in for Savage Wind:

bash tools/appimage.sh
sh tests/appimage_test.sh dist/ClearSkies-*-x86_64.AppImage

Just the Linux layer, without the window, needs only a C compiler (gcc or clang) and, optionally, Python 3 to regenerate the presets. This writes it to dist/ClearSkies-linux, with clearskies.sh, a launcher script for the command line:

./build.sh

To cross-compile from another OS (macOS, for example) with Zig, targeting the same glibc as Savage Wind's AppImage:

CC="zig cc -target x86_64-linux-gnu.2.35" ./build.sh

The Linux test runs the layer against every preset. It needs a Vulkan driver (Mesa's software driver, lavapipe, is enough) and shaderc: either the system's, or the AppImage's after ./Savage_Wind-*.AppImage --appimage-extract:

tests/run_tests.sh squashfs-root/usr/lib
src/clearskies_layer.c The Vulkan layer: finds the tone-mapping shader and swaps in Clarity
src/clarity_shader.h Clarity's inputs and main() for Savage Wind
src/cemu_presets.h Generated: every preset and Clarity's functions, from Cemu's files
src/launcher.c ClearSkies.exe
src/launcher_sdl.c The Linux launcher window (in the AppImage), drawn with SDL3 like ClearSkies.exe
tools/appimage.sh, tools/linux/ Build the Linux AppImage
tests/appimage_test.sh Tests the AppImage: command line, window, every preset, and Play with a fake game
src/clearskies.sh A launcher script for the command line, with build.sh
build.sh, tests/run_tests.sh The Linux layer's build and test
tools/gen_presets.py Generates cemu_presets.h and clearskies.ini from third_party/cemu
tools/make_icon.py, tools/make_banner.ps1 Draw the icon and this page's banner
tests/ The layer test, run on a real GPU

Who did what

devall96, the human: the idea, the name, what it should and shouldn't do, testing in the game, and deciding what stays.

Claude (Anthropic's AI, Claude Opus 5.5 through Claude Code): all of the code, the tests, the preset generator, the icon and banner (drawn by scripts), the license research and this page. That includes porting Cemu's Clarity shader to Savage Wind and working out how to recognise the game's tone-mapping shader. No human has reviewed the code line by line.

Danny Rashid: Linux and Steam Deck support: the Linux build of the layer, clearskies.sh, build.sh and the Linux test (also written with Claude). The Linux window and the AppImage came after, from Claude.

Cemu's graphic pack authors: Clarity itself and every preset. Savage Wind and its contributors: everything Clear Skies builds on.

Credits

  • Clarity from the Cemu graphic packs (CC0 1.0): Clarity GFX by Jamie (main code) and Kiri (code and ReShade logic), with Crementif. Presets by Serfrost, Bruz, CellHunter, Jamie, t3nka, The Complaining Gamer, Visk, Silentverge, Godot, Hexaae, MaranBr, YeMaoWuXin and Cobalt. Contrasty, Filmic and the User-Defined starting values come with the pack without a named creator. Several passes are ports of ReShade effects, as they appear in the pack.
  • Savage Wind Recomp by Revivedx and contributors, built on LAS Recomp by Peiikai (MIT). Not included: Clear Skies works with your own copy.
  • Fira Sans by the Mozilla Foundation and Telefónica (SIL Open Font License 1.1, third_party/fonts/FiraSans): the banner's lettering, and the Linux window's text.
  • The Linux window uses SDL3 (zlib license) and stb_truetype by Sean Barrett (public domain or MIT, third_party/stb).
  • The few Vulkan declarations the layer needs follow the Khronos Vulkan-Headers (Apache-2.0 or MIT). Vulkan is a registered trademark of the Khronos Group Inc.
  • The Legend of Zelda: Breath of the Wild is © Nintendo. Nintendo Switch and The Legend of Zelda are trademarks of Nintendo. This project is not affiliated with or endorsed by Nintendo.

License

Clear Skies' own code is under the MIT License. Material from others keeps its own license: Cemu's Clarity pack is CC0 1.0, Fira Sans is OFL 1.1, SDL3 is zlib and stb_truetype is public domain or MIT. LICENSES.txt has the full list, including exactly what was adapted.


Support me on Ko-fi

About

A mod for Savage Wind Recomp that adds Cemu's Clarity look to Breath of the Wild, with all 20 presets. Made with AI (Claude).

Topics

Resources

Stars

16 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages