An experimental, free and open-source Nintendo Switch 2 emulator written in C++, derived from Eden, yuzu and Sudachi.
Compatibility | Download | Getting started | Mods | Building | Contributing | License
Warning
Eglantine is very experimental. Expect crashes, graphical glitches and missing features, and keep backups of your saves.
| Game | Status |
|---|---|
| Pokémon Pokopia | Playable. |
| Mario Kart World | Runs at decent to full speed, depending on your hardware and settings. |
| Splatoon Raiders | Runs, with variable performance. |
Other games are being brought up. A full compatibility list will follow.
Every change to main is built and published on the Releases page. Day-to-day work happens on dev, which has no automatic builds. Every package is built with clang and profile-guided optimization (PGO). The x86_64 packages need a CPU with AVX2 (x86-64-v3: Intel Haswell from 2013, AMD Ryzen, or newer); on an older one the emulator says so and quits.
| System | File | Notes |
|---|---|---|
| Windows x64 | eglantine-windows-x86_64.zip |
Extract and run eglantine.exe. |
| Linux x86_64 / arm64 | eglantine-linux-*.AppImage |
Self-contained; needs glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch). chmod +x it, then run it. |
| Linux x86_64 / arm64 | eglantine-linux-*.tar.gz |
Uses your system's Qt 6 and libraries. |
eden-cli (the command-line frontend) ships next to eglantine in every package.
You need:
- A GPU with Vulkan 1.3 support and up-to-date drivers.
- Your own console's keys and firmware, dumped from your own hardware. Eglantine does not include them, and they can't be shared.
- Games you own, dumped from your own cartridges or eShop purchases.
The User Handbook covers setup, with a Quick Start, controllers, mods, saves and troubleshooting.
The mods folder has ready-made mods for some games. Its README lists them and shows how to install one.
See the General Build Guide. On Windows, tools/windows/build.ps1 builds with MSVC and needs no administrator rights. The other development tools are described in the tools directory.
Pull requests are welcome; open them against dev. Please keep changes focused and documented, and describe how you tested them. For development discussions, join the Discord.
Eglantine was started by Camille LaVey (Djihads80/Eglantine) and builds on the work of the Eden, yuzu and Sudachi projects and their contributors.
Eglantine is not affiliated with or endorsed by Nintendo. Use it only with games, keys and firmware you own and dumped yourself.
Eglantine is licensed under the GPLv3 (or any later version). See LICENSE.txt.