yuzu

yuzu

Developer(s)	Tropic Haze LLC yuzu Team
Last version	Mainline 1734 Early Access 4176 [+]
Fate	Discontinued (archived)
Platform(s)	Windows Linux Android macOS (experimental)
Architecture(s)	x86_64, ARM64
Emulates	Nintendo Switch
Compatibility	Compatibility list (archived)
Website	yuzu-emu.org (archived)
Programmed in	C++
License	GPLv3
Source code	GitHub (mirror)
BIOS/Keys	Required

For other software that emulates the Switch, see Nintendo Switch emulators.

yuzu is a discontinued open-source Nintendo Switch emulator and debugger written in C++. Prior to its discontinuation, it was the most popular Nintendo Switch emulator and had certain performance advantages over its main competitor, Ryujinx, but lower compatibility. It is no longer officially available for download, but archived downloads are available.

Download

We do not recommend using Yuzu anymore. Instead, we recommend using active forks of Yuzu.

	Early Access Builds (built by pinEApple) Patreon releases

	Latest Archived Builds

	Latest Archived Builds

System requirements

See Computer specifications#Yuzu and forks

History

yuzu reached in-game on several Nintendo Switch exclusives in November 2019,^[1] and has been improving in compatibility by the day with active developers ever since.

The Binding of Isaac: Afterbirth+, Puyo Puyo Tetris, and Cave Story+ were the first games to boot.^[2] In late April 2018, yuzu booted its first Switch exclusive, 1-2-Switch. Three months later, yuzu was able to run its first 3D rendered game, Minecraft: Story Mode.

This progress report from July 2018 details the extensive work required to research the Switch and get yuzu up and running, chronicling the compatibility status of a small bundle of games and apps over time. The post also covers a surprising number of similarities between the hardware and firmware of the 3DS and Switch, and why portions of Citra were reused in yuzu.

Yuzu started showing some 3D rendering on Super Mario Odyssey in early August 2018.^[3] This long-awaited exclusive brought a lot of interest in the project. The team covered all the changes that month in another progress report from September 2018.

In May 2020, multicore CPU emulation was implemented, improving framerates on many titles. This feature appears to cause audio slow down, so the developers recommend enabling audio stretching in order to mitigate it.^[4]

In July 2021, yuzu's shader decompiler was rewritten, allowing the generation of pipeline cache for Vulkan users and providing a considerable performance boost.

In October 2021, resolution scaling was added to the emulator that allowed it to render games up to 6x the original resolution or 0.5x on the low end. It also added AMD FidelityFX™ Super-Resolution as a window adaptation filter among others.^[5]

As of March 2022, an estimated half of the Nintendo Switch library can be played from start to finish, like Super Mario Odyssey, which had correct graphics and speed after 1 year of it getting to boot up.

On May 30, 2023, the emulator was ported to Android. This version was in early access, with a free and a paid version available.

Lawsuit

Nintendo sued Yuzu (TROPIC HAZE LLC) on February 26, 2024^[6]^[7], over copyright infringement. On March 4, 2024, Nintendo and Tropic Haze settled out of court, with US$2,400,000.00 in Nintendo's favor, along with an injunction preventing Yuzu's management from continuing development of Yuzu or assisting Citra with development.^[8] Distribution of Yuzu and Citra ceased after the lawsuit's conclusion,^[9] and a statement was put on the websites of both emulators and the official Discord. Also see Legal Status of Emulation.

[1]

Forks

Name	Latest version(s)	Hardware features	Enhancements	Compatibility	License	Active	Recommended
x86_64
Eden	0.2.1 nightly (unofficial) git	✓	~	?	GPLv3	✓	✓
Citron	2026.02.1 git	✓	~	85% 1275 out of 1500 reported titles	GPLv3	✓	✓
Sudachi	v1.0.15 v1.0.14 (Linux) v1.0.13 (macOS) git (releases)	✓	~	?	GPLv3	✗	~
Torzu	git (Dark Git) git mirror (NotABug)	✓	~	?	GPLv3	~	✗
Suyu	v0.0.3	✓	~	?	GPLv3	✗	✗
ARM64
Eden	0.2.1 git mirror (releases) git	?	~	?	GPLv3	✓	✓
Citron	2026.02.1 git	?	~	85% 1275 out of 1500 reported titles	GPLv3	✓	✓
Sudachi	v1.0.15 git (releases)	?	~	?	GPLv3	✗	~
Pomelo	Official Site git	?	~	63.97% 87 out of 136 reported titles	GPLv3	✗	~
Torzu	git (Dark Git) git mirror (NotABug)	?	~	?	GPLv3	~	✗
Suyu	v0.0.3	?	~	?	GPLv3	✗	✗

Eden: Newest fork in the scene, Eden, with people that previously worked on Citron and Sudachi. Most of the new features provided by Eden are aimed at Android drivers specific issues. [2][3].

Citron: A fork of yuzu, known as uzuy until October 2024. After a line of Nightly releases dating from November 2024 and a failed server migration that took the site down [4], Citron reappeared with a newer Canary pre-launch version on January 2025. Since the partial suspension of Sudachi development and the recent inactivity of torzu, this emulator was one the most active yuzu forks at the time.

After internal disagreements over the idea of adding DRM and telemetry to combat misuse of the emulator, and its creator Zephyron[5], developers from Citron have split off and created Eden.

Sudachi: Initially conceived by Jarrod Norwell as an experimental port of yuzu to iOS/iPadOS, the project was rebased on Yuzu's EA-4176 build following the yuzu takedown. Subsequently, the project evolved to include further improvement of the project and distributions for Linux and macOS. While it was once available on separate repositories for Windows and Android, DMCA takedowns led to the closure of both repositories and the associated Discord server[6][7] (see "2024 - Yuzu (Switch) vs. Nintendo" section of the Legal Status of Emulation page). The project is now distributed through its own hosting platform. Requires a paid Apple Developer Account or TrollStore to use the com.apple.developer.kernel.increased-memory-limit entitlement. In version 1.0.15, the gyroscope is not recognized, and all non-English languages are removed; therefore, it is recommended to use the previous version until these issues are resolved.

Sudachi is no longer in-development[8]

Pomelo: A fork of Sudachi maintained by Stossy11 focused on iOS/iPadOS support. Pomelo can be installed with SideStore, a paid developer account or TrollStore. This project has been archived and superseded by a Ryujinx-based emulator by the same developer: MeloNX.

Suyu: A fork (based on the latest EA-4176). Unlike its parent project, the Switch firmware is required (like older versions of yuzu) as well a title.keys file for eShop/nsp games, updates and DLCs (on yuzu, they were auto generated if missing). The repository was originally hosted on GitLab, but it was forced to move after GitLab took it down, citing the use of the raw yuzu code. It is hosted on a self-managed instance of Forgejo. This decision, along with various precautions[9], suggests a desire to avoid legal claims similar to those faced by yuzu. Later, the team tried to recruit programmers to start to study the code. Thus, there is an adaptation period needed to see some serious advancements, and in the meantime, in response to concerns about the project's financial motivations, the suyu team emphasized a strict policy against accepting donations; they assure users that there is no intention to profit from the emulator. But there have been inexperienced coding criticisms from some in the community directed at the developers' work. Their discord server was shut down (see "2024 - Yuzu (Switch) vs. Nintendo" section of the Legal Status of Emulation page)

Messages from suyu developers about leaving the project: kksowo's message on Paste.bin, The Death of Suyu by u/AMA2581 on r/suyu. After this, however, the founder of the project states that they will still try to maintain the project as much as they can. Their Discord server is shut (see "2024 - Yuzu (Switch) vs. Nintendo" section of the Legal Status of Emulation page), and with the announcement in February 13, 2025, the project could be considered ceased and dead.

torzu: A fork of yuzu. To prevent take-downs, the main git repository is hosted using the Tor network. It has a mirror on NotaBug, torzu still aims to remain "compilable on Linux and Windows" and serve as a "good base to fork" in the future. torzu doesn't publish official releases or offer official support.