Skip to content

Releases

Eglantine Build 18/11/2026

Pre-release

Choose a tag to compare

@github-actions github-actions released this 18 Nov 11:32
4989352

Automatic daily build of nx2-experimental at 4989352.

Changes since the previous daily build

  • shader: keep the global memory helpers as calls outside task and mesh programs (20087a707d)
  • shader: inline the global memory helpers by default (Ocarina's tree wall) (8a1fa0351b)
  • vulkan: use the compute mesh fallback on AMD drivers (4336f3fac7)
  • made the AMD perf recommendation conditional (69a83a571c)
  • better description for AMD performance EDEN_NX2_FENCE_WAIT=host (a37c50589d)
  • performance: recommend the host fence wait on AMD (6775f0f2e8)
  • feat: added forum post for each daily build (5c7fa2e708)
  • ci: embed AppImage update information in stable Linux builds (472c1d00a5)

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system Qt and needs Qt 6.8 or newer (Arch, Fedora 41, Debian 13, Ubuntu 25.04 or newer). On Ubuntu 24.04, use the AppImage.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) MSVC zip Use if you run into graphical issues on other builds
amd64 / x86_64 (MinGW) MinGW PGO zip Built with MinGW clang; bundles its own DLLs, no Visual C++ redistributable needed

The PGO builds are the same programs compiled with profile-guided optimization (clang plus Eglantine's profile); prefer them when your CPU supports it.

Eglantine Build 17/11/2026

Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Nov 11:57

Automatic daily build of nx2-experimental at a01c9c1.

Changes since the previous daily build

  • video_core: restore brace closing the frame dump buffer capture block (532ee49d4e)
  • video_core: restore brace closing the frame dump buffer capture block (d97c3e62bd)
  • video_core: fix MSVC C4293 shift warning and ShaderHashes lookup (dc1e78d5ed)
  • video_core: fix MSVC C4293 shift warning and ShaderHashes lookup (8e19de8800)
  • video_core: restore brace closing the frame dump buffer capture block (bf8d0adeae)
  • tools/nx2: catalogue: Ocarina of Time: 3 programs (1e7921a8dd)
  • video_core: read header byte-offset texture handles only for Switch Sports (ae926ec957)
  • vulkan: remove the unused mesh dispatch helper (2fef7ba21f)
  • vulkan: run in-order uploads before the held render pass (b6d7b1bd76)
  • vulkan: batch hoisted mesh emulation work by stage (4076f4897a)
  • shader_recompiler: allocate the mesh arena atomically (fa510f16f6)
  • vulkan: run emulated mesh dispatches before the render pass (a838e1fe3a)
  • video_core: fix MSVC C4293 shift warning and ShaderHashes lookup (5b5b28aba8)
  • vulkan: defer guest wait-for-idle to the end of the render pass (5bd8edc3ab)
  • vulkan: keep the render pass for depth sampling without depth writes (bdaf482d3f)
  • kepler_compute: optionally replace Ocarina of Time's AA pass without DLSS (6e60b0479b)
  • texture_cache: bound ASTC->BC transcode scratch memory (54c034ad29)
  • settings: add vram_reserve_mib (47c7694ad9)
  • vulkan: fall back to over-budget / host memory for buffers (bf00f23920)
  • macro: bound MultiDrawIndexedIndirectCount fallback parameters (ede972aab5)
  • prepo: handle prepo:u 10500 (Switch 2 play report) (05a113756d)
  • Reapply "vulkan: skip pipelines the driver refuses, harden texture cache and query copies" (a310a7e902)
  • common: log uncaught exceptions before terminating (a829b3460b)
  • tests: match TXD register-pressure expectations to quartet pairing (7709f89a15)
  • shader: validate constant-buffer F2I fields, fence SB0 waits with a list, shadow SHF/FSETP/STG immediates (d14e927435)
  • video_core: wait for earlier work before resetting sparse tiles (7db4255df4)
  • video_core: keep zero-block sparse tiled images across guest tile unmaps (d91160c2f2)

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system Qt and needs Qt 6.8 or newer (Arch, Fedora 41, Debian 13, Ubuntu 25.04 or newer). On Ubuntu 24.04, use the AppImage.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) MSVC zip Use if you run into graphical issues on other builds
amd64 / x86_64 (MinGW) MinGW PGO zip Built with MinGW clang; bundles its own DLLs, no Visual C++ redistributable needed

The PGO builds are the same programs compiled with profile-guided optimization (clang plus Eglantine's profile); prefer them when your CPU supports it.

Eglantine v0.1.0-rc4

Choose a tag to compare

@TheKJAMP TheKJAMP released this 15 Nov 04:27

Release candidate of 0.1.0. Please test it and report problems before the final release.

  • Initial release candidate

What's Changed

New Contributors

Full Changelog: Eglantine-Community/Eglantine@v0.1.0-rc3...v0.1.0-rc4

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system Qt and needs Qt 6.8 or newer (Arch, Fedora 41, Debian 13, Ubuntu 25.04 or newer). On Ubuntu 24.04, use the AppImage.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) [MSVC zip](https://github.com/Eglantine-Community/Eglantine/releases/download/v0.1.0-rc4/eglant...
Read more

Eglantine Build 16/11/2026

Pre-release

Choose a tag to compare

@github-actions github-actions released this 16 Nov 11:28

Automatic daily build of nx2-experimental at 30181ba.

Changes since the previous daily build

  • game_presets: recommend settings for Donkey Kong Bananza (08a5d39b7a)
  • video_core: order indirect-record draws after earlier draws' storage writes (e40871c4af)
  • video_core: give indirect-record draws their base vertex and instance from the draw (e9f27e21fc)
  • video_core: draw GPU-written DrawIndexedIndirect records indirectly on the host GPU (16e27b6d6c)
  • Update src/yuzu/CMakeLists.txt (71d0d2ec5b)
  • ci: don't ship Qt's GLib network information plugin on MinGW (7334d654f0)
  • Pasta forced me to make another commit, so I am fixing outdated README stats instead (4e8533c8e1)
  • video_core: fix build after partial revert (b59bb7bcfb)
  • a random changelog change to trigger ci that somehow didnt fucking started (436350a730)
  • hopefully fixes ci (it wont and there will be 50 more commits trying to fix this stupid ci) (31936f3ed9)
  • added obselete workflows (f7b4bdd816)
  • removed legacy CI, keeping license-header.sh as requested by @PastaLaPate (586d2816e6)
  • build: drop g_release_tag, and fix why the Nix package keeps the updater off (87d62cf10a)
  • ci: daily builds save the compiler cache again (adba0e300d)
  • ci: the daily case follows daily.yml's branch input (84799bb524)
  • nix: say ENABLE_UPDATE_CHECKER=OFF instead of inheriting the default (29f92756a9)
  • ci: name artifacts after the identity, and expose the release tag (ea2b5fd0a0)
  • build: show the composed identity in the title and the About dialog (a1cd9416b6)
  • ci: compose the build identity once, in prepare, and hand it to every leg (ceca98b5c7)
  • ci: drop the linux ccache debug dump, keep the numbers (c88efa2d3c)
  • ci/nix: print the whole ccache block after the check step (6b81942296)
  • ci/nix: save the compiler-object cache on the same rule as every other leg (45761784b2)
  • ci: drop the APT archive cache; it never paid for itself (ed5dce3dae)
  • ci: create apt's archive dirs before pointing apt at them (9a76e3bfb4)
  • ci: cache apt's archive in a directory the runner can actually write (b661c2f372)
  • ci: key the APT archive by runner arch (b968b7d22d)
  • ci: keep MSYS2's full update; skipping it breaks on a cold cache (048c371e7e)
  • ci: cut the per-run setup cost on macOS, Linux and MSYS2 (8107eef80d)
  • ci: ccache -p prints (default) prefixed lines, so the anchored grep matched nothing (f495d575b1)
  • ci: put the linux ccache debug block back (7fa0407725)
  • ci: one definition of the compiler cache env, opt-in saving, config-stable cache names (93cffced16)
  • ci: make ccache stats mean this run, and print the effective settings (e5e4140755)
  • nix: gamemode's FORCE_SYSTEM has to be conditional too (d5346e9d74)
  • nix: sirit is Linux-only in nixpkgs, so gate it like gamemode (880535e713)
  • nix: pin nine more dependencies to nixpkgs (45610b7f1c)
  • nix: take dependency versions from nixpkgs where it can serve them (6d4cad5c3e)
  • cmake: record the manifest pin next to a substituted system package (a6227da8c7)
  • nix: drop the dependencies CPM already supplies (05cb6f8435)
  • nix: own the dependency list instead of inheriting pkgs.eden's (d98216ba21)
  • nix: make nightly a property of the tree, not a second package (47e5c4aab0)
  • ci/nix: give the Nix build the same identity as every other platform (95329e545e)
  • ci/nix: gate the Nix job on the inputs that exist, and stop building everything (6d6354976e)
  • Corrections per Eglantine-Community#790 (review) (b77deda6bc)
  • A proper Nix flake (40a97d4b3a)
  • ci: start the daily build from daily.yml on the default branch, and label it with its branch (55d8be6551)
  • ci: do daily builds on nx2-exp (8cf4beb9d4)
  • Revert "video_core: Fix shader cache folder creation for MKW" (188ee5bcf8)
  • Revert "vulkan: skip pipelines the driver refuses, harden texture cache and query copies" (1841792480)

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system libraries, so Qt 6 and the usual libraries must be installed.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) MSVC zip Use if you run into graphical issues on other builds
amd64 / x86_64 (MinGW) MinGW PGO zip Built with MinGW clang; bundles its own DLLs, no Visual C++ redistributable needed

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip · dmg macOS 26 or newer. Not notarized: right-click and choose Open the first time, or run . is inside the app, in .

The PGO builds are the same programs compiled with profile-guided optimization (clang plus Eglantine's profile); prefer them when your CPU supports it.

Eglantine Build 15/11/2026

Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 11:37

Automatic daily build of nx2-experimental at 25fc116.

Changes since the previous daily build

  • bumped to 0.1.0-rc4 (2ad5b4d5d8)
  • nx2: OoT 60 fps work (662af0bfaf)
  • Optimization fixes for regression on AMD Hardware (b54d1f064f)
  • vk_pipeline_cache: require depth testing and a color write for the native skip (5943a945d7)
  • Fix license headers (f7c0cc30ac)
  • vk_pipeline_cache: skip depth-tested native draws into redrawn targets while building (5551c9576a)
  • removed legacy CI, keeping license-header.sh as requested by @PastaLaPate (e4f5ab654f)
  • buffer_cache: don't re-copy a command list page after a CPU write (aeab4fc3a2)
  • Fix Windows builds of the page-table and preset tests (99702443f9)
  • Load Mario Kart World HDR lightmaps by sparse tile (20fab1102b)
  • Use the full size of Mario Kart World lighting buffers (894f2c119c)
  • build: the updater UI and the Nix package follow the identity (bb4bac869d)
  • ci: daily builds save the compiler cache again (b8fa471008)
  • ci: the daily case follows the branch the dispatch came from (1458b03bc5)
  • nix: say ENABLE_UPDATE_CHECKER=OFF instead of inheriting the default (f13f57ee2f)
  • ci: name artifacts after the identity, and expose the release tag (e79386b19e)
  • build: show the composed identity in the title and the About dialog (8b3ed296de)
  • ci: compose the build identity once, in prepare, and hand it to every leg (f4597a1df9)
  • ci: drop the linux ccache debug dump, keep the numbers (89169b9bc0)
  • ci/nix: print the whole ccache block after the check step (da221636fc)
  • ci/nix: save the compiler-object cache on the same rule as every other leg (41d005e696)
  • ci: drop the APT archive cache; it never paid for itself (b9b63eb867)
  • ci: create apt's archive dirs before pointing apt at them (d407d1b035)
  • ci: cache apt's archive in a directory the runner can actually write (43ae1967ef)
  • ci: key the APT archive by runner arch (faa6ff453e)
  • ci: keep MSYS2's full update; skipping it breaks on a cold cache (7c083b7eaa)
  • ci: cut the per-run setup cost on macOS, Linux and MSYS2 (22ef385498)
  • ci: ccache -p prints (default) prefixed lines, so the anchored grep matched nothing (225bf04912)
  • ci: put the linux ccache debug block back (a58918c22f)
  • ci: one definition of the compiler cache env, opt-in saving, config-stable cache names (0c9ec721b3)
  • ci: make ccache stats mean this run, and print the effective settings (0b80e31dae)
  • nix: gamemode's FORCE_SYSTEM has to be conditional too (ed1b188464)
  • nix: sirit is Linux-only in nixpkgs, so gate it like gamemode (0ed5947752)
  • nix: pin nine more dependencies to nixpkgs (3a58b5c82c)
  • nix: take dependency versions from nixpkgs where it can serve them (326381e0cc)
  • cmake: record the manifest pin next to a substituted system package (05c3dd3447)
  • nix: drop the dependencies CPM already supplies (fa8a0ce85c)
  • nix: own the dependency list instead of inheriting pkgs.eden's (f3b71a7975)
  • nix: make nightly a property of the tree, not a second package (950975ee7e)
  • gpu: keep GPU tick timestamps for Mario Kart World (9387b5225e)
  • ci/nix: give the Nix build the same identity as every other platform (bb9ac9160d)
  • ci/nix: gate the Nix job on the inputs that exist, and stop building everything (e267a5fc2d)
  • updater: stop nagging daily builds, offer same-day rebuilds, cut requests (e1b287e623)
  • updater: add a Daily channel that follows the daily builds (a39b614822)
  • yuzu: don't run the Settings tab handler while the dialog is destroyed (e9235f6ec6)
  • gpu_thread: give Switch 2 command lists a minimum GPU latency at 30/20 fps (53ebf6cd49)
  • nx2_gsv: don't drop movie frames for clients that pace themselves (c229de4f6f)
  • qt: make copying old data folders safe (5e1a0619d4)
  • qt: don't crash migrating when the old emulator has no cache folder (c7cb2c7310)
  • qt: offer to move data folders left behind by an earlier migration (ef9fb96de5)
  • qt: point migrated configs at the Eglantine data folder (8bcb822daf)
  • updater: fix review findings on PR 841 (1da3a00c95)
  • updater: keep files a failed undo could not put back, lock the helper (6cee3144f7)
  • yuzu: don't run the Tweaks tab handler while the properties dialog is destroyed (885b7e29a0)
  • ui: centre update prompt buttons, adjust spacing (31aaad5309)
  • fix: fix ssl cert pinning in appimage (30b8757820)
  • tests: fix update_installer file time check on libc++ (18b9724efc)
  • configure_general: put the update settings in their own group (75fc958481)
  • ci: build the updater helper into Windows release builds (1c8f3b8995)
  • yuzu: install updates in place and restore the previous version (92d1a4af8f)
  • frontend_common: update installer and Windows helper, from Lichii (2f5785e2ca)
  • yuzu: update channel setting, verified downloads, Check for Updates (0d4b7b18ee)
  • update_checker: stable and release candidate channels (a1507a50ea)
  • common/net: read releases from the GitHub API (27f5e7c843)
  • ci: enable the update checker on tagged release builds (488792daaa)

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system libraries, so Qt 6 and the usual libraries must be installed.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) MSVC zip Use if you run into graphical issues on other builds
amd64 / x86_64 (MinGW) MinGW PGO zip Built with MinGW clang; bundles its own DLLs, no Visual C++ redistributable needed

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip · dmg macOS 26 or newer. Not notarized: right-click and choose Open the first time, or run . is inside the app, in .

The PGO builds are the same programs compiled with profile-guided optimization (clang plus Eglantine's profile); prefer them when your CPU supports it.

Eglantine Build 14/11/2026

Choose a tag to compare

@TheKJAMP TheKJAMP released this 14 Nov 10:17
0a2323e

Automatic daily build of nx2-experimental at 0a2323e.

Changes since the previous daily build

  • ci: daily builds are started by daily.yml on the default branch, not by a schedule here (a988ff32e7)
  • ci: label daily builds with the branch they were built from (39db3242fa)
  • kepler_compute: clear rejected programs on shader restore (7ab366dcab)
  • Update FFmpeg repo and version in cpmfile.json (f13b71f4ba)
  • ci: release notes: the tar.gz needs Qt 6.8 (9118a6513f)
  • ci: link FFmpeg statically into the Linux builds (e31e348539)
  • qt: cover host room and direct connect, share one profile rename path (dc2dda20a2)
  • video_core, mcp: rename locals that shadow members (6a82ad47a7)
  • qt: fix default-name warning wording, hold profile names to 32 bytes (089a2dac90)
  • Batch ordered Vulkan buffer uploads (a6bcdf4690)
  • Fix task and mesh global loads on Pascal (0de9d55c19)
  • mcp: frame_spikes and perf_sample count CPU, JIT and SVC events (e7e795bfe5)
  • shader_warm: read VFXB particle effects (.ptcl) (37c2ff5028)
  • shader_warm: build the precache at boot when it is missing or outdated (bd3d8187f8)
  • shader_warm: read Mario Kart World's .esetb effect set (26cbc05ba2)
  • nx2 debug server: capture_frame sampled_max_mib (02d09a6c66)
  • texture_cache: date CPU-refreshed images by the CPU write, not the upload (95cf0acc7d)
  • qt: default identity is Eglantine, warn about default names in multiplayer (636cf90edb)

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system libraries, so Qt 6 and the usual libraries must be installed.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) MSVC zip Use if you run into graphical issues on other builds
amd64 / x86_64 (MinGW) MinGW PGO zip Built with MinGW clang; bundles its own DLLs, no Visual C++ redistributable needed

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip · dmg macOS 26 or newer. Not notarized: right-click and choose Open the first time, or run . is inside the app, in .

The PGO builds are the same programs compiled with profile-guided optimization (clang plus Eglantine's profile); prefer them when your CPU supports it.

Eglantine Build 12/11/2026

Choose a tag to compare

@TheKJAMP TheKJAMP released this 13 Nov 14:17

Automatic daily build of nx2 at 06c5c84.

Changes since the previous daily build

  • ci: do daily builds on nx2-exp (06c5c84b55)
  • cmake: turn off loop unswitching on GCC 13 and newer (015ad398b6)
  • fix: MKW hanging when ASYNC GPU EMU OFF - Refactor GPU::Impl to enforce synchronous execution in RunInOrder and MapInOrder methods (1b4e0ca8ba)
  • Address review: probe reset, loader bounds, syncpoint mirror ordering (3c1a072b42)
  • nx2_gsv: mirror guest syncpoint increments before answering waits (aa57908a67)
  • game_presets: list the Hyrule Warriors frame-rate options as game tweaks (fb1e68b627)
  • nx2: add a 30 FPS mode for Hyrule Warriors (92e8fed914)
  • nx2: dynamic FPS for Hyrule Warriors through its split-screen frame interval (307e62bdef)
  • qt_common: mark the separate driver shader cache as Linux only (42f6737c3a)
  • yuzu: compact GPU tab with a vendor dropdown (51718aca19)
  • yuzu: show game tweaks only in the game's Tweaks tab (b24fe1a7e4)
  • yuzu: Performance gets GPU and Shaders tabs; mesh shader setting (032a4b1506)
  • yuzu: widen game properties so the Tweaks table fits (dcdc1c7b99)
  • yuzu: per-game Tweaks tab and a Frame Generation tab (df62e5f900)
  • yuzu: rework the recommended settings prompt (0ba9858577)
  • Refactor function signatures to improve clarity and maintainability for cleaner build logs (85ceab13ab)
  • video_core: don't shadow the stage's SPIR-V in the mesh emulation dump (b35cd8d583)
  • video_core: shader precache reads files of older compatible versions (85e23618fb)
  • yuzu: keep nx2_switches.txt in the portable user folder (dc97e8f94c)
  • Fixed the compute shader pre-compilation not working on loose dumps (42d397da3b)
  • video_core: measure late texture pool reads in async translation (7ac7ca85de)
  • video_core, yuzu: let a shader precache build stop early (b19685e2c3)
  • video_core: write the Vulkan pipeline cache before the background builds start (78059315a9)
  • vk_pipeline_cache: build the cache directory with the shared helper (f9d75e77fe)
  • qt_common: remove the Mario Kart World Vulkan pipeline cache from its subdirectory (25f30e3d51)
  • yuzu: put the RAM tab's settings in a General group (e6a6241c9d)
  • video_core: share vertex buffer mask, bound repack loop (f521ce8a87)
  • fix: fix macos compilation (93aaf155a8)
  • fix: lower apple vertex-buffer mask clamp, fix black screen (243d27f242)
  • nce: handle sent host SIGILLs without dropping them or the handler (5a8eb1b151)
  • docs: nx2: cold hint modes (a959291645)
  • common, core, yuzu, mcp: release uploaded guest memory only when RAM is low (42fdfac891)
  • -Wself-assign-field fix for macos (2ef93ccd6c)
  • docs: nx2: cold hints (988721c562)
  • yuzu: a RAM tab in Performance with the cold hints setting (7bd099ba56)
  • common, core, mcp: cold hints off by default, with a setting and an MCP switch (3b87091034)
  • vulkan: keep texture invalidation with skip CPU enabled (c56c3b307b)
  • tools/nx2: catalogue Ocarina tree depth shader (690ea8b691)
  • system: prevent RTC offset shift on apply and improve per-game global state tracking (4374bd4c1e)
  • system: Fix per-game Custom RTC Date configuration and sync (30cff3a868)
  • system: Fix Custom RTC Date offset calculation and UI feedback loop (04f72f5513)
  • qt: prioritize on-disk translations, filter valid locales, and share search paths (c4ed1560c1)
  • qt: enable Qt translations by default and support external language files (3b28ba149f)
  • docs: nx2: the frame spike recorder (9102b015d2)
  • video_core, mcp: a frame spike recorder (497543a72b)
  • docs: nx2: queued translations, precache scheduling and SPIR-V identity (d142e14caf)
  • tests: check that the shader precache builds the game's SPIR-V (aacd0244c6)
  • video_core: the shader precache waits for the game's pipeline builds (cd5646cd91)
  • video_core: a draw that can't be skipped translates its queued pipeline itself (12dfe71a66)
  • fix linux build (82b972c97a)
  • video_core: drop the extra shader pre-compile logging (3bfe1ba534)
  • video_core: find .zst shader archives and log what the pre-compile finds (3ab5f10ba9)
  • video_core: use the portable cycle counter in the buffer cache sync stats (4a2ac55067)
  • video_core: build the NX2 timeline and draw stats diagnostics with MSVC (dea0fb656f)
  • docs: nx2: shader compilation notes (789d49beba)
  • common, frontends: a setting for the private driver shader cache and its size (51b1fa573c)
  • video_core, yuzu: pre-compile a game's compute shaders from its files (b4d80e4d70)
  • vk_pipeline_cache: move cache directory setup to its own file and test it (f35a6d3cc1)
  • vk_pipeline_cache: create nested Mario Kart World cache directory (a7c83d1c45)
  • common, frontends: keep NVIDIA's driver shader cache in a folder of our own on Linux (dfdf190200)
  • video_core: log driver pipeline build times (212568b2f0)
  • video_core: translate a queued pipeline's stages in parallel (ecc96f264f)
  • video_core: as many pipeline translators as driver compile workers, below normal priority (40633dc5ce)
  • video_core: reuse translated native shader stages across pipelines (d1195b7d49)
  • common: asynchronous shaders on by default (2d61242e29)
  • video_core: translate new native graphics pipelines on worker threads (0f1ae997c2)
  • tests: offline shader translation bench over native dumps (1cbc9a404c)
  • shader_recompiler: remove static clip_distance_written data race in SPIR-V emit (36c6325950)
  • shader_recompiler: skip instructions failed storage buffer searches already walked (87b0f018a8)
  • shader_recompiler: create SSA phis of sealed blocks only when they are needed (5c2c7f468b)
  • spirv: remember the ids of scalar constants (398dfbc1dd)
  • shader_recompiler: keep SSA definitions of predicates and flags in blocks (e4197fb887)
  • shader_recompiler: drop unused identities at the end of the SSA rewrite (847cba4d07)
  • fsp: throttle Switch 2 storage reads at 100 MB/s instead of not at all (45d1fdbdf4)
  • video_core: EDEN_NX2_HOST_IMPORT is on by default for NVIDIA on Linux (56e70161d7)
  • video_core: probes for uniform stream reuse in EDEN_NX2_BIND_STATS (62564b004d)
  • video_core: EDEN_NX2_BIND_STATS probes for draw preparation (321aaa0662)
  • Corrections per Eglantine-Community#790 (review) (4bc9692b79)
  • video_core: EDEN_NX2_BIND_STATS diagnostics for the buffer cache (145c283b0a)
  • video_core: stop write-protecting guest pages the CPU rewrites every frame (f27522bfb9)
  • video_core: cache GPU page translations per thread (b1e650849e)
  • video_core: protect, draw and thread CPU diagnostics for the back thread (7da9d855a7)
  • video_core: EDEN_NX2_TIMELINE and EDEN_NX2_SAMPLER diagnostics for the guest-to-fence chain (1182ee3242)
  • yuzu: Performance settings page with per-platform launch arguments (1eeb6e957c)
  • video_core: EDEN_NX2_HOST_IMPORT, native uniform banks read guest memory in place (51523cba8f)
  • video_core: count guest bytes read per upload class under EDEN_NX2_HAZARD (05c952b8b7)
  • qt: reset remembered settings prompts from the right-click menu (3347ce5a3b)
  • video_core: skip same-value instance-loop writes and batch macro writes on the split front (1c46e5b151)
  • video_core: EDEN_NX2_HAZARD log-only detector for frames-ahead hazards (3be2922a10)
  • breakpad: prefer system client library on Linux and limit dump size (d59f7e72bd)
  • mcp: document the NX2 debug_knobs bits in the tool description (777ee36ed0)
  • video_core: cut NX2 front/back split waits, add live knobs and drain profiling (d3612f82b1)
  • nx2: Ocarina of Time stability, shader and performance fixes (c6d2acd37a)
  • vulkan, shader: draw task/mesh pipelines through compute without VK_EXT_mesh_shader (db61d0de3f)
  • A proper Nix flake (7d51b4b470)
  • docs: update submodule with MDX documentation conversion (61bc09234d)
  • vk_pipeline_cache: wait for new pipelines of Switch 2 draws without depth (7a940ca19d)
  • Fix Mario Kart World grass rendering (b7980efd7f)
  • new docs (46c4f38672)
  • docs: add docs submodule (1ab984879e)

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system libraries, so Qt 6 and the usual libraries must be installed.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) MSVC zip Use if you run into graphical issues on other builds
amd64 / x86_64 (MinGW) [MinGW PGO zip](https://github.com/Eglant...
Read more

Eglantine Branch: Tester builds: follow a branch or PR and build it on the user's machine

Choose a tag to compare

This is not a release. It is for testing updates. There are no emulation changes.

New build which automates building a branch or PR locally without manually setting up dependencies.

To try it out:

  • Install the new build then open Emulation -> Configure.
  • There will be a new Updates section.
  • Set Build source to Tester build
  • Set Branch or pull request to updater/tagged-channels
  • Click Build now and a new window will popup

Leave feedback in Eglantine-Community#842 .

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system libraries, so Qt 6 and the usual libraries must be installed.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) MSVC zip Use if you run into graphical issues on other builds

Eglantine Branch: nx2-experimental

Choose a tag to compare

@TheKJAMP TheKJAMP released this 13 Nov 14:20
b8b3b87

What's in this build

This test build carries the Switch 2 (NX2) work on top of nx2 at b8b3b87: shader compilation moved off the GPU thread by default, task/mesh programs are drawn through compute on hardware without VK_EXT_mesh_shader, there is a built-in MCP server so AI agents can inspect and drive a running game, and Ocarina of Time takes the stability, shader and performance work from the nx2-on-crack fork. The grouped notes below say what changed and what it means in game; the raw commit list and the download tables follow.

Highlights

  • Far less shader stutter. New native graphics pipelines are translated on worker threads (one translator per driver compile worker, below normal priority), a pipeline's stages translate in parallel, and translated stages are reused across pipelines. Asynchronous shaders are on by default, so first-seen content no longer stalls the frame. The trade is a draw skipped for a frame or two while its pipeline builds.
  • Shader precache. A game's compute shaders can be pre-compiled from its own files; the precache waits for the game's own pipeline builds, reads shader files written by older compatible builds, and can be stopped early. The Vulkan pipeline cache is written before the background builds start, and driver pipeline build times are logged.
  • Task and mesh shaders on GPUs that lack VK_EXT_mesh_shader (Pascal-class GTX 10 series, MoltenVK/macOS). NVN task and mesh programs are emitted as compute shaders with an indirect mesh dispatch and a generated pull-vertex shader, so the geometry and screen-space passes that used to be dropped now draw. The real extension is still used whenever the device has it.
  • Ocarina of Time. Crash and hang fixes (VP9 movie race, unbacked images, GPU address-range guards, query waits bounded to 2 s), a large batch of recompiler additions (32-bit global ATOM.CAS, ISETP.EX, TLD4.B from a second descriptor buffer, HMMA.16816.F16 on cooperative matrices, 64 storage buffers per stage), 46 GPU-thread optimizations, a built-in Max Resolution patch, real game speed below 60 FPS, a stand-in for the game's upscaler, a game preset, and NVIDIA DLSS (DLAA and Super Resolution) as a replacement for the game's anti-aliasing.
  • Mario Kart World. Grass renders correctly again, and the recommended-settings prompt shows each setting next to the value in use, lets you pick what to apply, remembers the choice and skips the command-line prompt.
  • Built-in MCP server for AI agents (off by default): boot games, send input, capture frames, read logs and guest memory, set breakpoints, trace IPC and SVCs, list unimplemented commands with caller backtraces, profile the GPU threads, and record or replay input routes. Enable it in Tools > MCP Server or with --mcp; it listens on loopback only, and tools that change emulator state also need writes enabled.
  • Custom RTC Date fixed. The offset calculation, per-game config sync and UI feedback loop are corrected, and applying the setting no longer shifts the offset.

Behaviour changes testers will notice

  • Asynchronous shaders are on by default (Performance > Shaders).
  • Cold hints are now a mode instead of always on: Off (default), When RAM is low, or Always (Performance > RAM). Off costs RAM and removes their stalls; Always is the old behaviour. In Mario Kart World, one cup each, Always versus Off measured 2.10 → 0.53 s a minute lost to frame spikes, 192 → 40 frames over 100 ms and 9 → 3 over 500 ms, at about 1.2 GB more RAM. When RAM is low, passes mark memory MADV_COLD and only page out under real pressure, in 8 MiB pieces, so a pass no longer blocks the GPU threads for its whole length.
  • On NVIDIA on Linux, EDEN_NX2_HOST_IMPORT is on by default: native uniform banks read guest memory in place instead of copying it.
  • Linux keeps NVIDIA's driver shader cache in a folder of Eglantine's own, limited to 10 GiB by default (Graphics > Advanced > Separate driver shader cache, applied at the next start).
  • Switch 2 storage reads are throttled at 100 MB/s instead of running unthrottled. The unthrottled path broke Hyrule Warriors: Age of Imprisonment's boot, and 100 MB/s also loses fewer frames in Ocarina of Time's opening movie.

Performance

  • CPU: GPU page translations are cached per thread, guest pages the CPU rewrites every frame are no longer write-protected, same-value instance-loop writes are skipped and macro writes batched, and the NX2 front/back split waits were cut.
  • Threads: emulation threads can be placed on the 3D V-Cache CCD on asymmetric-L3 CPUs (prefer_3d_vcache, on by default) and pinned with CPU sets on Intel hybrids; audio and cdma threads run on performance cores and HostTiming runs at critical priority.
  • Present: vi2 returns the display release fence instead of pacing inside the present, which fixes Super Mario Bros. Wonder's 30 FPS lock.
  • Memory: guest memory handed to the GPU is released back to the OS only while RAM is actually low, instead of on every pass.

Settings and UI

  • A Performance settings page below Graphics, with NVIDIA, AMD, Intel and MacOS tabs of recommended EDEN_NX2_* launch arguments, an "Add platform recommended defaults" button, and warnings when the device, OS or driver cannot support an argument. Choices are saved to a marked block in nx2_switches.txt, which the portable build now keeps in its portable user folder.
  • Performance is split into GPU (one tab with a vendor dropdown), Shaders (compilation and cache settings, plus a Use mesh shaders switch that leaves VK_EXT_mesh_shader off when disabled) and RAM (cold hints).
  • Game properties gain a per-game Tweaks tab and a Frame Generation tab, game tweaks only appear in the game's own Tweaks tab, and the dialog is wide enough for the Tweaks table.
  • Settings gain an MCP tab; the recommended-settings prompt and the MCP debug knobs are documented in the tool description.

Switch 2 system and games

  • Star Fox: a stand-in for the docked cutscene network (kepler_compute).
  • hid: reads back the scene id and mouse pointer ranges, keeps them per application, and answers IsOunceVibrationDeviceMounted like IsVibrationDeviceMounted.
  • am: IApplicationProxy 40 gets its IPerformanceFunctions, IsTensorRtSupported answers true, IGraphicsScalingParametersFunctions 1050 is accepted, and the overclock request stays on the applet.
  • chat: chat:u returns its objects and events instead of empty replies, and the documented calls are implemented.
  • Switch 2 IPC command names now follow Switchbrew across video decoder sessions, syncpoint, GpuSession, KUserWorkerSession, gsv UserSession and audio, and nvdrv's Switch 2 AS ioctl 0x0B is named after NVGPU_AS_IOCTL_GET_SYNC_RO_MAP.
  • eden-cli: -d/-i no longer crash on a null argument, TAS advances every frame, and a game can be restarted.

Rendering and platform fixes

  • Mario Kart World's grass.
  • Apple GPUs/macOS: the vertex-buffer mask clamp is lowered, which fixes the black screen; framebuffers are clamped to device limits; the macOS build and a -Wself-assign-field error are fixed.
  • Texture invalidation is kept when skipping the CPU side, and vulkan_wrapper retries swapchain and surface enumerations on VK_INCOMPLETE.
  • The NX2 pipeline cache waits for new pipelines of Switch 2 draws that have no depth.
  • breakpad prefers the system client library on Linux and limits the dump size.
  • Linux packaging: udev rules are renamed to 72-eglantine-input.rules and desktop files are installed under dev.eglantine.eglantine.
  • A proper Nix flake; the documentation moved to the Eglantine-Community/docs submodule.

Debugging and tooling

  • A frame spike recorder, live NX2 debug knobs and drain profiling, plus the EDEN_NX2_TIMELINE, EDEN_NX2_BIND_STATS, EDEN_NX2_HAZARD and EDEN_NX2_SAMPLER diagnostics for the guest-to-fence chain, the buffer cache and frames-ahead hazards.
  • Unattended debug sessions with crash evidence, an offline shader-translation bench over native dumps, and tests for the shader precache, the Linux caches and the MCP protocol.
  • Optional core observers for IPC, SVCs, crashes and unimplemented commands, and Switch 2 module names in backtraces.

Known limits

  • Emulated task/mesh geometry still lacks per-primitive outputs, indirect mesh draws and non-triangle topologies, and can flicker where the guest expects more mesh workgroups than a task emits.
  • While a new pipeline translates in the background, its draw is skipped for a frame or two; a draw that cannot be skipped translates its own queued pipeline on the spot and hitches instead.
  • These notes describe the branch at b8b3b87. The next push to nx2-experimental rebuilds and replaces this release, notes included.

Test build of branch nx2-experimental at b8b3b87.

This is not a release. It is for testing, and the next push to the branch replaces it.

Commits on top of nx2

  • qt_common: mark the separate driver shader cache as Linux only (42f6737c3a)
  • yuzu: compact GPU tab with a vendor dropdown (51718aca19)
  • yuzu: show game tweaks only in the game's Tweaks tab (b24fe1a7e4)
  • yuzu: Performance gets GPU and Shaders tabs; mesh shader setting (032a4b1506)
  • yuzu: widen game properties so the Tweaks table fits (dcdc1c7b99)
  • yuzu: per-game Tweaks tab and a Frame Generation tab (df62e5f900)
  • yuzu: rework the recommended settings prompt (0ba9858577)
  • Refactor function signatures to improve clarity and maintainability for cleaner build logs (85ceab13ab)
  • video_core: don't shadow the stage's SPIR-V in the mesh emulation dump (b35cd8d583)
  • video_core: shader precache reads files of older compatible versions (85e23618fb)
  • yuzu: keep nx2_switches.txt in the portable user folder (dc97e8f94c)
  • Fixed the compute shader pre-compilation not working on loose dumps (42d397da3b)
  • video_core: measure late texture pool reads in async translation (`7ac7ca...
Read more

Eglantine v0.1.0-rc3

Choose a tag to compare

@TheKJAMP TheKJAMP released this 13 Nov 14:24

Release candidate of 0.1.0. Please test it and report problems before the final release.

  • Initial release candidate

Linux

The AppImage is self-contained (needs glibc 2.39 or newer: Ubuntu 24.04, Fedora 40, Debian 13, Arch): make it executable with chmod +x and run it. The tar.gz uses your system libraries, so Qt 6 and the usual libraries must be installed.

Build Type Standard PGO (Recommended) Notes
amd64 AppImage · tar.gz AppImage · tar.gz
ARM (aarch64) AppImage · tar.gz AppImage · tar.gz

Windows

Windows packages are in-place zip files: extract and run eglantine.exe, or eden-cli.exe from a terminal.

Build Type Standard PGO (Recommended) Notes
amd64 / x86_64 (MSVC) MSVC zip Use if you run into graphical issues on other builds
amd64 / x86_64 (MinGW) MinGW PGO zip Built with MinGW clang; bundles its own DLLs, no Visual C++ redistributable needed

macOS

Build Type Standard PGO (Recommended) Notes
arm64 (Apple Silicon) zip · dmg macOS 26 or newer. Not notarized: right-click and choose Open the first time, or run . is inside the app, in .

The PGO builds are the same programs compiled with profile-guided optimization (clang plus Eglantine's profile); prefer them when your CPU supports it.