-
-
Notifications
You must be signed in to change notification settings - Fork 215
Cemu Proton
Website: https://cemu.info/
Github: https://github.com/cemu-project/Cemu
Compatibility List: https://compat.cemu.info/
This page is for the Proton build of Cemu. EmuDeck includes the native build of Cemu as an optional install. If you choose to download the native version, both versions will remain installed. One quick way to tell the difference is to compare the two GUIs. For the Native version of Cemu, visit https://github.com/dragoonDorise/EmuDeck/wiki/cemu-proton-Native.
Native Cemu:
Proton Cemu:
IMPORTANT: Cemu is shifting away from encrypted ROMs (WUX, WUD). It is strongly recommended you use decrypted ROMs (Loadiine, WUA). Decrypted ROMs do not need any additional configuration and should launch without any issue.
Cemu is a fairly straight-forward emulator to set up, if you use decrypted ROMs. Place your ROMs in Emulation/roms/wiiu/roms
. No additional setup is required. Read the Configuration section to learn more about Cemu and its folder locations.
To launch your ROMs in game mode, use Steam ROM Manager and use one of the following parsers to play your Wii U ROMs:
EmulationStation-DE
-
Nintendo WiiU - Cemu (.rpx)
orNintendo WiiU - Cemu (.wud, .wux, .wua)
- Read the File Formats section to learn more about these various file formats
-
.rpx
and.wua
are decrypted ROM formats
Emulators
If you intend on using encrypted ROMs, proceed to the Setting up Cemu Questionnaire.
IMPORTANT: Cemu is shifting away from encrypted ROMs (WUX, WUD). It is strongly recommended you use decrypted ROMs (Loadiine, WUA). Decrypted ROMs do not need any additional configuration and should launch without any issue. If you use decrypted ROMs, you do not need the following questionnaire.
Setting up Cemu Questionnaire
- Is your ROM encrypted? If yes, do you have a
keys.txt
in the right place with the correct keys for your games in thekeys.txt
file?- What are keys?: Keys are required to decrypt Wii U ROMs. Your
keys.txt
needs to contain keys (one key per game) that must be dumped from a Wii U console. Any other method of obtaining keys is piracy and cannot be discussed here or on the EmuDeck discord. - Which Cemu ROM Formats are encrypted?: https://github.com/dragoonDorise/EmuDeck/wiki/cemu-proton#file-formats
-
keys.txt
Location:Emulation/roms/wiiu
- If your ROM is NUS Format (a folder with .h3 and .app files), you will need to decrypt your ROM into the Loadiine format (folder format with three subfolders - code, content, meta). Decryption methods cannot be discussed here or on the EmuDeck discord.
- What are keys?: Keys are required to decrypt Wii U ROMs. Your
- Is your ROM decrypted?
- Which Cemu ROM Formats are decrypted?: https://github.com/dragoonDorise/EmuDeck/wiki/cemu-proton#file-formats
- If your ROM is decrypted, place the ROM in
Emulation/roms/wiiu/roms
. Your game should launch without needing any keys.
- If you are getting an
Unable to launch game
error, did you place thekeys.txt
in the right place?-
keys.txt
Location:Emulation/roms/wiiu
-
- If you placed the
keys.txt
in the right place, and your ROM is still not working, does yourkeys.txt
have the correct key for the ROM?- Even if you placed a key for your game in
keys.txt
, you may still have the incorrect key.
- Even if you placed a key for your game in
- Did you transfer your ROM from another computer and did you compare file sizes to ensure it transferred successfully?
- Did you turn on Proton in Steam? If yes, turn it off. If you are unsure, check.
IMPORTANT: Cemu is shifting away from encrypted ROMs (WUX, WUD). It is strongly recommended you use decrypted ROMs (Loadiine, WUA). Decrypted ROMs do not need any additional configuration and should launch without any issue.
- Type of Emulator: Windows Executable Through Proton
- Executable Location (Cemu Script):
Emulation/tools/launchers/cemu.sh
- Use
cemu.sh
to launch Cemu in desktop mode.
- Use
- Executable Location (Windows EXE):
Emulation/roms/wiiu/cemu.exe
- Do not launch Cemu in desktop mode with
cemu.exe
.
- Do not launch Cemu in desktop mode with
- Emulator Folders Location:
Emulation/roms/wiiu
- Contains the following folders:
controllerProfiles
gameProfiles
graphicPacks
memorySearcher
mlc01
resources
roms
shaderCache
- Contains the following folders:
- Cemu Configuration File:
Emulation/roms/wiiu/settings.xml
- Persistent Storage:
Emulation/roms/wiiu/mlc01/
- ROM Location:
Emulation/roms/wiiu/roms
- Note the second
roms
folder in the path. - Do not put DLC / update files in the ROM path. Refer to https://github.com/dragoonDorise/EmuDeck/wiki/cemu-proton#installing-dlc-and-updates for DLC and updates.
- Note the second
-
keys.txt
Location:Emulation/roms/wiiu
- The
keys.txt
is only necessary if the Wii U ROM is encrypted. -
keys.txt
needs to contain keys (one key per game) that must be dumped from a Wii U console. Any other method of obtaining keys is piracy and cannot be discussed here or on the EmuDeck discord.
- The
- Saves Location:
- Symlink:
Emulation/saves/Cemu/saves/
- Target:
Emulation/roms/wiiu/mlc01/usr/save
- Symlink:
- Steam ROM Manager
- EmulationStation-DE
IMPORTANT:
There is outdated info on the internet that indicates you need to set Proton on Cemu or on games added for this console by Steam ROM Manager in Steam. Turning on Proton is not necessary. DO NOT set Proton Compatibity on Cemu or Cemu games added to Steam. Do NOT set STEAM_COMPAT_MOUNTS
in parameters.
Turning on Proton is not necessary because EmuDeck created a custom script to launch Cemu Proton. Turning on Proton through Steam breaks EmuDeck's custom script.
Do not open the Compatibility
screen in Game Mode
. Do not touch any of the settings on the Compatibility
screen in Game Mode
.
How to Update Cemu
- Through the
Update your Emulators & Tools
section on theManage Emulators
page in theEmuDeck
application - Manual file replacement of
Cemu.exe
- Refer to https://github.com/dragoonDorise/EmuDeck/wiki/File-Management#how-to-swap-out-appimages-and-binaries for instructions.
EmuDeck includes a feature that allows you to swap between Cemu 1.26 (stable), 1.27, and 2.x.
To swap between versions
- Open EmuDeck
- Click the
Manage Emulators
button - Click
Update your Emulators
- Click
Update AppImages and Binaries
- This includes the Windows version of Cemu
- Check
Nintendo WiiU Emu (Proton)
- Select which Cemu version you would like to use
- IMPORTANT: The GitHub link is the latest 2.x version of Cemu (version 2.0.36 in this image)
- IMPORTANT: The GitHub link/2.x version of Cemu is still the Windows version of Cemu, the link does not refer to the native version
How to Launch Cemu in Desktop Mode
- Launch
Cemu (Proton)
from theApplications Launcher
(Steam Deck icon in the bottom left of the taskbar) - Launch the script from
Emulation/tools/launchers
,cemu.sh
- Launch the emulator from
Steam
after adding it via theEmulators
parser inSteam ROM Manager
- Loadiine (rpx)
- Three folders (code, content, meta)
- Folders should be inside a folder with the name of the game. This game folder is placed in
Emulation/roms/wiiu/roms
(note the secondroms
) - Visual Reference:
- Decrypted, does not require
keys.txt
- WUA (requires Cemu 1.27.1 or higher)
- Decrypted, does not require
keys.txt
- Decrypted, does not require
- WUX
- Encrypted, requires
keys.txt
inEmulation/roms/wiiu/
- Encrypted, requires
- WUD
- Encrypted, requires
keys.txt
inEmulation/roms/wiiu/
- Encrypted, requires
- NUS
- A folder with
.h3
and.app
files - Encrypted, can be decrypted into a
Loadiine (rpx)
folder. Decryption methods cannot be discussed here or on the EmuDeck discord.
- A folder with
IMPORTANT:
- Some of these formats may require keys. We cannot help you get these. Place your
keys.txt
in:Emulation/roms/wiiu
-
keys.txt
needs to contain keys (one key per game) that must be dumped from a Wii U console. Any other method is piracy and cannot be discussed here or on the EmuDeck discord
-
- Once you put ROMs in place, you must refresh the list of games by right clicking in the Cemu UI and clicking
Refresh Games List
- Your game will not show up in Cemu until you refresh
- Refer to https://github.com/dragoonDorise/EmuDeck/wiki/cemu-proton#installing-dlc-and-updates, for DLC and Updates.
The WUA format is a compressed version of the Loadiine format. It contains your base game, DLC, and updates all in one single file. The WUA format is a lot less fuss than the other formats, requires no keys, and is the most friendly format for EmulationStation-DE.
Here's how to convert to WUA:
Note:
- Encrypted ROMs (WUX, WUD, NUS) cannot be converted to WUA
- Cemu only supports WUA on 1.27 and above
- You cannot convert ROMs to WUA on 1.26, the stable build of Cemu
Tutorial
- Open Cemu
- Click
Tools
,Title Manager
- Visual Reference:
- Either search for your ROM or find it in the list
- Select the ROM with the word
base
in theType
column - Verify the pop-up prompt has your base game, your update, and your DLC files
- You can either place these update and DLC files in
Emulation/roms/wiiu/roms
temporarily or install them: https://github.com/dragoonDorise/EmuDeck/wiki/cemu-proton#installing-dlc-and-updates
- You can either place these update and DLC files in
- Wait, it may take a while
- Right click in Cemu, and click
Refresh Game List
to refresh your file path in Cemu to the newly created WUA file
GIF:
DLC and Updates must be installed using the title manager. DLC and Updates are saved to mlc01, in the Emulation/roms/wiiu
folder.
IMPORTANT: Do not keep your DLC and update files in Emulation/roms/wiiu/roms
. After installing these, you may either delete or move the files to a backup location. Keeping DLC and update files in this directory will create duplicates in Steam ROM Manager.
- Launch Cemu on Desktop Mode
- Click
File
in the top left, clickInstall game title, update, or DLC...
- Visual Reference:
- Click
/
and either navigate to your SD card,/run/media/mmcblk0p1
or to your home folder/home/deck
- Select the parent folder (named
<Game Name: Update ###>
or<Game Name: DLC Y>
) of your update or DLC - On the right, you will see
code
,content
, andmeta
- Select
meta
, and clickOpen
in the bottom right- Visual Reference:
- Wait a moment, and your DLC or update will be successfully installed. Repeat for each DLC or update
GIF:
You can manually position the update and DLC files in the correct spot without using the Title Manager in Cemu.
The base of this operation is your mlc01 folder.
The folder structure for the mlc01
is as follows: mlc01/usr/title/
Inside the title folder you need a 0005000e
folder for updates and a 0005000c
for DLC
inside those folders, you put a folder with the id of your game.
US Breath of the wild for example:
-
Update:
mlc01/usr/title/0005000e/101c9400/
{code, content, meta } go here -
DLC:
mlc01/usr/title/0005000c/101c9400/
{code, content, meta } go here
Cemu comes with a Steam Input profile for Hotkeys. Activate the Steam Input profile by clicking the Game Controller
icon in Game Mode
, change the template to Emudeck - Cemu
. The hotkeys below can only be used if you have the Steam Input profile active.
Hotkey | Cemu |
---|---|
Toggle Screens | R4 |
Swap Screens | R5 |
Exit |
Select + Start
|
Blow Mic | R3 |
Note:
- The
Blow Mic
hotkey only works if you are using the gamepad.
For a tutorial on how to select Steam Input Profiles, refer to: https://github.com/dragoonDorise/EmuDeck/wiki/hotkeys#how-to-select-a-steam-input-profile.
Steam Deck Button Layout: https://github.com/dragoonDorise/EmuDeck/wiki/Hotkeys#steam-deck-button-layout
- Xenoblade Chronicles X crashes on
1.27.1
with high frequency. - Cemu will fail to launch on versions
1.27.1
through2.0-16
when there's no internet and Gyro is enabled.- Cemu versions
2.0-17
and above will work offline with Gyro enabled.
- Cemu versions
- The Legend of Zelda: Twilight Princess HD's missing UI graphics are fixed in
2.0.4
, but this version brings some performance regressions in other games.
Gyro for Cemu requires SteamDeckGyroDSU. SteamDeckGyroDSU can be installed via EmuDeck, or it can be installed manually.
Visual Reference:
How to Install SteamDeckGyroDSU: https://github.com/dragoonDorise/EmuDeck/wiki/frequently-asked-questions#how-do-i-install-steamdeckgyrodsu
Prerequisites
- Decky Loader and Power Tools
- Power Tools can be installed via EmuDeck, or it can be installed manually
- Visual Reference:
- Although this screen does not explicitly state Decky Loader, Decky Loader is included in this installation
- Step by Step Instructions on How to Install Power Tools: https://github.com/dragoonDorise/EmuDeck/wiki/frequently-asked-questions#how-do-i-install-power-tools-and-deckyloader
- Power Tools can be installed via EmuDeck, or it can be installed manually
Recommended Settings
- Power Tools: Turn SMT off
- Open the
QAM
("..." button), select theSocket
icon, selectPOWERTOOLS
, turn offSMT
- Visual Reference:
- (Optional) Use the
Persistent
toggle to set these settings on a per-game basis- Visual Reference:
- Open the
- Steam Deck Performance Menu: Set Manual GPU Clock Control to 1200 frequency
- Open the
QAM
("..." button), select theBattery
icon, enableAdvance View
, scroll down, enableManual GPU Clock Control
, and set it to1200
- Visual Reference:
- Toggle per game profiles
- Visual Reference:
- Open the
-
IMPORTANT: Some Wii U games will not perform well regardless and will require the Cemu team to improve compatibility
- In some cases, these games may have workarounds through modifying settings or applying patches or mods. Search on Google for your respective game, and see if these workarounds exist
- Check the Cemu Compatibility List: https://compat.cemu.info/
- Open Cemu
- It's recommended you enable multiplayer on a per-game basis. Turning on additional controllers can disable single player controls in a handful of games
- Right click a game, click
Edit Game Profile
- Click
Controller
- To the right of each Controller (
Controller 2
throughController 4
), select the respectiveDeck #
profile (Deck 2 for player 2 and so on)
In some some games, the initial screen will prompt for a controller configuration: Wii U Gamepad
or Wii U Pro Controller
.
For example:
If you prefer to use the Wii U Pro Controller
layout, you need to change the controller profile in Cemu. Make sure to change controller profiles on a per-game basis so it is persistent on EmuDeck updates.
Tutorial
- Right click the game, click
Edit game profile
- Click the
Controller
tab - Change the profile to
Deck
- When you launch a game, one of the following two things will happen:
- Some games will prompt you to choose a controller layout, select the
Wii U Pro Controller
- Some games will automatically switch to the
Wii U Pro Controller
configuration
- Some games will prompt you to choose a controller layout, select the
- Open Cemu
- Right click
Breath of the Wild
, click "Edit graphic packs" - Open the Mods drop down list
- Toggle on FPS++
- Select FPS++
- Change the mode to "Advanced Settings"
- Change the Framerate Limit to 40FPS
- Close out of Cemu
- Open Breath of the Wild in game mode
- Click the "..." (the QAM) button
- Click the battery icon
- Click "Advanced View"
- Turn on "Use per-game profile"
- Set the refresh rate to 40
- Your game should now be running at a stable 40 FPS (with temporary occasional hiccups in new areas while it compiles shaders)