Repository navigation
Releases
EoWRecomp v0.5.0
EoWRecomp v0.5.0
Important
Linux x86-64 (Vulkan) is the actively tested target in this fork. Windows x64 builds are generated automatically via GitHub Actions (untested locally), and macOS / Android builds inherited from upstream are untested.
Warning
No game files or keys are included. You must provide your own legally obtained copy of The Legend of Zelda: Echoes of Wisdom v1.0.0 (Title ID 01008CF01BAAC000, .nsp or .xci) and prod.keys.
What's New in v0.5.0
- Ahead-of-Time Shader Preparation (
shader_prep): ported from LASRecomp and adapted for EoW (direct.xci/.nspRomFS scanning vianx_romfs_openandShaderKey.stencil_tex). Pre-translates and builds 1,173+ known shader variants on the start screen from your own game files (only one-way hashes and NVN state ship in the repo), plus automaticcache/shader_seen.txtcaching for newly encountered variants. - Dynamic Cubemap / IBL Lighting Fix: fixed a bug where ambient lighting and metallic reflections (e.g., Hyrule Castle courtyard / guards' helmets) dropped to pure black when transitioning between static and compute-generated cubemaps.
texture_info()/shader_texture_object()now resolve image-slotTXQlookups (0x120..0x158) viastage_tex_handle(), andstage_set()enforces validrscalevalues for compute shaders. SyncShader Mode by Default: changed defaultsync_shaderstoSHADER_SYNCfor zero visual pop-in in unseen areas whileshader_prephandles known shaders ahead of time (still switchable toSmartorAsyncin theF1menu).- RecompLauncher Integration:
recomplauncher.jsonis included in the release assets for RecompLauncher.
Current Progress (Tested on Linux x86-64 / RADV)
- Most of the overworld explored smoothly without issues alongside story progression through the 2nd dungeon (Gerudo Desert): intro, Hyrule Castle Town, Suthorn Village, Still World (Rifts), 2D sections, 1st dungeon, and Gerudo Desert dungeon with audio, working save/load, and zero freezes.
Known Issues
- Map screen >120 FPS: keep
FPS limitset to60or120in theF1→ Display menu (running at144+FPS currently inverts the analog stick on the map screen). - Untested platforms: Windows x64 (
EoWRecomp-v0.5.0-windows-x86_64.zip) is cross-built via CI and has not been validated on a Windows machine yet.
Quick Start (Linux AppImage)
chmod +x EoWRecomp-v0.5.0-linux-x86_64.AppImage
./EoWRecomp-v0.5.0-linux-x86_64.AppImageOn first launch, select the folder containing your .nsp/.xci and prod.keys. EoWRecomp will extract ExeFS, compile eowgame.so locally, and prepare the shader cache.
Full Changelog: v0.4.0...v0.5.0
EoWRecomp v0.4.0
EoWRecomp v0.4.0
Important
Linux x86-64 (Vulkan) is the actively tested target in this fork. Windows x64 builds are generated automatically via GitHub Actions (untested locally), and macOS / Android builds inherited from upstream are untested.
Warning
No game files or keys are included. You must provide your own legally obtained copy of The Legend of Zelda: Echoes of Wisdom v1.0.0 (Title ID 01008CF01BAAC000, .nsp or .xci) and prod.keys.
What's New in v0.4.0
- ~2× CPU performance in heavy areas (
gw_hit()): added bounding-box fast-reject and completed-sequence caching inruntime/nvn/vulkan/exec.cto avoid per-draw semaphore syscalls (46–50 FPS → 99.8–120 FPS measured in heavy draw areas on AMD RX 7600 / RADV). - Fixed shader/lighting flicker in
Smartmode:vk_prewarm_drain()now matches the activenvn_window_origin()andnvn_depth_mode()instead of hardcoded defaults, andSHADER_SMARTwaits synchronously on critical fullscreen/compute passes. - Root-cause kernel freeze & watchdog fixes: fixed
svc_wait_process_wide_key()lost wake-up andblock_current()TimedWaitvsSignalrace inruntime/kernel.c, and prevented duplicate Linux crash-handler/watchdog initialization inruntime/platform/linux.c(0unstickin 272 s+ test runs). - RecompLauncher support: added
recomplauncher.jsonto the release assets for automated discovery and launching in RecompLauncher.
Current Progress (Tested on Linux x86-64 / RADV)
- Most of the overworld explored smoothly without issues alongside story progression through the 2nd dungeon (Gerudo Desert): intro, Hyrule Castle Town, Suthorn Village, Still World (Rifts), 2D sections, 1st dungeon, and Gerudo Desert dungeon with audio, working save/load, and zero freezes.
Known Issues
- Map screen >120 FPS: keep
FPS limitset to60or120in theF1→ Display menu (running at144+FPS currently inverts the analog stick on the map screen). - Untested platforms: Windows x64 (
EoWRecomp-v0.4.0-windows-x86_64.zip) is cross-built via CI and has not been validated on a Windows machine yet.
Quick Start (Linux AppImage)
chmod +x EoWRecomp-v0.4.0-linux-x86_64.AppImage
./EoWRecomp-v0.4.0-linux-x86_64.AppImageOn first launch, select the folder containing your .nsp/.xci and prod.keys. EoWRecomp will extract ExeFS and compile eowgame.so locally.
Full Changelog: v0.3.0...v0.4.0
EoWRecomp v0.3.0 (Beta)
EoWRecomp v0.3.0
Tested Progress
- Played and verified on Linux x86-64 (AMD RX 7600 / RADV) through the completion of the 2nd dungeon (Gerudo Desert) with zero freezes and clean Rift transitions.
Performance (Vulkan / CPU)
- Placed-memory guest heap (
VK_EXT_map_memory_placed+VK_KHR_map_memory2): ReplacesVK_EXT_external_memory_host(userptr) with native host-cached GTT memory mapped directly atHEAP_BASE, eliminating per-submitamdgpuuserptr validation overhead on Linux RADV (~50xfastervkQueueSubmit2). Automatically falls back toVK_EXT_external_memory_hoston drivers withoutVK_EXT_map_memory_placed. - CPU draw hot-path optimizations: Cached per-stage
stencil_slots()masks invalidated on texture pool updates, and gated unused debug shader hashing andF10bisect scans indraw_(). - Measured in heavy open areas on RX 7600 (Linux RADV): ~66 FPS → 91–116 FPS (
~0.027 ms/submit).
Stability & Bug Fixes
- Random freeze / deadlock fix: Replaced non-atomic load+store arbiter updates (
ARB_DEC_WAIT_LESS,ARB_SIGNAL_INC_EQ,ARB_SIGNAL_MOD_EQ) with atomic CAS inruntime/kernel.c, and raised the Linux watchdog threshold from 500 ms to 2 s with thread dumps beforekernel_unstick(). - Rift / Void rendering fix: Track GPU-written buffer lifetime by submission sequence (
gw_tab) and sync only whenguest_livecannot be used due to alignment/bounds, fixing visual glitches after exiting Rift areas without address-specific workarounds (credit:tcsenpai/EoWRecomp).
Downloads
- Linux x86-64 (
EoWRecomp-v0.3.0-linux-x86_64.AppImage): Make executable (chmod +x) and run. - Windows x64 (
EoWRecomp-v0.3.0-windows-x86_64.zip): Built via GitHub Actions (untested locally — primary testing is on Linux). - Requires your own legal copy of the game files (
prod.keys+.xci/.nsp).
EoWRecomp v0.2.0 — Linux x86-64
- 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.