EoWRecomp

A static recompilation of The Legend of Zelda: Echoes of Wisdom (Nintendo Switch, 2024)
native code for macOS (Apple Silicon), Linux, Windows and Android - not an emulator

The game's ARM64 machine code is translated to C ahead of time and compiled for the machine it runs on; a runtime replaces the Switch's operating system (Horizon) and its graphics API (NVN), drawing with Vulkan. Built on LAS Recomp, the same kind of project for Link's Awakening (also by Grezzo), and on its Android port LASRecomp-Android-Plus.

Frames of the recompiled game itself, captured by the runtime (native Linux build, Vulkan, 1280x720).

_{The Android app (alpha 1): setting the game up from your own files.}

Latest release - alpha 1, a preview: the start screen and the game setup, not the game yet (see the warning above).

Neither contains anything from the game: you choose the folder with your own .nsp / .xci and prod.keys, and the game code is recompiled on your device. Checksums: SHA256SUMS.txt in the release.

• Set up from your own package: choose the folder with your .nsp / .xci and prod.keys. Only the game's code (~40 MB) is written out; the 7.5 GB of game data is read straight from your package, decrypted and decompressed on the fly (runtime/nxpkg.c) - no second copy of the game on your disk or phone.
• Built on your machine: the start screen recompiles the game code locally (generator + bundled zig compiler); nothing derived from the game is ever distributed.
• One renderer everywhere: NVN reimplemented on Vulkan - natively on Linux / Windows / Android, through MoltenVK on Apple Silicon. The game's Maxwell GPU shaders are translated to GLSL at run time (and tested against Metal's compiler for MoltenVK).
• Android: touch controls with every Switch button, controllers, a pre-rotated swapchain (no compositor rotation pass), Android performance hints, and the game code built on the phone itself (Python + clang inside the APK).
• Upscaling (AMD FSR 1), SMAA, unlocked aspect ratio, control remapping, in-game settings menu (F1 / Esc).

• macOS (Apple Silicon): docs/BUILD-macos.md - tools/macos/dev_deps.sh, make gen, make; make app makes the shippable EoWRecomp.app.
• Android: docs/BUILD-android.md - the APK (with or without the on-phone builder) and a personal APK with the game code built on your computer.
• Linux: tools/linux/dev_deps.sh, then make gen and PATH=$PWD/build/bin:$PATH make -j$(nproc) DEPS=$PWD/build/deps-linux GENARCH=-mcpu=x86_64_v3.
• Windows: tools/windows/fetch_deps.sh and tools/windows/build.sh all (cross-compiled from Linux).

Your game files, everywhere: tools/venv/bin/python -I tools/nca_extract.py <prod.keys> <game.nsp | program.nca> extracted --no-romfs --romfs-image - or let the start screen do it.

• Recompiler (tools/, Python): reads the ExeFS modules (main, sdk, subsdk0 - the GLSL compiler, subsdk1 - multimedia), finds every function (.eh_frame, symbols, relocations, call targets), resolves jump tables by running the code in Unicorn, and emits C for each function. Integer and memory instructions become C; FP/SIMD becomes inline assembly on ARM64 hosts or portable C elsewhere. ARMv8.1 atomics and 128-bit exclusive pairs used by the SDK 16.2 are supported.
• Runtime (runtime/, C): a small Horizon kernel (threads, mutexes and condition variables with Horizon semantics, memory, events), IPC with the system services the game uses (file system, input, audio renderer, applet manager, time, settings...), and NVN on top of Vulkan.
• Packages (runtime/nxpkg.c, tools/nca_extract.py): NSP / XCI / NCA with the player's keys, including the compressed RomFS this game uses (which hactool can't read).

docs/ARCHITECTURE.md explains the pipeline and what was reused, adapted or written new.

• LAS Recomp by Peiikai and its contributors - the base of this project (MIT). The recompiler, the Horizon runtime, the NVN implementation, the Maxwell shader translator and the Vulkan renderer all started there.
• LASRecomp-Android-Plus (MIT) - the Android platform layer, the on-phone game code build, touch / pre-rotation / performance-hint techniques.
• SDL 3 (zlib), FFmpeg (LGPL 2.1+, linked dynamically, LGPL-only build), Dear ImGui (MIT), MoltenVK and the Vulkan loader (Apache 2.0), volk (MIT), Vulkan Memory Allocator (MIT), shaderc (Apache 2.0), SMAA (MIT), AMD FidelityFX Super Resolution 1 (MIT), Baloo 2 (SIL OFL 1.1) and DejaVu Sans (Bitstream Vera license) fonts
• Build-time and on-phone tools: Capstone (BSD), Unicorn (GPL 2.0; Python bindings BSD), python-lz4 (BSD), cryptography (Apache 2.0 / BSD), CPython (PSF), Zig as C compiler (MIT; LLVM: Apache 2.0 with LLVM exceptions), Android NDK pieces (Apache 2.0)
• Documentation: Switchbrew, envytools, Atmosphère's kernel and file system sources, and the instruction decoders of Ryujinx and yuzu as references for Maxwell and Horizon behaviour.

This project is developed almost entirely with AI (Anthropic's Claude, through Claude Code), directed and tested by a human - the same way as the projects it is based on.

EoWRecomp is a fan project. It is not affiliated with, endorsed by or sponsored by Nintendo. The Legend of Zelda and Echoes of Wisdom are trademarks of Nintendo. No game files, game code, assets, keys or fonts are included - not in this repository and not in any build. The screenshots above are captures of the running game, shown for documentation. You must provide your own legally obtained copy of the game.

EoWRecomp's own code is MIT licensed (LICENSE, which keeps LAS Recomp's copyright notice). Third-party components keep their own licenses, listed above. The license covers EoWRecomp's code only - it grants nothing for Nintendo's game.