Skip to content

EoWRecomp v0.2.0 — Linux x86-64

Pre-release
Pre-release

Choose a tag to compare

@patrickksmdev patrickksmdev released this 17 Nov 01:43
· 26 commits to main since this 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, 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