Yuzu: Difference between revisions

From Emulation General Wiki
Jump to navigation Jump to search
← Older edit
R-K (talk | contribs)
1,946 edits
VisualWikitext
Ahayri (talk | contribs)
24,008 edits
R-K (talk | contribs)
1,946 edits
 
(177 intermediate revisions by 91 users not shown)
Line 1: Line 1:
{{lowercase title}}
{{Lowercase title}}
 
{{Infobox emulator
{{Infobox emulator
|title = yuzu
|title         = yuzu
|logo = Yuzu_Icon.png
|logo         = Yuzu_Icon.png
|logowidth = 150
|logowidth     = 100
|active = No
|developer    = Tropic Haze LLC<br/>yuzu Team
|version = {{Version|Yuzu}}
|last-version = {{Version|Yuzu}}
|platform = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on Android|Android]]
|fate          = [https://web.archive.org/web/20240312071432if_/https://yuzu-emu.org/ Discontinued] <small>(archived)</small>
|target = [[Nintendo Switch emulators|Nintendo Switch]]
|platform     = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on Android|Android]]<br/>[[Emulators on macOS|macOS]] <small>(experimental)</small>
|developer = [https://web.archive.org/web/20240229075750/https://github.com/yuzu-emu/yuzu/graphs/contributors yuzu Team]
|architecture  = x86_64, ARM64
|prog-lang = {{Proglang|C++}}
|target       = [[Nintendo Switch emulators|Nintendo Switch]]
|website = [https://web.archive.org/web/20240304195558/https://yuzu-emu.org/ yuzu-emu.org]
|compatibility = [https://web.archive.org/web/20240304185123if_/https://yuzu-emu.org/game/ Compatibility list] <small>(archived)</small>
|source = [https://web.archive.org/web/20240302235550/https://github.com/yuzu-emu/yuzu-mainline/ GitHub]
|website       = [https://web.archive.org/web/20240304212345if_/https://yuzu-emu.org/ yuzu-emu.org] <small>(archived)</small>
|license = {{license|GPLv2}}
|prog-lang    = {{Proglang|C++}}
|compatibility = [http://web.archive.org/web/20240130155829/https://yuzu-emu.org/game/ Official List]
|license      = {{license|GPLv3}}
|bios = [[Emulator_Files#Nintendo_Switch|Required]]
|source       = [https://github.com/yuzu-emu-mirror/yuzu GitHub] <small>(mirror)</small>
|support = [https://patreon.com/yuzuteam Patreon]
|bios         = [[Emulator_Files#Nintendo_Switch|Required]]
}}
}}


'''yuzu''' is a discontinued open-source [[Nintendo Switch emulators|Nintendo Switch]] emulator and debugger written in C++. Prior to its discontinuation, it was the most popular Nintendo Switch emulator and was easier to set up {{why?}} than its main competitor, [[Ryujinx]]. It is no longer officially available for download, but archived downloads are available.
{{for|other software that emulates the Switch|Nintendo Switch emulators}}
 
'''yuzu''' is a discontinued open-source [[Nintendo Switch emulators|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 [[#Forks|active forks of Yuzu]].


==Archived Downloads==
Placeholder text
{| cellpadding="4"
|-
|align=center|{{Icon|Win|Lin}}
|'''[https://web.archive.org/web/20240412002255/https://github.com/pineappleEA/pineapple-src/releases Early Access Builds (built by pinEApple)]'''<br><small>Patreon releases</small>
|-
|colspan="3"|<hr/>
|-
|align=center|{{Icon|Win|Lin}}
|[https://web.archive.org/web/20240304181906/https://yuzu-emu.org/downloads/ Latest Archived Builds]
|-
|colspan="3"|<hr/>
|-
|align=center|{{Icon|Android}}
|[https://web.archive.org/web/20240304181906/https://yuzu-emu.org/downloads/#android Latest Archived Builds]
|}


==Overview==
==System requirements==
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.
See [[Computer specifications#Yuzu and forks]]


==History==
==History==
Line 48: Line 41:
Yuzu started showing some 3D rendering on ''Super Mario Odyssey'' in early August 2018.<ref>[https://twitter.com/yuzuemu/status/1027066281441341440 First 3D Graphics] (August 8, 2018)</ref> This long-awaited exclusive brought a lot of interest in the project. The team covered all the changes that month in [https://yuzu-emu.org/entry/yuzu-progress-report-2018-p3/ another progress report] from September 2018.
Yuzu started showing some 3D rendering on ''Super Mario Odyssey'' in early August 2018.<ref>[https://twitter.com/yuzuemu/status/1027066281441341440 First 3D Graphics] (August 8, 2018)</ref> This long-awaited exclusive brought a lot of interest in the project. The team covered all the changes that month in [https://yuzu-emu.org/entry/yuzu-progress-report-2018-p3/ 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.<ref>[https://www.youtube.com/watch?v=rbNd67vIO78 Yuzu Multicore Released | This Update is INSANELY FAST (May 11, 2020)]</ref>
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.<ref>{{YouTubeVideo|rbNd67vIO78 |Yuzu Multicore Released | This Update is INSANELY FAST}}</ref>


In July 2021, yuzu's [[Shader caches|shader ]] decompiler was rewritten, allowing the generation of pipeline cache for Vulkan users and providing a considerable performance boost.
In July 2021, yuzu's [[Shader caches|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.<ref>[https://yuzu-emu.org/entry/yuzu-art/ New Feature Release - Resolution Scaler (October 24, 2021)]</ref>
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.<ref>[https://yuzu-emu.org/entry/yuzu-art/ New Feature Release - Resolution Scaler (October 24, 2021)]</ref>
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.
On May 30, 2023, the emulator was ported to Android. This version was in early access, with a free and a paid version available.
Line 61: Line 56:
[https://old.reddit.com/r/emulation/comments/1b6juv9/yuzu_and_yuzus_support_of_citra_are_being/]
[https://old.reddit.com/r/emulation/comments/1b6juv9/yuzu_and_yuzus_support_of_citra_are_being/]


==External links==
*[http://web.archive.org/web/20240130155829/https://yuzu-emu.org/game/ Official compatibility list] (archived)
*[http://web.archive.org/web/20240130155829/https://yuzu-emu.org/ Official website] (archived)
*[https://twitter.com/yuzuemu Twitter news feed] (abandoned due to the lawsuit)
*[http://web.archive.org/web/20240130155829/https://yuzu-emu.org/Donate Donation email link] (archived), (No longer avaliable to donate due to the lawsuit)
==Forks==
==Forks==
{{for|more information about other Switch emulators|Nintendo Switch emulators#Comparisons}}
{{for|more information about other Switch emulators|Nintendo Switch emulators#Comparisons}}


===Citron===
{{Infobox emulator
|title        = Citron Neo
|logo          = Citron Neo.svg
|logowidth    = 128
|developer    = Citron Neo Team
|version      = {{Version|CitronNeo}}
|active        = Yes
|platform      = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on Android|Android]]<br/>[[Emulators on BSD|FreeBSD]]
|architecture  = x86_64, ARM64
|target        = [[Nintendo Switch emulators|Nintendo Switch]]
|compatibility = High (Inherits yuzu compatibility)
|accuracy      =
|website      = [https://citron-neo.org/ citron-neo.org]
|prog-lang    = {{Proglang|C++}}
|support      =
|license      = {{license|GPLv3}}
|source        = [https://github.com/citron-neo/emulator GitHub]
|bios          = [[Emulator_Files#Nintendo_Switch|Required]]
}}


'''Citron''' is 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 [https://www.reddit.com/media?url=https%3A%2F%2Fpreview.redd.it%2Fhas-citron-been-taken-down-v0-uxtrqvqkt19e1.jpeg%3Fwidth%3D1179%26format%3Dpjpg%26auto%3Dwebp%26s%3D0d7ea6999148d1ca858d9f6fc05695fe20dcc3c2], 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 is one the most active yuzu fork to date.
{{Infobox emulator
|title        = Eden
|logo          = Eden.png
|logowidth    = 128
|developer    = [https://eden-emu.dev/team Eden Team]
|version      = {{Version|Eden}}
|active        = Yes
|platform      = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on macOS|macOS]]<br/>[[Emulators on Android|Android]]<br/>[[Raspberry Pi|Raspberry Pi]]<br/>OpenBSD<br/>Haiku<br/>NetBSD<br/>Solaris<br/>FreeBSD<br>DragonFlyBSD<br/>MidnightBSD
|architecture  = x86_64, ARM64
|target        = [[Nintendo Switch emulators|Nintendo Switch]]
|compatibility = High (Inherits yuzu compatibility)
|accuracy      =
|website      = [https://eden-emu.dev/ eden-emu.dev]
|prog-lang    = {{Proglang|C++}}
|support      = https://liberapay.com/crueter
|license      = {{license|GPLv3}}
|source        = [https://git.eden-emu.dev/eden-emu/eden git.eden-emu.dev]
|bios          = [[Emulator_Files#Nintendo_Switch|Required]]
}}


{| cellpadding="4"
;Eden: A recent fork created by people that previously worked on Citron and Sudachi. Most of the new features provided by Eden are aimed at Android drivers specific issues. [https://old.reddit.com/r/yuzu/comments/1kgzpya/about_eden_current_state/][https://old.reddit.com/r/emulation/comments/1kjk61u/eden_nintendo_switch_emulator/].
|-
|align=center|{{Icon|Windows|Linux}} (x86)<br/>{{Icon|Android}} (ARM)
|[https://git.citron-emu.org/Citron/Citron/releases {{CitronVer}}]
|}


----
;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 [https://www.reddit.com/media?url=https%3A%2F%2Fpreview.redd.it%2Fhas-citron-been-taken-down-v0-uxtrqvqkt19e1.jpeg%3Fwidth%3D1179%26format%3Dpjpg%26auto%3Dwebp%26s%3D0d7ea6999148d1ca858d9f6fc05695fe20dcc3c2], 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.


===Pomelo===
:After internal disagreements over the idea of adding DRM and telemetry to combat misuse of the emulator, and its creator Zephyron[https://old.reddit.com/r/EmulationOnAndroid/comments/1jnpo71/the_fall_of_citron/], developers from Citron have split off and created Eden.
A fork of Sudachi maintained by Stossy11 focused on iOS/iPadOS support. Pomelo can be installed with [https://sidestore.io SideStore], a paid developer account or TrollStore.
:;Citron Neo: A reincarnation of yuzu stripped down to bare minimal requirements. Developed as a continuation after the original Citron emulator, Citron Neo focuses exclusively on the Vulkan API and incorporates a newly improved Dynarmic-GPLv3 CPU backend for significantly increased performance and decreased latency. It maintains support for Windows, Linux, Android, and FreeBSD.


{| cellpadding="4"
;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[https://old.reddit.com/r/EmulationOniOS/comments/1db1qwl/sudachi_has_been_takedown/][https://x.com/antique_codes/status/1809288541064819064] (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 <code>com.apple.developer.kernel.increased-memory-limit</code> 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.
|-
|align=center|{{Icon|iOS}}
|'''[https://pomelo-emu.github.io/downloads.html Official Site]'''
|'''[https://gitlab.com/Pomelo-Emu/Pomelo git]'''
|}
;External links
*Compatibility list: [https://pomelo-emu.github.io/titles.html 64% <small>87 out of 136 reported titles</small>]


----
:Sudachi is no longer in-development[https://sudachi.emuplace.app/]


===Sudachi===
:;Pomelo: A fork of Sudachi maintained by Stossy11 focused on iOS/iPadOS support. Pomelo can be installed with [https://sidestore.io SideStore], a paid developer account or TrollStore. This project has been archived and superseded by a Ryujinx-based emulator by the same developer: [https://melonx.org/ MeloNX].
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[https://old.reddit.com/r/EmulationOniOS/comments/1db1qwl/sudachi_has_been_takedown/][https://x.com/antique_codes/status/1809288541064819064] (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 <code>com.apple.developer.kernel.increased-memory-limit</code> entitlement. Sudachi is widely considered {{who}} to be the most mature and actively developed yuzu fork available. The iOS version of Sudachi has been neglected for some time due to the developer's focus on another emulator, so there is a fork called "Pomelo", so for those platforms using "Pomelo" is recommended instead of using Sudachi.


Sudachi is nearing its end, according to a tweet from project developer Jarrod Norwell. He stated, "Nintendo Switch emulation and most of the community surrounding it are making it a very unsafe and unpleasant environment. Between the various forks that exist providing no benefits, the accusations, the immature and predatory nature of a lot of "leaders" it just is not worth hanging around it anymore."[https://x.com/antique_codes/status/1845758124298481883/photo/2]
;Suyu: A fork ([https://git.suyu.dev/suyu/suyu 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[https://old.reddit.com/r/emulation/comments/1bck011/heres_how_the_makers_of_the_suyu_switch_emulator/], suggests a desire to avoid [[Legal_Status_of_Emulation#Nintendo|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)
Still, the emulator is being ocasionally updated though.


{| cellpadding="4"
:Messages from suyu developers about leaving the project: [https://pastebin.com/6FYdz9Sr kksowo's message on Paste.bin], [https://old.reddit.com/r/suyu/comments/1c1hs3l/the_death_of_suyu/ The Death of Suyu by u/AMA2581 on r/suyu]. After this, however, the founder of the project states that [https://old.reddit.com/r/suyu/comments/1c1tnh5/founder_speaking_future/ 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 [https://chat.suyu.dev/channel/announcements?msg=0czPGU0xnVBMkM1II announcement in February 13, 2025], the project could be considered ceased and dead.
|-
|align=center|{{Icon|Windows|Linux|Android}}
|'''[https://sudachi.emuplace.app/ {{SudachiVer}}]'''
|-
|colspan="3"|<hr/>
|-
|align=center|{{Icon|iOS}}
|[https://sudachi.emuplace.app/ 1.0.2] (ipa)‡
|}


----
:In September 2026, original developer Crimson-Hawk released [https://github.com/suyu-emu/suyu-v0.0.4/releases/tag/v0.04-latest version 0.0.4 "Final Edition"] as a final wrap-up build featuring Qlauncher menu support and a Libretro core, officially archiving the project.


===Suyu===
;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.
{{lowercase title}}
{{Infobox emulator
|title = suyu
|logo = Suyu_Icon.png
|logowidth = 100
|screenshot    = Suyu 0.0.2 screenshot.png
|version = {{Version|Suyu}}
|active = Somewhat
|platform = [[Emulators on Windows|Windows]]<br>[[Emulators on Linux|Linux]]<br>[[Emulators on Android|Android]]<br>[[Emulators on macOS|macOS]]
|target = [[Nintendo Switch emulators|Nintendo Switch]]
|developer = suyu team
|architecture  = x86_64, ARM64
|prog-lang = {{Proglang|C++}}
|license = {{License|GPLv3}}
|source = [https://git.suyu.dev/ suyu.dev]
|website        = [https://git.suyu.dev/suyu/suyu suyu.dev]
|bios = [[Emulator_Files#Nintendo_Switch|Required]]
}}


'''suyu''' is a fork of yuzu from where that project left off ([https://git.suyu.dev/suyu/suyu based on the latest EA-4176]).
== References ==
 
<references />
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[https://old.reddit.com/r/emulation/comments/1bck011/heres_how_the_makers_of_the_suyu_switch_emulator/], suggests a desire to avoid [[Legal_Status_of_Emulation#Nintendo|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: [https://pastebin.com/6FYdz9Sr kksowo's message on Paste.bin], [https://old.reddit.com/r/suyu/comments/1c1hs3l/the_death_of_suyu/ The Death of Suyu by u/AMA2581 on r/suyu]. After this, however, the founder of the project states that [https://old.reddit.com/r/suyu/comments/1c1tnh5/founder_speaking_future/ 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 the project could be considered dead.
== External links ==
* [https://web.archive.org/web/20240304212345if_/https://yuzu-emu.org/ Official Website] <small>(archived)</small>
{| cellpadding="4"
:- [https://web.archive.org/web/20240304183035if_/https://yuzu-emu.org/entry/ Blog/entries]
|-
:- [https://web.archive.org/web/20240304201438if_/https://yuzu-emu.org/wiki/faq/ FAQ(s)]
|align=center|{{Icon|Win|Linux|macOS|Android}}
:- [https://web.archive.org/web/20240304185123if_/https://yuzu-emu.org/game/ Game Compatibility List]
|'''[https://git.suyu.dev/suyu/suyu/releases Releases]'''
:- [https://web.archive.org/web/20240304181617if_/https://yuzu-emu.org/screenshots/ Screenshots]
|}
:- [https://web.archive.org/web/20240304211120if_/https://yuzu-emu.org/wiki/ Wiki(s)]
;External links
:- [https://web.archive.org/web/20240304194040if_/https://yuzu-emu.org/help/ Help]
* [https://suyu.dev/ Official website]
* [https://yuzu-mirror.github.io/ Unofficial Mirror] (yuzu-mirror.github.io)
* [https://git.suyu.dev/ Repository]
* [https://chat.suyu.dev/ Chat Platform]
 
----
 
===torzu===
'''torzu''' is a fork of yuzu. To prevent take-downs, the Git is preliminarily hosted using the Tor network, needing the Tor browser to access. Currently, it has a mirror on NotaBug, but this may be taken down without notice. 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.
 
{| cellpadding="4"
|-
|align=center|{{Icon|Win|Linux|macOS|Android}}
|'''[http://vub63vv26q6v27xzv2dtcd25xumubshogm67yrpaz2rculqxs7jlfqad.onion/torzu-emu/torzu git] (Dark Git)'''
|'''[https://notabug.org/litucks/torzu git mirror] (NotABug)'''‡
|'''[https://free-git.org/Emulator-Archive/torzu git mirror] (free-git.org)
|}
 
==System requirements==
See [[Computer specifications#Yuzu and forks]]
 
==References==
<references />


[[Category:Emulators]]
[[Category:Emulators]]
Line 181: Line 143:
[[Category:Android emulation software]]
[[Category:Android emulation software]]
[[Category:Inactive emulation software]]
[[Category:Inactive emulation software]]
{{#seo:
|keywords=video games,emulation,emulator,emu,wiki,guide,list,download,yuzu,fork
|description=An overview Ryujinx with recommendations and downloads for active yuzu forks.
|published_time={{#time:c|{{REVISIONTIMESTAMP}}}}
}}

Latest revision as of 18:54, 10 September 2026

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)
Support ($) Patreon
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.

Placeholder text

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

For more information about other Switch emulators, see Nintendo Switch emulators#Comparisons.
Citron Neo
Developer(s) Citron Neo Team
Latest version 2026-04-27 [+]
Active Yes
Platform(s) Windows
Linux
Android
FreeBSD
Architecture(s) x86_64, ARM64
Emulates Nintendo Switch
Compatibility High (Inherits yuzu compatibility)
Website citron-neo.org
Programmed in C++
License GPLv3
Source code GitHub
BIOS/Keys Required
Eden
Developer(s) Eden Team
Latest version 0.2.1 [+]
Active Yes
Platform(s) Windows
Linux
macOS
Android
Raspberry Pi
OpenBSD
Haiku
NetBSD
Solaris
FreeBSD
DragonFlyBSD
MidnightBSD
Architecture(s) x86_64, ARM64
Emulates Nintendo Switch
Compatibility High (Inherits yuzu compatibility)
Website eden-emu.dev
Support ($) https://liberapay.com/crueter
Programmed in C++
License GPLv3
Source code git.eden-emu.dev
BIOS/Keys Required
Eden
A recent fork created by 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.
Citron Neo
A reincarnation of yuzu stripped down to bare minimal requirements. Developed as a continuation after the original Citron emulator, Citron Neo focuses exclusively on the Vulkan API and incorporates a newly improved Dynarmic-GPLv3 CPU backend for significantly increased performance and decreased latency. It maintains support for Windows, Linux, Android, and FreeBSD.
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.
In September 2026, original developer Crimson-Hawk released version 0.0.4 "Final Edition" as a final wrap-up build featuring Qlauncher menu support and a Libretro core, officially archiving the project.
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.

References

  1. ↑ Pokémon Sword and Shield go in-game (November 14, 2019)
  2. ↑ JMC47 (April 15, 2018). First games are running!
  3. ↑ First 3D Graphics (August 8, 2018)
  4. ↑ Yuzu Multicore Released
  5. ↑ New Feature Release - Resolution Scaler (October 24, 2021)
  6. ↑ Nintendo of America Inc. v. Tropic Haze LLC (1:24-cv-00082) On CourtListener.com
  7. ↑ Case 1:24-cv-00082-JJM-LDA Document 1 (February 26, 2024)
  8. ↑ Case 1:24-cv-00082-JJM-LDA Document 10 (Mars 04, 2024)
  9. ↑ Case 1:24-cv-00082-JJM-LDA Document 10-1 (Mars 04, 2024)
- Blog/entries
- FAQ(s)
- Game Compatibility List
- Screenshots
- Wiki(s)
- Help


Retrieved from "https://emulation.gametechwiki.com/index.php?title=Yuzu&oldid=149933"