View source for Yuzu

{{Lowercase title}}

{{Infobox emulator
|title         = yuzu
|logo          = Yuzu_Icon.png
|logowidth     = 100
|developer     = Tropic Haze LLC<br/>yuzu Team
|last-version  = {{Version|Yuzu}}
|fate          = [https://web.archive.org/web/20240312071432if_/https://yuzu-emu.org/ Discontinued] <small>(archived)</small>
|platform      = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on Android|Android]]<br/>[[Emulators on macOS|macOS]] <small>(experimental)</small>
|architecture  = x86_64, ARM64
|target        = [[Nintendo Switch emulators|Nintendo Switch]]
|compatibility = [https://web.archive.org/web/20240304185123if_/https://yuzu-emu.org/game/ Compatibility list] <small>(archived)</small>
|website       = [https://web.archive.org/web/20240304212345if_/https://yuzu-emu.org/ yuzu-emu.org] <small>(archived)</small>
|prog-lang     = {{Proglang|C++}}
|license       = {{license|GPLv3}}
|source        = [https://github.com/yuzu-emu-mirror/yuzu GitHub] <small>(mirror)</small>
|bios          = [[Emulator_Files#Nintendo_Switch|Required]]
}}

{{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]].

{| 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]''
|}

==System requirements==
See [[Computer specifications#Yuzu and forks]]

==History==
yuzu reached in-game on several Nintendo Switch exclusives in November 2019,<ref>[https://twitter.com/yuzuemu/status/1195079948635164679 Pokémon Sword and Shield go in-game] (November 14, 2019)</ref> 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.<ref>{{cite web|title=First games are running!|url=https://yuzu-emu.org/entry/first-games-are-running/|author=JMC47|date=April 15, 2018|accessdate=April 16, 2018}}</ref> In late [https://t.co/2ctw1wBN3S April 2018], yuzu booted its first Switch exclusive, ''1-2-Switch''. [https://t.co/8FY1zFoM7X Three months later], yuzu was able to run its first 3D rendered game, ''Minecraft: Story Mode''.

[https://yuzu-emu.org/entry/yuzu-progress-report-2018-p1/ 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 [[Nintendo_3DS_emulators|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.<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>{{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 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.

===Lawsuit===
[https://en.wikipedia.org/wiki/Nintendo Nintendo] sued Yuzu (TROPIC HAZE LLC) on February 26, 2024<ref>[https://web.archive.org/web/20240304182910/https://www.courtlistener.com/docket/68284505/nintendo-of-america-inc-v-tropic-haze-llc/ Nintendo of America Inc. v. Tropic Haze LLC (1:24-cv-00082) <i>On CourtListener.com</i>]</ref><ref>[https://web.archive.org/web/20240229213811if_/https://storage.courtlistener.com/recap/gov.uscourts.rid.56980/gov.uscourts.rid.56980.1.0.pdf Case 1:24-cv-00082-JJM-LDA Document 1 (February 26, 2024)]</ref>, 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.<ref>[https://web.archive.org/web/20240304174726if_/https://storage.courtlistener.com/recap/gov.uscourts.rid.56980/gov.uscourts.rid.56980.10.0.pdf Case 1:24-cv-00082-JJM-LDA Document 10 (Mars 04, 2024)]</ref> Distribution of Yuzu and Citra ceased after the lawsuit's conclusion,<ref>[https://web.archive.org/web/20240304175212/https://storage.courtlistener.com/recap/gov.uscourts.rid.56980/gov.uscourts.rid.56980.10.1.pdf Case 1:24-cv-00082-JJM-LDA Document 10-1 (Mars 04, 2024)]</ref> and a statement was put on the websites of both emulators and the official Discord. Also see [[Legal Status of Emulation]].

[https://old.reddit.com/r/emulation/comments/1b6juv9/yuzu_and_yuzus_support_of_citra_are_being/]

==Forks==
<div style="overflow-x:auto;width:100%">
{|class="wikitable" style="text-align:center;line-height:1.5;width:74%;font-size:90%;"
|+Before editing, review the [[Getting involved]] and [[Recommended emulators|Recommended]] pages. See [[Computer_specifications#Recommended_Specifications|system requirements]] page for performance demand of the emulators.<br/>See tables for <span style="font-weight: bold; color: #CC0000; border: 1px solid #CC0000; padding: 2px;">[[Nintendo_Switch_emulators#Enhancements|enhancements]], [[Nintendo_Switch_emulators#Hardware_features_and_peripherals|hardware features and peripherals]].</span><br/>For more details such as [[licensing]], [[Source_code#Language_levels|programming language]], [[High_and_low-level_emulation|emulation method]], visit each emulator’s dedicated page.
|-style="font-weight:bold;"
!Name
!Platform(s)
!Latest version(s)
!Compatibility
![[Licensing|License]]
!Active
![[Recommended Emulators|Recommended]]
|-style="font-weight:bold;"
!colspan="10" | x86_64
|-
|Eden
|align=left|{{Icon|Windows|Linux|FreeBSD|Solaris|OpenBSD|Haiku|NetBSD}}
|[https://github.com/eden-emulator/Releases/releases {{EdenVer}}]<br/>[https://github.com/pflyly/eden-nightly/releases nightly (unofficial)]<br/>[https://git.eden-emu.dev/eden-emu/eden git]<br/>[https://github.com/Eden-CI/PR/releases as-is builds]
|?
|{{Green}} {{License|GPLv3}}
|{{✓}}
|{{✓}}
|-
|Citron
|align=left|{{Icon|Windows|Linux}}
|[https://git.citron-emu.org/citron/emulator/releases {{CitronVer}}]<br/>[https://git.citron-emu.org/citron/emulator git]
|{{Emulator compatibility|link=https://citron-emu.org/|1275|1500}}
|{{Green}} {{License|GPLv3}}
|{{✓}}
|{{✓}}
|-
|Sudachi
|align=left|{{Icon|Windows|Linux|macOS}}
|[https://github.com/emuplace/sudachi.emuplace.app/releases/tag/v1.0.15 {{SudachiVer}}]<br/>[https://github.com/emuplace/sudachi.emuplace.app/releases/tag/v1.0.14 v1.0.14] (Linux)<br/>[https://github.com/emuplace/sudachi.emuplace.app/releases/tag/v1.0.13 v1.0.13] (macOS)<br/>[https://github.com/emuplace/sudachi.emuplace.app/releases git] <small>(releases)</small>
|?
|{{Green}} {{License|GPLv3}}
|{{n}}
|{{~}}
|-
|Torzu
|align=left|{{Icon|Win|Linux|macOS}}
|[http://vub63vv26q6v27xzv2dtcd25xumubshogm67yrpaz2rculqxs7jlfqad.onion/torzu-emu/torzu git] (Dark Git)<br/>[https://notabug.org/litucks/torzu git mirror] (NotABug)
|?
|{{Green}} {{License|GPLv3}}
|{{~}}
|{{n}}
|-
|Suyu
|align=left|{{Icon|Win|Linux|macOS}}
|[https://git.suyu.dev/suyu/suyu/releases v0.0.3]
|?
|{{Green}} {{License|GPLv3}}
|{{n}}
|{{n}}
|-style="font-weight:bold;"
!colspan="10" | ARM64
|-
|Eden
|align=left|{{Icon|Windows|Android|LinuxARM}}
|[https://github.com/eden-emulator/Releases/releases/tag/v0.0.4-rc1 {{EdenVer}}]<br/>[https://github.com/eden-emulator/Releases/releases git mirror] <small>(releases)</small><br/>[https://git.eden-emu.dev/eden-emu/eden git]
|?
|{{Green}} {{License|GPLv3}}
|{{✓}}
|{{✓}}
|-
|Citron
|align=left|{{Icon|Windows|Android|LinuxARM}}
|[https://git.citron-emu.org/citron/emu/-/releases {{CitronVer}}]<br/>[https://git.citron-emu.org/citron/emu git]
|{{Emulator compatibility|link=https://citron-emu.org/|1275|1500}}
|{{Green}} {{License|GPLv3}}
|{{✓}}
|{{✓}}
|-
|Sudachi
|align=left|{{Icon|Android}}
|[https://github.com/emuplace/sudachi.emuplace.app/releases/tag/v1.0.15 {{SudachiVer}}]<br/>[https://github.com/emuplace/sudachi.emuplace.app/releases git] <small>(releases)</small>
|?
|{{Green}} {{License|GPLv3}}
|{{n}}
|{{~}}
|-
|Pomelo
|align=left|{{Icon|iOS}}
|[https://pomelo-emu.github.io/downloads.html Official Site]<br/>[https://gitlab.com/Pomelo-Emu/Pomelo git]
|{{Emulator compatibility|link=https://pomelo-emu.github.io/titles.html/|87|136}}
|{{Green}} {{License|GPLv3}}
|{{n}}
|{{~}}
|-
|Torzu
|align=left|{{Icon|Android}}
|[http://vub63vv26q6v27xzv2dtcd25xumubshogm67yrpaz2rculqxs7jlfqad.onion/torzu-emu/torzu git] (Dark Git)<br/>[https://notabug.org/litucks/torzu git mirror] (NotABug)
|?
|{{Green}} {{License|GPLv3}}
|{{~}}
|{{n}}
|-
|Suyu
|align=left|{{Icon|Android}}
|[https://git.suyu.dev/suyu/suyu/releases v0.0.3]
|?
|{{Green}} {{License|GPLv3}}
|{{n}}
|{{n}}
|}
</div>

;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. [https://old.reddit.com/r/yuzu/comments/1kgzpya/about_eden_current_state/][https://old.reddit.com/r/emulation/comments/1kjk61u/eden_nintendo_switch_emulator/].

;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.

: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.

;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.

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

:;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].

;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)

: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.

;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 ==
<references />

== External links ==
* [https://web.archive.org/web/20240304212345if_/https://yuzu-emu.org/ Official Website] <small>(archived)</small>
:- [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)]
:- [https://web.archive.org/web/20240304185123if_/https://yuzu-emu.org/game/ Game Compatibility List]
:- [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)]
:- [https://web.archive.org/web/20240304194040if_/https://yuzu-emu.org/help/ Help]
* [https://yuzu-mirror.github.io/ Unofficial Mirror] (yuzu-mirror.github.io)

[[Category:Emulators]]
[[Category:Console emulators]]
[[Category:Hybrid console emulators]]
[[Category:Handheld console emulators]]
[[Category:Home console emulators]]
[[Category:Nintendo Switch emulators]]
[[Category:Windows emulation software]]
[[Category:Linux emulation software]]
[[Category:Android emulation software]]
[[Category:Inactive emulation software]]