A fork of Eglantine (by Djihads80), itself based on Eden, itself based on yuzu.
Chungus Emulation is an experimental, free and open-source Nintendo Switch 2 emulator (GPL-3.0-or-later), developed and tested on Linux.
Legal notice: for educational and research purposes only. This project exists to study console architecture and emulation techniques. It does not include or provide any games, keys, firmware or other Nintendo files, and it does not help anyone obtain them. Use it only with games and keys dumped from a console you own. Piracy is illegal and is not supported here. Chungus Emulation is not affiliated with, endorsed by or sponsored by Nintendo.
- Fix: objects drawn from indirect-draw arguments the GPU writes itself no longer disappear. Before each draw, a stale copy from guest memory overwrote the arguments the GPU had just computed. The fix is on by default and costs nothing.
- Faster "Maximum" mode (experimental):
- multi-draw command lists that the GPU builds itself are issued as a single indirect draw with a count, instead of being read back by the emulator;
- constant-buffer uploads only refresh the buffer cache before each draw.
- A legal notice in this README and in the About dialog.
The details are in CHANGELOG.md.
-
Two speed presets, explained by a dialog at first launch:
- Recommended: safe settings that keep the image identical;
- Maximum (experimental): the GPU draws more of what it computed itself. Faster, but some objects may look distorted and, rarely, a game may freeze.
Both can be changed later in Emulation > Configure > Graphics > Advanced.
-
GPU-sized compute dispatches: when the GPU writes a dispatch's grid size itself, the dispatch is launched indirectly by the GPU instead of being read back.
-
Frame-rate-independent game speed for a title whose game speed is tied to its frame rate (based on ZendNevs' DynamicFPS mod), plus a steady 30 fps mode.
Most testing so far has been done with Mario Kart World and Splatoon Raiders on Linux, with an NVIDIA RTX 3070 (8 GB) and an Intel i5-11400F. Other games and hardware have barely been tested. Graphics cards with 8 GB of video memory are a tight fit for some games.
- The keys and firmware of your own console, and games dumped from your own console. None of these are provided.
- A recent Vulkan graphics card.
- Linux: download the AppImage from the release page, make it executable (
chmod +x) and run it. - Windows: there is no build yet. To build it yourself, see dist/windows/README-WINDOWS.md (untested).
All the groundwork comes from the projects Chungus Emulation derives from. Thanks to:
- Eglantine (Djihads80 and contributors): Switch 2 emulation (NVN2, nx2 services, and more);
- Eden and yuzu: the emulator's foundation;
- PokeDinner (an Eglantine fork): reading back GPU-written macro parameters;
- ZendNevs: the variable frame-rate mode (Eglantine-MKW-DynamicFPS);
- the authors of the Eglantine pull requests included here.
GPL-3.0-or-later, like Eden: see LICENSE.txt. Some parts use other free licenses: see the LICENSES folder and the SPDX headers of each file.
Nintendo Switch, Nintendo Switch 2, Mario Kart and Splatoon are trademarks of Nintendo.