Eglantine

Émulateur 0.1.0-rc3

Émulateur Nintendo Switch 2 libre et expérimental, avec un build macOS pour Apple Silicon.

Eglantine est un émulateur Nintendo Switch 2 libre (GPL-3.0), écrit en C++ et dérivé d'Eden, de Yuzu et de Sudachi. Il est développé par Camille LaVey.

Il existe en versions Windows, Linux et macOS. Le build macOS est prévu pour Apple Silicon (arm64) et demande macOS 15 ou plus récent. L'application n'est pas notariée : au premier lancement, il faut la débloquer par un clic droit puis « Ouvrir », ou avec xattr -dr com.apple.quarantine eglantine.app.

L'émulation reste très expérimentale : Mario Kart World et Splatoon Raiders sont jouables, Donkey Kong Bananza demande encore des réglages, et toute la ludothèque Switch 2 n'est pas prise en charge. Les versions se succèdent à un rythme rapide (builds successifs).

Dernière mise à jour :

Plateformes

Nintendo Switch 2

Architecture

Apple Silicon Apple Silicon Mac OS X - macOS Mac OS X - macOS

Téléchargement et liens

Historique des versions

0.1.0-rc4
  • Intégration des noms officiels de Switch 2 HLE services via Switchbrew pour une meilleure compatibilité logicielle.
  • Stabilité améliorée pour Ocarina of Time (nx2) avec corrections de shaders, optimisations GPU-thread et pipeline asynchrone.
  • Prise en charge macOS : correction de builds pour Apple Silicon (M1/M2/M3) et résolution de problèmes spécifiques à nx2-experimental.
  • Améliorations Mario Kart World : rendu de l’herbe, éclairage, gestion des timestamps de textures et précompilation des effets au démarrage.
  • UI et expérience utilisateur : mémorisation des paramètres MKW, réorganisation des menus et ajout de traductions Qt par défaut.
  • Corrections critiques : stabilisation de Hyrule Warriors (FPS dynamique, 30 FPS, suppression de plantages), et gestion des erreurs GPU sur macOS.
  • Mises à jour techniques : optimisations de compilation (GCC 13), suppression de boucles de feedback sur la date RTC et gestion des pipelines Vulkan.
  • Fonctionnalités expérimentales : serveur MCP intégré (off par défaut) pour agents IA et amélioration des performances via précompilation compute.

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: https://github.com/Eglantine-Community/Eglantine/compare/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 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.

20261114
  • Amélioration des performances GPU pour les commandes Switch 2 avec une latence minimale garantie à 30/20 FPS.
  • Lecture des effets VFXB (.ptcl) et des jeux d’effets Mario Kart World (.esetb) pour le préchauffage des shaders.
  • Correction des fuites de trames vidéo pour les clients qui régulent leur rythme (nx2_gsv).
  • Optimisation des chargements globaux de tâches et de maillages sur les cartes graphiques Pascal.
  • Mise à jour de FFmpeg dans les dépendances (cpmfile.json) et intégration statique pour les builds Linux.
  • Ajout d’un canal Daily pour les mises à jour automatiques, avec suppression des notifications quotidiennes intrusives.
  • Correction des problèmes d’ouverture des dialogues Settings et Tweaks dans Yuzu lors de leur destruction.
  • Centrage des boutons des prompts de mise à jour et ajustement des espacements dans l’interface utilisateur.

Automatic daily build of nx2-experimental at f7c0cc3.

Changes since the previous daily build

  • Fix license headers (f7c0cc30ac)
  • removed legacy CI, keeping license-header.sh as requested by @PastaLaPate (e4f5ab654f)
  • 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)
  • 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)
  • 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)
  • 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)
  • 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)
  • 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)
  • 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)
  • 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)
  • 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.

20261112
  • Ajout d’un mode 30 FPS et d’un FPS dynamique pour Hyrule Warriors via son intervalle de trame en split-screen.
  • Correction d’un blanc à l’écran sur macOS liée à une limite abaissée du masque de buffer vertex Apple.
  • Correction de la compilation macOS et suppression d’un bug -Wself-assign-field.
  • Disponibilité des builds Apple Silicon (ARM64) sous .dmg et .zip, compatibles avec macOS 13 (Ventura) ou supérieur.
  • Ajout d’un onglet RAM dans les paramètres Performance avec les options de cold hints (désactivées par défaut).
  • Correction de la gestion des synchronisations GPU pour éviter les blocages de Mario Kart World avec l’émulation GPU asynchrone désactivée.

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 https://github.com/Eglantine-Community/Eglantine/pull/790#pullrequestreview-5828904982 (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 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.

Réagir sur le forum

Une question, un retour d’expérience ? Ouvrez la discussion sur le forum.

Réagir sur le forum