Yuzu Reader

To use this list, press Ctrl-F and then type in the error code from yuzu. This should look similar to XXXX-XXXX where the Xs represent numbers and letters.

Key Errors

Yuzu combines a next-generation reading and note-taking eReader; allowing students to create a personal learning experience that best suits their needs. Using the Yuzu Web Reader Follow New articles New articles and comments. How to Guide - Library Tools; How to Guide - Locate a Book.

Yuzu Reader How To Use

Please use the general how-to guide, which includes instructions on dumping the necessary files from your switch to have yuzu derive all of your keys,
For all: If you try to run recent games and you haven’t done the key derivation process recently, you may need to redump and rerun it as newer games use newer keys only available on newer firmwares. Getting an incorrect key means you might have a bad dump of your switch’s files. Try again and if it persists, contact the discord. If you are missing the titlekey or an update won’t load, sometimes updates change the titlekey between versions – either way redump and if that doesn’t work contact the discord/devs.
Error CodeName
0008-000CErrorMissingProductionKeyFile
0008-000DErrorMissingHeaderKey
0008-000EErrorIncorrectHeaderKey
0008-0011ErrorMissingTitlekey
0008-0012ErrorMissingTitlekek
0008-0014ErrorMissingKeyAreaKey
0008-0015ErrorIncorrectKeyAreaKey
0008-0016ErrorIncorrectTitlekeyOrTitlekek
0008-0018ErrorNCANotProgram

Other Common Errors

Error CodeName
0008-001CErrorNullFile
The file your are trying to use is empty and contains no data. This is a sign of a bad copy or corrupt storage device.
0008-001DErrorMissingNPDM
Ensure that your rom directory has a file called main.npdm. This is used to determine key info about how to run the game and is required to run. You may need to redump if you deleted this.
0008-001EError32BitISA
The game you are trying to run uses the 32-bit ARM architecture, which is not currently supported by yuzu.
0008-0029ErrorNAXInconvertibleToNCA
The NAX file you are trying to run is not a game but in fact a save file. Double check your files.
0008-002AErrorBadNAXFilePath
You can only execute games that are NAX encrypted if they are left in the original directory structure from the SD card (registered/<hex digits>.nca/00). The hex digits contain needed data to decrypt the game properly.
0008-0039ErrorMissingBKTRBaseRomFS
You are trying to run a game update, which isn’t possible. To use a game update, instead go to File > Install file to NAND… and select the update from that menu. After it’s done, launch the base game and yuzu will apply the update.

Corruption Errors - All of these errors are indicative of a bad/corrupt dump. If there are no special instructions, try redumping. Should the error persist contact the devs/discord for help.

Error CodeName
0008-0004ErrorBadNPDMHeader
0008-0005ErrorBadACIDHeader
0008-0006ErrorBadACIHeader
0008-0007ErrorBadFileAccessControl
0008-0008ErrorBadFileAccessHeader
0008-0009ErrorBadPFSHeader
0008-000AErrorIncorrectPFSFileSize
0008-0013ErrorInvalidRightsID
0008-0017ErrorXCIMissingProgramNCA
In some rare cases, this has been known to appear with missing keys. Try rederiving your keys and if that doesn’t work contact the devs.
0008-0019ErrorNoExeFS
0008-001AErrorBadXCIHeader
0008-001BErrorXCIMissingPartition
If you trimmed your XCI, it might have been done improperly. Try avoiding trimming.
0008-001FErrorNoRomFS
0008-0020ErrorIncorrectELFFileSize
0008-0021ErrorLoadingNRO
0008-0022ErrorNoIcon
0008-0023ErrorNoControl
0008-0024ErrorBadNAXHeader
0008-0025ErrorIncorrectNAXFileSize
0008-0031ErrorNSPMissingProgramNCA
0008-0032ErrorBadBKTRHeader

Less Common General Errors - You should not expect to see these unless you are doing more than just playing games

Error CodeName
0008-000FErrorNCA2
The NCA you are attempting to load is using an older format that is not currently supported. If you would like support to be added, consider filing an issue.
0008-0010ErrorNCA0
The NCA you are attempting to load is using an older format that is not currently supported. If you would like support to be added, consider filing an issue.

Less Common Key Errors - Below errors should not be obtained if using the normal key derivation process (which is highly encouraged for newcomers), but if you are not using it these errors will make sense to you.

Error CodeName
0008-002BErrorMissingSDSeed
0008-002CErrorMissingSDKEKSource
0008-002DErrorMissingAESKEKGenerationSource
0008-002EErrorMissingAESKeyGenerationSource
0008-002FErrorMissingSDSaveKeySource
0008-0030ErrorMissingSDNCAKeySource

Internal Errors - Should never be seen ever. Report to the devs immediately.

Error CodeName
0008-0000Success
0008-0001ErrorAlreadyLoaded
0008-0002ErrorNotImplemented
0008-0003ErrorNotInitialized
0008-0026ErrorNAXKeyHMACFailed
0008-0027ErrorNAXValidationHMACFailed
0008-0028ErrorNAXKeyDerivationFailed
0008-0033ErrorBKTRSubsectionNotAfterRelocation
0008-0034ErrorBKTRSubsectionNotAtEnd
0008-0035ErrorBadRelocationBlock
0008-0036ErrorBadSubsectionBlock
0008-0037ErrorBadRelocationBuckets
0008-0038ErrorBadSubsectionBuckets

Table of Contents

Downloading and Installing yuzu

Hardware Requirements

CPUGPURAM
MinimumIntel Core i5-4430 / AMD Ryzen 3 1200Intel HD Graphics 520 / NVIDIA GeForce GT 1030 2GB / AMD Radeon R7 240 2GB8GB
RecommendedIntel Core i5-10400 / AMD Ryzen 5 3600Intel UHD Graphics 630 / NVIDIA GeForce GTX 1650 4GB / AMD Radeon RX Vega 56 8GB16GB
  • Our recommended specifications don’t guarantee perfect performance in most games, but rather strive to provide a cost effective recommendation while still considering performance.

  • Most games are playable on older Nvidia GPUs from the Fermi family (400 series) or later, but at least Pascal (1000 series) is strongly recommended.

  • CPUs lacking the FMA instruction set will produce very poor results. Intel Core gen 3 series or older, AMD phenom II or older and all Pentium/Celeron/Atom CPUs will not produce optimal results.

  • Mobile CPUs will not reach the same performance as their desktop counterparts due to thermal, power, and technical limitations.

  • GPUs must support OpenGL 4.6 & OpenGL Compatibility profile, or Vulkan 1.1 (or higher).
    To find out if your GPU meets these requirements, visit https://opengl.gpuinfo.org or https://vulkan.gpuinfo.org/ and check your GPU details.

Sample Image:

yuzu Quickstart Guide

To start playing commercial games, yuzu needs a couple of system files and folders from your switch in order to play them properly.To check if your Switch is hackable, visit https://damota.me/ssnc/checker and test your Switch’s serial number.

This guide will help you copy all your system files, games, updates, and DLC from your switch to your computer and organize them in a format yuzu understands.This process should take about 60 to 90 minutes.

IMPORTANT:
Make sure to place your Nintendo Switch into Airplane Mode before starting this guide.
System Settings -> Airplane Mode -> Airplane Mode 'ON'

Prerequisites

  • A Nintendo Switch vulnerable to the fusée gelée RCM exploit – Visit https://damota.me/ssnc/checker and test your Switch’s serial number
  • An SD card with at least 30 GB of free space (an almost empty 32GB card will work)
  • A USB-C to USB-A or USB-C to USB-C Cable to connect your Switch to your computer
  • TegraRcmGUI – Download TegraRcmGUI_v2.6_Installer.msi
  • Hekate – Download hekate_ctcaer_X.X.X_Nyx_X.X.X.zip
  • Atmosphere – Download both atmosphere-X.X.X-master-XXXXXXXX+hbl-X.X.X+hbmenu-X.X.X.zip and fusee-primary.bin
  • Lockpick_RCM – Download Lockpick_RCM.bin
  • nxdumptool – Download nxdumptool.nro
  • nxDumpMerger – Download nxDumpMerger_Windows.zip
  • TegraExplorer – Download TegraExplorer.bin
  • microSD Card Reader – If your computer has one built-in, you can use that
  • RCM Jig <– We highly recommend one like this, but you could use any of the methods outlined here

%YUZU_DIR% is the home directory for yuzu on your computer:

Preparing the microSD Card

  1. We will now prepare the microSD card.
    • 1a. Extract the contents inside the atmosphere-X.X.X-master-XXXXXXXX+hbl-X.X.X+hbmenu-X.X.X.zip and hekate_ctcaer_X.X.X_Nyx_X.X.X.zip files into the root of your microSD card. Just drag and drop the contents, do not create any new folders.
    • 1b. Rename the hekate_ctcaer_X.X.X.bin file to reboot_payload.bin and move it into the atmosphere folder. Replace the file when prompted.
    • 1c. Place the fusee-primary.bin, Lockpick_RCM.bin and TegraExplorer.bin files into the payloads folder, which is inside the bootloader folder in your microSD card.
    • 1d. Create a folder named nxdumptool within the switch folder of your SD card and place the nxdumptool.nro file inside it.
    • 1e. Once done, eject the microSD card and insert it into your Nintendo Switch.

Booting into RCM

  1. We will now boot your Nintendo Switch into RCM mode
    • 2a. Run the TegraRcmGUI installer you downloaded from the prerequisites, and after installation, start the program.
    • 2b. In the Settings tab, click on Install Driver which will install the drivers necessary for your computer to interface with your Nintendo Switch.
    • 2c. After the drivers have been installed, plug your Nintendo Switch into your computer.
    • 2d. Power off your Switch while it is still connected to your computer.
    • 2e. Insert your RCM jig into the right joy-con slot, make sure it is seated securely at the base, and then press VOL+ and Power buttons at the same time. Nothing should happen on your Switch; if the switch starts to turn on normally, go back to the beginning of step 2d and try again.
    • 2f. If you see the Nintendo Switch icon in the lower left corner flash green and state RCM O.K., your switch has successfully entered RCM mode.

Booting into Hekate

  1. We will now boot your Nintendo Switch (already in RCM mode) into Hekate, a custom bootloader.
    • 3a. Extract the hekate_ctcaer_X.X.X.bin file from the hekate_ctcaer_X.X.X_Nyx_X.X.X.zip file you downloaded from the prerequisites to any accessible directory on your computer.
    • 3b. Run TegraRcmGUI. In the Payload tab of TegraRcmGUI, click on the folder icon and navigate to the hekate_ctcaer_X.X.X.bin file you extracted earlier.
    • 3c. Click on Inject Payload and your Switch will boot into the Hekate menu.

Mounting the microSD card to your computer in Hekate

NOTE: These steps will be used in other sections below. Do not follow this section yet if you are booted into Hekate for the first time. Skip to the next section for now.

  1. We will now mount the microSD card as a drive from your Switch to your computer in Hekate, via USB.

    • 4a. In the Hekate Home menu, tap on the Tools tab to show the Tools menu.
    • 4b. Tap on USB Tools.
    • 4c. Tap on SD Card. Your SD card should now be mounted as a drive to your computer.

    To unmount the SD card: Safely eject the drive from your computer and tap on Close from your Switch’s screen.

  2. We will now return to the Hekate Home menu.

    • 5a. Tap on Close again to return to the Tools menu.
    • 5b. Tap on the Home tab to return to the Hekate Home menu.

Dumping Prod.keys and Title.keys

  1. We will now dump your prod.keys and title.keys for decryption of your game files.
    • 6a. Boot your Nintendo Switch into RCM mode (steps 2c. to 2f.) and make sure it is connected to your computer.
    • 6b. Boot into Hekate (steps 3b. to 3c.)
    • 6c. When it has successfully booted into the Hekate menu, tap on Payloads. This will show a list of payloads.
    • 6d. Tap on Lockpick_RCM.bin in the list of payloads.
    • 6e. After Lockpick_RCM has successfully booted, press the power button to select Dump from SysNAND.
    • 6f. It will automatically boot to sept and start deriving the keys. Wait for it to finish deriving the keys.
    • 6g. After Lockpick_RCM has finished deriving the keys, please make note of the location of the key files. Default is: sd:/switch/prod.keys and sd:/switch/title.keys.
    • 6h. Press any button to return to the menu, then navigate with the VOL+/VOL- buttons to highlight and select Payloads... by pressing the power button.
    • 6i. Select reboot_payload.bin from the list of payloads. You should now be booted back into Hekate.
    • 6j. Mount the SD card to your computer in Hekate (steps 4a. to 4c.)
    • 6k. Navigate to your SD card drive and copy both prod.keys and title.keys to the %YUZU_DIR%/keys directory.
    • 6l. Once you’re done copying, safely eject the SD card drive in your computer and return to the Hekate Home menu. (steps 5a. to 5b.)

Backing up Switch NAND (Optional but Recommended)

  1. We will now boot Hekate to dump your switch’s NAND. This step is optional, but highly recommended to ensure you have a backup of your Switch’s data in its internal storage.
    • 7a. Boot your Nintendo Switch into RCM mode (steps 2c. to 2f.) and make sure it is connected to your computer.
    • 7b. Boot into Hekate (steps 3b. to 3c.)
    • 7c. When it has successfully booted into the Hekate Home menu, tap on the Tools tab and select Backup eMMC.
    • 7d. Underneath the Full section, tap on eMMC BOOT0 & BOOT1. This may take a few seconds to load. After it is finished filling the progress bar it should say Finished and verified!. Beneath Filepath: you will see the location of the dump.
    • 7e. Tap on Close and select eMMC RAW GPP. This should take some time as the Switch’s rawnand.bin is quite large. If the progress bar appears to go backwards at some points or turn green, do not worry as this is Hekate verifying the data. This should take between 15-45 minutes depending on the quality/speed of your SD card and the default verification setting. Please keep note of the location the output file is placed.
    • 7f. Tap on Close two times to return to the Tools menu.
    • 7g. Mount the SD card to your computer in Hekate (steps 4b. to 4c.)
    • 7h. Navigate to your SD card drive and copy the backup folder to your computer.
    • 7i. Once you’re done copying, safely eject the SD card drive in your computer and return to the Hekate Home menu. (steps 5a. to 5b.)

Dumping System Update Firmware

  1. Some games such as Mario Kart 8 Deluxe require the use of files found inside the Nintendo Switch System Update Firmware to be playable. In this step, we will now dump the firmware files from your Switch for use in yuzu.
    • 8a. Boot your Nintendo Switch into RCM mode (steps 2c. to 2f.) and make sure it is connected to your computer.
    • 8b. Boot into Hekate (steps 3b. to 3c.)
    • 8c. When it has successfully booted into the Hekate Home menu, tap on Payloads. This will show a list of payloads.
    • 8d. Tap on TegraExplorer.bin in the list of payloads.
    • 8e. After TegraExplorer has successfully booted, navigate through the menu using the VOL+/VOL- buttons to highlight and select Dump Firmware by pressing the POWER button.
    • 8f. Once the dumping process is finished, the .nca files will be located in your SD card at sd:/tegraexplorer/Firmware/ inside a folder with a name of the firmware revision.
    • 8g. Press any button to return to the main menu.
    • 8h. Select the Reboot to bootloader/update.bin option. (Alternatively, you can select the reboot_payload.bin option if update.bin is not available.) You should now be booted back into Hekate.
    • 8i. Mount the SD card to your computer in Hekate (steps 4a. to 4c.)
    • 8j. Navigate to your SD card drive and copy the contents in the firmware folder (step 8f.) to %YUZU_DIR%/nand/system/Contents/registered. Alternatively, you can write %appdata%yuzunandsystemContentsregistered in the address bar of a file explorer. The registered folder should be full of .nca files.
    • 8k. Once you’re done copying, safely eject the SD card drive in your computer and return to the Hekate Home menu. (steps 5a. to 5b.)

Dumping Cartridge Games

  1. We will now dump the Cartridge Image (XCI) file from your game cartridge(s), to use in yuzu. Insert the game cartridge of your choice.
    • 9a. Boot your Nintendo Switch into RCM mode (steps 2c. to 2f.) and make sure it is connected to your computer.
    • 9b. Boot into Hekate (steps 3b. to 3c.)
    • 9c. When it has successfully booted into the Hekate Home menu, tap on Payloads. This will show a list of payloads.
    • 9d. Tap on fusee-primary.bin in the list of payloads.
    • 9e. Your Switch will launch into Custom Firmware Mode (CFW), and once your Switch has booted into the HOME Menu, press and hold the R button on your controller and launch a game. This will launch the Homebrew Menu in title override mode.
    • 9f. Either use the touchscreen or navigate using your controller, and select nxdumptool.
    • 9g. Select the Dump gamecard content option.
    • 9h. Select the Cartridge Image (XCI) dump option.
    • 9i. Once the cartridge image has been dumped, press any button to return to the previous menu and then press + to return to the Homebrew Menu.
    • 9j. Select Reboot to Payload and then press - on your controller to return to the Hekate Home menu.
    • 9k. Mount the SD card to your computer in Hekate (steps 4a. to 4c.)
    • 9l. Navigate to your SD card drive. XCI dumps are located under sd:/switch/nxdumptool/XCI.
    • 9m. If your XCIs are dumped in parts with .xc0, .xc1, .xc2, etc extensions, use the nxDumpMerger tool you have downloaded in the prerequisites to assist in merging these parts into a complete XCI. If they were dumped as complete XCI files with the .xci extension, you can proceed to copy these to a game directory of your choice.
    • 9n. Extract the contents of nxDumpMerger_Windows.zip into a new folder and start the program.
    • 9o. Select the button with the triple dots ... next to the Input field. This will open a file selector.
    • 9p. Find and select one of the parts and click Open.
    • 9q. Next, select the button with the triple dots ... next to the Output field. This will open a folder selector.
    • 9r. Select a folder where you would like your games stored in your computer and then click Select Folder. (NOTE: Do not select a folder inside the SD card or you will quickly run out of space and experience slow transfer speeds in the merging process.)
    • 9s. After completing these steps, the parts are ready to be merged. Select Merge Dump and the program will merge the parts into a complete XCI located in the Output folder. Repeat these steps for all other games dumped as parts.
    • 9t. Once you’re done merging, safely eject the SD card drive in your computer and return to the Hekate Home menu. (steps 5a. to 5b.)

Yuzu Reader Not Working

Yuzu Reader

Dumping Installed Titles (eShop)

  1. We will now dump the Nintendo Submission Package (NSP) file from your installed eShop game(s), to use in yuzu.
    • 10a. Boot your Nintendo Switch into RCM mode (steps 2c. to 2f.) and make sure it is connected to your computer.
    • 10b. Boot into Hekate (steps 3b. to 3c.)
    • 10c. When it has successfully booted into the Hekate menu, tap on Payloads. This will show a list of payloads.
    • 10d. Tap on fusee-primary.bin in the list of payloads.
    • 10e. Your Switch will launch into Custom Firmware Mode (CFW), and once your Switch has booted into the home menu, press and hold the R button on your controller and launch a game. This will launch the Homebrew Menu in title override mode.
    • 10f. Either use the touchscreen or navigate using your controller, and select nxdumptool.
    • 10g. Select the Dump installed SD Card / eMMC Content option.
    • 10h. Select the game you want to dump.
    • 10i. Select the Nintendo Submission Package (NSP) dump option.
    • 10j. If your game contains an update or DLC, you will see multiple dumping options such as Dump base application NSP, Dump installed update NSP or/and Dump installed DLC NSP in the next screen. Select Dump base application NSP to dump the base game.
    • 10k. Select the Start NSP dump process option and wait for the dumping process to finish.
    • 10l. Press the B button to return to the previous menu(s) and repeat the previous steps to dump the base, updates and DLC of all your games.
    • 10m. Once all your games are dumped, press any button to return to the previous menu and then press + to return to the Homebrew Menu.
    • 10n. Select Reboot to Payload and then press - on your controller to return to the Hekate Home menu.
    • 10o. Mount the SD card to your computer in Hekate (steps 4a. to 4c.)
    • 10p. Navigate to your SD card drive. NSP dumps are located under sd:/switch/nxdumptool/NSP.
    • 10q. If your NSPs are dumped as folders with 00, 01, 02, etc parts within them, use the nxDumpMerger tool you have downloaded in the prerequisites to assist in merging these parts into a complete NSP. If they were dumped as files, you can proceed to copy these to a game directory of your choice.
    • 10r. Extract the contents of nxDumpMerger into a new folder and start the program. (Skip the extraction if you already followed step 9n.)
    • 10s. Select the button with the triple dots ... next to the Input field. This will open a file selector.
    • 10t. Find a NSP that is dumped as a folder with parts. Select one of the parts within the folder and click Open.
    • 10u. Next, select the button with the triple dots ... next to the Output field. This will open a folder selector.
    • 10v. Select a folder where you would like your games stored in your computer and then click Select Folder. (NOTE: Do not select a folder inside the SD card or you will quickly run out of space and experience slow transfer speeds in the merging process.)
    • 10w. After completing these steps, the parts are ready to be merged. Select Merge Dump and the program will merge the parts into a complete NSP located in the Output folder. Repeat these steps for all folder NSPs.
    • 10x. Once you’re done merging, safely eject the SD card drive in your computer and return to the Hekate Home menu. (steps 5a. to 5b.)

Dumping Save Files (Optional)

Yuzu reader offline
  1. We will now dump the games’ save files from your switch to use in yuzu.
    • 11a. Download Checkpoint.nro
    • 11b. Boot your Nintendo Switch into RCM mode (steps 2c. to 2f.) and make sure it is connected to your computer.
    • 11c. Boot into Hekate (steps 3b. to 3c.)
    • 11d. Mount the SD card to your computer in Hekate (steps 4a. to 4c.)
    • 11e. Navigate to your SD card drive and create a folder named Checkpoint within the switch folder of your SD card and place the Checkpoint.nro file inside it.
    • 11f. Once you’re done, safely eject the SD card drive in your computer and return to the Hekate Home menu. (steps 5a. to 5b.)
    • 11g. Tap on Payloads. This will show a list of payloads.
    • 11h. Tap on fusee-primary.bin in the list of payloads.
    • 11i. Your Switch will launch into Custom Firmware Mode (CFW), and once your Switch has booted into the home menu, press and hold the R button on your controller and launch a game. This will launch the Homebrew Menu in title override mode.
    • 11j. Either use the touchscreen or navigate using your controller, and choose Checkpoint.
    • 11k. Pick the games that you want to dump their save files (multiselect with the Y button), and press the L button to backup the saves.
    • 11l. Once you have backed up the save files, press any button to return to the previous menu and then press + to return to the Homebrew Menu.
    • 11m. Select Reboot to Payload and then press - on your controller to return to the Hekate menu.
    • 11n. Mount the SD card to your computer in Hekate (steps 4a. to 4c.)
    • 11o. Navigate to your SD card drive. Your save files will be located in the switch/Checkpoint folder.
    • 11p. Follow the instructions in the How do I add a Save to my Game section of our FAQ.
    • 11q. Once you’re done transferring your save files, safely eject the SD card drive in your computer and return to the Hekate Home menu. (steps 5a. to 5b.)

Rebooting the Switch Back to its Original State

  1. If you’re done following the sections you needed for yuzu, we will now reboot the Switch back to its original state.
    • 12a. From the Hekate Home Menu, tap on Reboot.
    • 12b. Tap on OFW.
    • 12c. Your Switch will now reboot into the original firmware.

Running yuzu

  1. We will now run yuzu to verify that your dumped keys and games are being read correctly.
    • 9a. Run either the yuzu or yuzu Early Access shortcuts that were created by the yuzu installer tool.
    • 9b. in yuzu, click on + Add New Game Directory in the browser, and navigate to the folder where you placed your XCI or NSP files.

Yuzu Reader Login In

If you need any help during this process or get a strange error during or while using yuzu, feel free to ask for help on the yuzu discord! Happy Emulating!