Troubleshooting Steps

If you need further help, ask on the official Cemu Discord Server for assistance.
If you appreciate this guide, we accept Donations.


The first step is to ensure the game you are wanting to play has been deemed playable, as many games are either: not yet supported, are only known to boot but simply crash, or they have regressions in compatibility due to Cemu updates or issues with new GPU Drivers. You can check the Game Compatibility List and subsequent Wiki entries, just be aware of outdated testing results.

We encourage our users to submit their testing results and to otherwise keep the wiki up-to-date so that everyone’s questions may be answered.

Stuck on “Loading…” / Crash to Desktop (CTD) when starting a game

  1. Accidentally loading an Update or DLC as a game by using File -> Load can cause this. Alternatively if you accidentally merged the Update or DLC into the Base Game, this will break the Base Game - it will need to be redumped from your Wii U and replaced. Ensure you’re launching the game correctly or otherwise that Update and DLC data is being installed properly.

  2. This could be caused by a bad Base Game / Update / DLC copy. Try redumping the data from your Wii U again. Reinstalling any game data will not affect your saves.

  3. Illicitly obtained game data will also cause this to happen. Dumping your game data as covered in this guide is the only method that Cemu provides support for.

“Error: This title is encrypted. To run this application …”

If you followed this guide you should not be dealing with this type of problem. The software Dumpling will dump your games in a decrypted format and does not require you to have Encryption Keys or have you mess with keys.txt - if you used the wrong homebrew to dump the game software, please go back and use Dumpling instead.

This error means the key that came with your encrypted game dump is not in your keys.txt file. Random keys from the internet will not work. To get the correct keys from your console without redumping the game again, you must follow this small guide:

Obtaining your Wii U Common Key and Encryption Keys for your keys.txt

Constant stuttering or visual lag during gameplay

This is caused by shaderCache creation or Vulkan’s pipelineCache creation. With OpenGL and Vulkan, the shaderCache will build as you play and will eventually become nearly unnoticable. As mentioned, Vulkan also requires a pipelineCache - this cache type will build quickly and have minor stutter. Keep in mind that it has to be rebuilt from scratch every time you update your GPU driver or Cemu as a sideeffect from becoming invalidated when either of these change.

To alleviate gameplay stalls caused by shader and pipeline building, see About Async Compile further below.

How do I turn shaders off? Can’t I just download shaders? Create them before I play?

If you’re simply wanting to turn the notification off that tells you they are being made, you can do this in Options -> General Settings -> Overlay

On the contrary, no, you cannot magically create a cache before playing the game nor can you disable shader or pipelines to prevent stalling. Cache is what allows your games to work on your GPU, otherwise your PC. No shaders or cache? No game - the emulator becomes a black square.

If you happen to get impatient and think downloading a cache is a good idea, please think again. Not only are caches from outside sources not reliable due to inconsistencies between game versions, data corruption, GPU vendors, etc - but due to these, external caches often cause severe graphical problems, performance drops, and otherwise inexplainable crashes. Only use your own cache. If you had tried to download one, please remove the cache before asking for assistance - it might actually fix your issue.

This feature is only available for GPUs with drivers that support Vulkan 1.2 or newer.

Users that fit this criteria should navigate to Cemu’s Options -> General Settings -> Graphics section, then enable the Async shader compile feature. Expect visual glitches such as graphical “pop-in”; this behavior should only last during the first encounter with that model/texture/visual effect. While using Async Shader Compile almost all Shaders and Pipelines will be built at the same time while you are playing, greatly reducing the amount of gameplay stalling that you could encounter without this option. Not all shaders and pipelines can be created in this way and will still result in some minor stalling.

Newer Intel iGPUs should support this feature as long as they both support Vulkan 1.2 and are using the latest available drivers. If you encounter issues while using this feature, please disable it and try again after a future driver update.

When I use Steam to launch Cemu, why does my game fail to load a lot of stuff?

Steam caches shaders on its own unless you turn this off, this majorly conflicts with Async Shader Compile. Look for the Shader Precaching option within Steam’s settings and disable it to resolve the issue. We recommend that you do not use 3rd party launchers to launch Cemu due to potential problems that we have no control over.

My GPU doesn’t show up when I select Vulkan / I crash when using Vulkan

  1. Verify that your GPU supports the Vulkan API and is up-to-date with Nvidia/AMD/Intel’s latest driver version.

  2. If you’re already using the latest driver, please reinstall your GPU driver by specifically following this guide:

DDU - Display Driver Uninstaller Guide

If this fails to help then it’s time to see what our Discord Server has to say.

Crashing with Options -> General Settings

This is uncommon. We recommend you do a clean installation of Cemu to see if this problem is a result of your current Cemu. If you cannot resolve this problem, feel free to ask for assistance on our Discord Server.

Crashing with File -> Install Game Title, Update, or DLC or File -> Load

This is a longstanding issue that’s caused by either:

  1. Incompatibility with a 3rd party program installed on your PC, usually one that edits how Windows visually looks or those that edit the Taskbar/Tray.

  2. If your PC supports Intel Optane / RST, you must keep the drivers and features for it installed. Not having the software available can cause this issue; if you removed them or never installed them, it is encouraged for you to do so, but only if your motherboard supports this feature and you get this type of crash.

  3. A broken or semi-corrupt Windows installation.

We encourage you to try and find the afflicting program and remove it, otherwise you should consider installing the latest version of Windows 10, cleanly. Migrations, in-place upgrades, “Refresh” and any other non-fresh installation methods can result in many issues and will likely just bring the problem over to your newer installation.

If you are not sure of how to do a clean Windows reinstallation, we suggest you follow a tutorial. Please be smart and back-up any files and settings you want to transfer beforehand.

Can’t initialise DirectInput

This can be fixed by unplugging the controller and restarting Windows. After your PC has fully booted plug the controller back in. Ensure you are using the latest official version of Cemu, it is also encouraged to be using the latest version of Windows 10.

The Legend of Zelda: Breath of the Wild

Full Cemu Wiki listing of issues

Please review the above link as it goes over nearly every problem that has been recorded to date! Most (but not all) of the common issues are listed below.

“A System update is required” at boot or a White/Yellow Screen after “Open your eyes…”

This is caused by the game’s latest update not being installed. Breath of the Wild must be using the latest update to work properly at all. Follow our dumping guide to dump and install the latest game update and then install it on Cemu, make sure the game is updated on your Wii U console before doing so.

Game is stuck at around 20~30FPS

  1. Ensure you’re running the latest game update and Cemu version.
  2. Ensure FPS++ is enabled and set to above 30 or you will be locked into this state.
  3. Make sure your hardware is supposed to be able to exceed 30FPS, try going into a Shrine.
  4. Try disabling Vsync temporarily and see if this changes the behavior.

Game feels like it’s playing in Slowmotion or Fastforward

  1. This will occur if you do not have the game fully updated and you haphazardly enable FPS++
  2. On occasion FPS++ will incorrectly apply after starting the game. Restarting Cemu usually resolves this.
  3. Do not use FPS++’s Static Mode (Enabled) instead of Disabled (Default, Dynamic); Static Mode will cause this behavior.
  4. Changing the Frame Average to a higher value instead of using the default value 8 can also cause this issue.

Cutscenes (Rito Village/Vah Medoh/possibly others) cause the game to freeze

This can be caused by setting the framerate above 60FPS. If it still occurs at 60FPS, then set it to 30FPS or disable FPS++ temporarily, then change the setting back after the cutscene has finished, save, and then restart Cemu. Alternatively you may try using OpenGL instead of Vulkan.

If disabling FPS++ and using OpenGL doesn’t resolve this, this is a sign that your game’s data is corrupt and needs replaced. You should replace the Update and DLC as well.

I ran into invisible water that’s in the middle of the air

This is an infrequent issue on Vulkan, a simple Cemu restart should resolve the invisible water. This may be fixed in the future.

A lot of buildings or other assets aren’t loading in or take several minutes to load

  1. Disable any 3rd party mods if you downloaded and installed any, then test the game.

  2. Disable the Extended Memory and Draw Distance GraphicPacks, then test the game.

  3. Use FPS++’s Advanced Settings and set the Fence Method to Accurate instead of Performance

If none of these helped, this is a sign that your game’s data is corrupt and needs replaced. You should replace the Update and DLC as well.

I get a black screen when a cutscene is supposed to start

This is a sign that your game’s data is corrupt and needs replaced. You should replace the Update and DLC as well.

I get a green screen when a cutscene is supposed to start

This should only affect Linux users for now. You must have Cemuhook installed and correctly hooked into Cemu and have the Debug -> Use Cemuhook H264 option enabled. If you do not know how to do this, visit the #Linux channel on the Cemu Discord server for assistance. This should no longer be required after Cemu’s H264 support is updated / after Linux gets a native Cemu build.

If you are also getting this behavior on Windows, try using Debug -> Use Cemuhook H264 or otherwise request assistance on our Discord Server.

Other miscellaneous issues with Breath of the Wild

Emulation isn’t a perfect science and new or old problems can surface, or ones that don’t match other descriptions. If you do encounter something that isn’t listed here, check the full Cemu Wiki listing of issues for Breath of the Wild

If what you’re having problems with is not listed there, please make sure that your GPU supports Vulkan 1.1 or OpenGL 4.5; if it doesn’t you will not have full support which will result in a multitude of game-breaking bugs.

If you do have confirmed support, the safest bet is to:

  1. Disable all 3rd party mods and test the result; many mods cause problems.

  2. Disable all graphicPacks except for FPS++ and then see if the issue stops.

  3. Try renaming your shaderCache folder to see if it’s the cause of the problem. If the shaderCache isn’t the culprit, you can rename your shaderCache folder back to its original name in order to resume using it after a Cemu restart.

  4. Unfortunately not all issues are repairable; you should always try to fully redump the game, update, and DLC from your Wii U console.

You may always visit us on our Discord to see if we can figure out the problem together.