The below wiki article is based on user submitted content. Please verify all hyperlinks and terminal commands below!
See a mistake? Want to contribute? Edit this article on Github
If you are unable to find the answer to your question, please join our Discord server for support: Discord Server
Current versions of yuzu require the latest versions of Microsoft Visual C++. Please download and install the following dependency:
Go to Visual Studio 2015, 2017 and 2019, and select the link next to x64.
You are legally required to dump your games from your Nintendo Switch. To do so, please follow our in-depth Quickstart Guide.
yuzu requires console keys to play your games. Please follow our Quickstart Guide to dump these keys and system files from your Nintendo Switch.
These console keys (prod.keys/title.keys) need to be placed in the following directories:
You may need to create the following "keys" folder:
NOTE: This yuzu directory can be quickly accessed by selecting file/open yuzu folder within the emulator
This problem is usually caused by a false positive of your antivirus software, most commonly by Avast and AVG. These applications will often incorrectly detect yuzu as malicious software and delete the executable as a result.
You can confirm it is a false positive with an online scanner, such as VirusTotal if you wish.
To fix this, you’ll need to either disable or uninstall your antivirus software. Make sure to reboot if you choose to uninstall it.
Afterwards, follow the instructions below for
yuzu will not update further or starts with a Qt platform error to delete any residual files of the failed installation.
%localappdata%and press Enter.
yuzufolder and delete it. If it is being used by another process, please double-check that you do not have any yuzu related applications running.
You are likely experiencing Shader Caching. Shaders are small programs running on a graphic card, responsible for rendering graphics like terrain, explosions, characters, etc. Since a PC cannot directly execute switch shaders, It first has to translate them to a format a PC can understand. This translation process is time-consuming and you’ll notice it in two ways:
While playing, if yuzu needs to translate a new shader, the game will stutter. Loading into a game for the first time can give long freezes due to the number of shaders. As you keep playing, the amount of stuttering will decrease.
When launching a game, the shader cache is loaded. To speed up this process there exists an additional "precompiled" cache. This cache may get reset every time you update yuzu or install a new GPU driver. The precompiled cache will then be compiled from scratch, causing a longer load time.
Currently, the Vulkan renderer does not have a disk shader cache. This means that subsequent game loads will require the building of shaders each time.
IMPORTANT: Since the cache stores parts of the game, we don't condone sharing or downloading these, since it is considered piracy
For a list of useful mods for your favorite games, check our database with Switch Mods
To add mods to a specific game, simply right click the game in yuzu’s games list, select
Open Mod Data Location and structure your mod files similar to this example:
Mod directory/mod name/romfs
Mod directory/mod name/exefs
An example of a correctly structured mod directory can be seen below:
The mods provided on our Switch Mods page are already structured accordingly and only need to be extracted into the mod directory folder as is.
Once added to the correct mod directory, simply right click the game again, select properties and activate the installed mod. The same process can be followed in reverse for de-activating mods
Installing updates and DLC is simple. In the top left corner of the emulator window, select
File / Install Files to NAND, then select the file you wish to install. Once installed, your files should load automatically and the installed update or DLC will be shown in the games list add-ons column of the corresponding game.
If you wish to activate/deactivate a specific update or DLC then right click your game in the games list, select
Properties, then enable or disable as needed.
Due to current file system limitations, there is no easy way to uninstall a specific update/DLC.
It is usually easiest to just delete everything and then reinstall any updates and DLC that you need.
Installed updates/DLC are found in
To remove them, you will need to delete this
Remember to reinstall any updates or DLC you need.
Afterwards, go to
Settings / System / Filesystem tab and click on
Reset Metadata Cache on the bottom. This will refresh the games list addons column.
Since the Nintendo Switch is a complicated device controller input wise, you will need to change some input settings depending on the game you wish to play.
In the input window dropdown, Select
Custom, then click on
For all games other than Pokemon Let’s Go set the controls like this:
Set analog Stickbutton if you are using a controller.
For Pokemon Let’s Go set your controls like this:
Configurenext to the
Player 1is set to
Noneas depicted in the screenshot.
Set analog Stickbutton if you are using a controller.
To add a save, simply right-click your game in the Games List, Select
Open Save Data Location, then Select your User from the Profile Selector
Save Data Location is open, place your game saves in this directory
Disconnect any USB gamepad you have and relaunch yuzu.
This typically occurs when yuzu runs out of RAM. Increase the size of your pagefile to resolve the issue.
Please read the following article: Boxcat
Please look up your error in the following page: Error Codes
Please read the following article: Mods
Please read the following guide: How to Upload the Log File
This is currently broken, and not working.
Please read the following guide: How to Use the Resolution Scanner
Please read the following article: What is Telemetry?
Please read the following guide: How to install Early Access
yuzu is an experimental open-source emulator for the Nintendo Switch from the creators of Citra. It is written in C++ with portability in mind, with builds actively maintained for Windows, Linux and macOS. The emulator currently can play various commercial titles and homebrew applications with varying degrees of success.
yuzu is an open-source project, licensed under the GPLv2 (or any later version). Refer to the license document for more information.
yuzu is actively tested and supported on various 64-bit versions of Windows (7 and up) and Linux. macOS is no longer supported due to Apple deprecating OpenGL.
yuzu currently requires an OpenGL 4.5 capable GPU and a CPU that has high single-core performance. It also requires a minimum of 8 GB of RAM. For more details, see our Quickstart Guide.
yuzu has an active team of open-source developers. The list of contributors can be found on GitHub.