Repository navigation
EoWRecomp v0.2.0 — Linux x86-64
Pre-release
Pre-release
- Linux x86-64 (Vulkan) only: Windows, macOS, and Android builds are not tested or packaged in this fork.
EoWRecomp — Linux x86-64 Build (WIP)
Static recompilation of The Legend of Zelda: Echoes of Wisdom (Nintendo Switch, v1.0.0) running natively on Linux (Vulkan), built from requiemjota88/EoWRecomp (beta 1) with backported improvements from tcsenpai/EoWRecomp and LASRecomp, plus Linux-specific fixes.
No game files are included. You must supply your own legally dumped
.nsp/.xci(v1.0.0, title01008CF01BAAC000) and your console'sprod.keys. The AppImage compileseowgame.solocally on your machine from your own files.
What's New / Fixed in This Fork
- GPU-side indirect draws (
vkCmdDrawIndirect/vkCmdDrawIndexedIndirect) and live GPU-written constant buffers — eliminates mid-frame CPU stalls (doubling FPS in open areas like Hyrule Castle Town). - Smart shader compilation mode + pre-warming on
nvnProgramSetShaders— avoids black screen flashes on fullscreen/lighting passes while minimizing area-transition hitches (configurable inF1→ Display → Shader compilation:Smart/Sync/Async). - VSync toggle & FPS limit selector (
30/60/120/Unlimited) in theF1menu. - Linux hang watchdog with automatic
kernel_unstick+WAITERS_BITfix inmutex_acquire_or_mark. - XCI (HFS0) support in
tools/nca_extract.pyand updated Linux AppImage packaging.
Tested Progress (Linux / Vulkan)
- Intro, Hyrule Castle Town, Suthorn Village, Still World (Rifts), 2D sections, and all of the first dungeon playable end-to-end with audio and working save/load.
Known Issues
- Keep
FPS limit = 60(or120): running at144+fps currently inverts the analog stick on the map screen. - First visits to new areas may still have brief shader compilation hitches in
Smartmode until cached to disk. - Intermittent kernel condvar freezes (mitigated): the root cause of the Horizon condvar lost wake-up is still under investigation; for now, the Linux hang watchdog automatically unsticks it (~500 ms) so gameplay continues smoothly.
How to Run (AppImage)
chmod +x EoWRecomp-*-linux-x86_64.AppImage
./EoWRecomp-*-linux-x86_64.AppImageRequirements: glibc 2.35+ (Ubuntu 22.04+ / Arch / Fedora / etc.), a Vulkan 1.3 driver, and an AVX2-capable x86-64 CPU. On first launch, select the folder containing your .nsp/.xci and prod.keys.