Skip to content

Releases

EoWRecomp v0.5.0

Choose a tag to compare

@github-actions github-actions released this 20 Nov 05:20

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/.nsp RomFS scanning via nx_romfs_open and ShaderKey.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 automatic cache/shader_seen.txt caching 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-slot TXQ lookups (0x120..0x158) via stage_tex_handle(), and stage_set() enforces valid rscale values for compute shaders.
  • Sync Shader Mode by Default: changed default sync_shaders to SHADER_SYNC for zero visual pop-in in unseen areas while shader_prep handles known shaders ahead of time (still switchable to Smart or Async in the F1 menu).
  • RecompLauncher Integration: recomplauncher.json is 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 limit set to 60 or 120 in the F1 → Display menu (running at 144+ 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.AppImage

On 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

Choose a tag to compare

@github-actions github-actions released this 19 Nov 22:50

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 in runtime/nvn/vulkan/exec.c to 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 Smart mode: vk_prewarm_drain() now matches the active nvn_window_origin() and nvn_depth_mode() instead of hardcoded defaults, and SHADER_SMART waits synchronously on critical fullscreen/compute passes.
  • Root-cause kernel freeze & watchdog fixes: fixed svc_wait_process_wide_key() lost wake-up and block_current() TimedWait vs Signal race in runtime/kernel.c, and prevented duplicate Linux crash-handler/watchdog initialization in runtime/platform/linux.c (0 unstick in 272 s+ test runs).
  • RecompLauncher support: added recomplauncher.json to 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 limit set to 60 or 120 in the F1 → Display menu (running at 144+ 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.AppImage

On 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)

Choose a tag to compare

@patrickksmdev patrickksmdev released this 19 Nov 02:30

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): Replaces VK_EXT_external_memory_host (userptr) with native host-cached GTT memory mapped directly at HEAP_BASE, eliminating per-submit amdgpu userptr validation overhead on Linux RADV (~50x faster vkQueueSubmit2). Automatically falls back to VK_EXT_external_memory_host on drivers without VK_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 and F10 bisect scans in draw_().
  • 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 in runtime/kernel.c, and raised the Linux watchdog threshold from 500 ms to 2 s with thread dumps before kernel_unstick().
  • Rift / Void rendering fix: Track GPU-written buffer lifetime by submission sequence (gw_tab) and sync only when guest_live cannot 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

Pre-release

Choose a tag to compare

@patrickksmdev patrickksmdev released this 17 Nov 01:43
  • 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, title 01008CF01BAAC000) and your console's prod.keys. The AppImage compiles eowgame.so locally 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 in F1 → Display → Shader compilation: Smart / Sync / Async).
  • VSync toggle & FPS limit selector (30 / 60 / 120 / Unlimited) in the F1 menu.
  • Linux hang watchdog with automatic kernel_unstick + WAITERS_BIT fix in mutex_acquire_or_mark.
  • XCI (HFS0) support in tools/nca_extract.py and 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 (or 120): running at 144+ fps currently inverts the analog stick on the map screen.
  • First visits to new areas may still have brief shader compilation hitches in Smart mode 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.AppImage

Requirements: 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.

Credits