From 727d759275400ff4efcb015db22f8099b8c256f8 Mon Sep 17 00:00:00 2001
From: Morph <39850852+Morph1984@users.noreply.github.com>
Date: Sun, 2 Feb 2020 13:44:37 -0500
Subject: [PATCH] Update the Quickstart Guide (#162)
* Update the Quickstart Guide
- Replaced Kosmos with Atmosphere
- Added save file dumping section
- Provided more detail in some sections
* fix numbers
* Update index.md
* Update index.md
* address feedback
* Update index.md
---
site/content/help/quickstart/index.md | 199 ++++++++++++-------
site/content/help/quickstart/sd_template.png | Bin 69639 -> 38132 bytes
2 files changed, 122 insertions(+), 77 deletions(-)
diff --git a/site/content/help/quickstart/index.md b/site/content/help/quickstart/index.md
index 7a31fdd8..a575a355 100644
--- a/site/content/help/quickstart/index.md
+++ b/site/content/help/quickstart/index.md
@@ -4,12 +4,13 @@ description: A guide designed to get you started with yuzu quickly.
---
{{< youtube RwojT7zPVhI >}}
+
-## Hardware Requirements
+# Hardware Requirements
-| | CPU | GPU | RAM |
-|----- |--- |--- |--- |
+| | CPU | GPU | RAM |
+|-------|-------|-------|-------|
|**Minimum (for 2D games)**|Intel Core i3-6100 / AMD Ryzen 3 1200|Intel HD Graphics 520 / NVIDIA GeForce GT 1030 / AMD Radeon R7 240|8GB|
|**Recommended (for 3D games)**|Intel Core i5-8600K / AMD Ryzen 5 3600|NVIDIA GeForce GTX 1060 6GB / AMD Radeon RX 470 8GB|16GB|
@@ -24,45 +25,63 @@ Sample Image:
# yuzu Quickstart Guide
-To start playing games, yuzu needs a couple of different files and directories from your switch in order to play them properly.
-To see if your Switch is hackable, visit https://damota.me/ssnc/checker and test your Switch's serial number.
-If your Switch is patched, you will be unable to complete the following steps.
+To start playing 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.
+
+ - If your Switch is patched, you will be unable to complete the following steps.
+ - The Switch v2 (Mariko) and the Switch Lite are both patched and you will not be able to complete the following steps.
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.
-Make sure to place your Nintendo Switch into Airplane mode before starting this guide.
This process should take about 60 to 90 minutes.
-## Prerequisites
-- A Nintendo Switch vulnerable to fusee-gelee, RCM (purchased before July 2018 will definitely work, purchased after has a lower probability of working)
-- An SD card with at least ~29 GB of free space (an almost empty 32GB card will work)
-- [TegraRCMGui](https://github.com/eliboa/TegraRcmGUI/releases)
-- [Hekate](https://github.com/CTCaer/hekate/releases/)
-- [Kosmos](https://github.com/AtlasNX/Kosmos/releases/)
-- [Lockpick](https://github.com/shchmue/Lockpick/releases)
-- [Lockpick_RCM](https://github.com/shchmue/Lockpick_RCM/releases)
-- [nxdumptool](http://switchbru.com/appstore/#/app/gcdumptool)
+**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](https://github.com/eliboa/TegraRcmGUI/releases) -- Download the TegraRcmGUI installer
+- [Hekate](https://github.com/CTCaer/hekate/releases) -- Download the `hekate` zip file
+- [Atmosphere](https://github.com/Atmosphere-NX/Atmosphere/releases) -- Download both the `atmosphere` zip file and `fusee-primary.bin`
+- [Lockpick_RCM](https://github.com/shchmue/Lockpick_RCM/releases) -- Download `Lockpick_RCM.bin`
+- [nxdumptool](https://github.com/DarkMatterCore/nxdumptool/releases) -- Download `nxdumptool.nro`
- [Copy Script](https://yuzu-emu.org/help/quickstart/yuzu_copy.bat)
- [HacDiskMount](https://files.sshnuke.net/HacDiskMount1055.zip)
-- [microSD Card Reader](https://www.amazon.com/Anker-Portable-Reader-RS-MMC-Micro/dp/B006T9B6R2/ref=sr_1_4?s=pc&ie=UTF8&qid=1538875513&sr=1-4&keywords=micro+sd+card+reader) -- If your computer has one built-in, you can use that
-- [RCM Jig](https://www.amazon.com/gp/product/B07FP3PC4R/ref=oh_aui_detailpage_o03_s00?ie=UTF8&psc=1) <-- we highly recommend one like this, but you could use any of the methods outlined [here](https://noirscape.github.io/RCM-Guide/)
+- [microSD Card Reader](https://www.amazon.com/dp/B006T9B6R2) -- If your computer has one built-in, you can use that
+- [RCM Jig](https://www.amazon.com/dp/B07J9JJRRG) <-- We highly recommend one like this, but you could use any of the methods outlined [here](https://noirscape.github.io/RCM-Guide/)
`%YUZU_DIR%` is the home directory for yuzu on your computer:
- - For Windows, this is `C:\Users\$username$\AppData\Roaming\yuzu`
- - For Linux, this is `~/.local/share/yuzu`
-
+ - For Windows, this is '%APPDATA%\yuzu' or 'C:\Users\{username}\AppData\Roaming\yuzu'
+ - For Linux, this is '~/.local/share/yuzu'
-## Dumping BIS Keys
-1. We will now dump your BIS (Built-In Storage) keys for use in later decryption.
- - 1a. Run the TegraRCMGui installer you downloaded from the prerequisites, and after installation, start the program.
- - 1b. In the `Settings` tab, click on `Install Driver` which will install the drivers necessary for your computer to interface with your Nintendo Switch.
- - 1c. After the drivers have been installed, plug your Nintendo Switch into your computer.
- - 1d. Power off your Switch while it is still connected to your computer.
- - 1e. 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 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 1d and try again.
- - 1f. In the program TegraRCMGui you should see the Nintendo Switch icon in the lower left corner flash green and state `RCM O.K.`
- - 1g. In the `Tools` tab of TegraRCMGui, click on `biskeydump (by rajkosto)`.
- - 1h. Your Switch will briefly flash with a blue QR code, you may or may not see this, and immediately your computer will prompt you to save a text document titled `BIS_keys.txt` Navigate to `%YUZU_DIR%/keys` and save the file as `console.keys`. Open the file to make sure you have copied:
+# Preparing the microSD Card
+
+1. We will now prepare the microSD card.
+ - 1a. Extract the contents of the `atmosphere` and `hekate` zip files into the root of your SD card.
+ - 1b. Place the `fusee-primary.bin` and `Lockpick_RCM.bin` files into the `bootloader/payloads` folder of the SD card.
+ - 1c. Create a folder named `nxdumptool` within the `switch` folder of your SD card and place the `nxdumptool.nro` file inside it.
+ - 1d. Once done, eject the SD card and place it into your Nintendo Switch.
+
+{{< imgs
+ "./sd_template.png|Your SD card should look like this."
+>}}
+
+# Dumping BIS Keys
+
+2. We will now dump your BIS (Built-In Storage) keys for use in later decryption.
+ - 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 1d and try again.
+ - 2f. In the program TegraRcmGUI you should see the Nintendo Switch icon in the lower left corner flash green and state `RCM O.K.`
+ - 2g. In the `Tools` tab of TegraRcmGUI, click on `biskeydump (by rajkosto)`.
+ - 2h. Your Switch will briefly flash with a blue QR code (you may or may not see this) and your computer will prompt you to save a text document titled `BIS_keys.txt`. Navigate to `%YUZU_DIR%/keys` and save the file as `console.keys`. Open the file to make sure you have the following key entries.
- `HWI`
- `SBK`
- `TSEC KEY`
@@ -76,61 +95,87 @@ This process should take about 60 to 90 minutes.
- `BIS KEY 3 (tweak)`
-# Dumping Prod.keys, and Title.keys
-2. We will now dump your `prod.keys` and `title.keys` for decryption of your game files.
- - 2a. Extract the contents of the Kosmos package you downloaded earlier from the prerequisites onto the root of your SD card. Place the `Lockpick.nro`, you downloaded earlier, into the `switch` folder of your SD card, and place the `Lockpick_RCM.bin`, you downloaded earlier, into the `bootloader/payloads` folder of the SD card. Place the SD card back into your Nintendo Switch.
- 
- Your SD card should look like something like this
- - 2b. Boot your Nintendo Switch into RCM mode, and make sure it is connected to your computer.
- - 2c. Run TegraRCMGui, and in the `Payload` tab of TegraRCMGui, click on the folder icon and navigate to the `Hekate` file you downloaded earlier from the prerequisites.
- - 2d. When you have successfully booted into the Hekate menu, click on `Payloads`. This will show a list of payloads.
- - 2e. Click on `Lockpick_RCM.bin` in the list of payloads.
- - 2f. After Lockpick_RCM has successfully booted, Press the power button to select `Dump from SysNAND`.
- - 2g. It will prompt you to press `VOL+` or `VOL-` to reboot to sept. Do as it says and it will start dumping process.
- - 2h. After Lockpick_RCM has finished deriving the keys, please make note of the location of the key file. Default is: `sd:/switch/prod.keys` and `sd:/switch/title.keys`.
- - 2i. With both `prod.keys` and `title.keys` dumped from your Nintendo Switch, place them in the `%YUZU_DIR%/keys` directory.
+# Dumping Prod.keys and Title.keys
+
+3. We will now dump your `prod.keys` and `title.keys` for decryption of your game files.
+ - 3a. Boot your Nintendo Switch into RCM mode (steps 2d to 2f) and make sure it is connected to your computer.
+ - 3b. Extract the `hekate.bin` file from the `hekate` zip file you downloaded from the prerequisites.
+ - 3c. Run TegraRcmGUI. In the `Payload` tab of TegraRcmGUI, click on the folder icon and navigate to the `hekate.bin` file you extracted earlier.
+ - 3d. Click on `Inject Payload` and your Switch will boot into the Hekate menu.
+ - 3e. When it has successfully booted into the Hekate menu, tap on `Payloads`. This will show a list of payloads.
+ - 3f. Tap on `Lockpick_RCM.bin` in the list of payloads.
+ - 3g. After Lockpick_RCM has successfully booted, press the power button to select `Dump from SysNAND`.
+ - 3h. It will automatically boot to sept and start deriving the keys. Wait for it to finish deriving the keys.
+ - 3i. 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`.
+ - 3j. Press any key to return to the menu, then navigate with the VOL+/VOL- buttons to highlight and select `Power Off` by pressing the power button.
+ - 3h. Once your Switch is powered off, remove the SD card.
+ - 3i. Insert your SD card into your computer and copy both `prod.keys` and `title.keys` to the `%YUZU_DIR%/keys` directory.
# Backing up System Files
-3. We will now boot Hekate to dump your system files:
- - 3a. Extract the contents of the Kosmos package you downloaded earlier from the prerequisites onto the root of your SD card, and place the SD card into your Nintendo Switch.
- - 3b. Run TegraRCMGui, and in the `Payload` tab of TegraRCMGui, click on the folder icon and navigate to the Hekate file you downloaded earlier from the prerequisites.
- - 3c. Click on `Inject Payload` to inject the Hekate payload. The Hekate browser will now display on your Nintendo Switch.
- - 3d. Select `Tools`, the wrench icon at the top of the screen, and select `Backup eMMC`. Underneath the `Full` section, click 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.
- - 3e. Click `Close` and select `eMMC RAW GPP`. This should take some time as your 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 30-60 minutes depending on the quality of your SD card and the default verification setting. Please keep note of the location the output file is placed.
- - 3f. Power off your switch to avoid damage to your sd card, by selecting `Back` and then selecting `Power Off` and then eject your sd card. Insert your sd card into your computer and use your file explorer to open the contents. Place the `yuzu_copy.bat` file you downloaded earlier onto to the root of your sd card. Double-click it to start combining your `rawnand.bin`, if it was dumped into sections, i.e. `rawnand.bin.00`. If your rawnand.bin dumped as one ~30gb file, then proceed with the guide.
- - 3g. If you needed to dump the rawnand.bin into sections due to lack of space on your sd card, transfer the files that did dump to a new folder on your desktop, and then resume the backup of your `eMMC RAW GPP`. After you have obtained all of the `rawnand.bin` files, add them to the same folder as before, place the `yuzu_copy.bat` file you downloaded earlier into that same folder and double-click to run. After they are combined, please proceed with the guide.
-# Move SYSTEM and USER to the yuzu directory
-4. We will now extract the necessary directories from your rawnand.bin for yuzu to read your system files.
- - 4a. Open `HacDiskMount` as Administrator (Right-click and select Run As Administrator) and go to `File > Open file` and select your `rawnand.bin`.
- - 4b. Double-click on the row marked `PRODINFO`. Under the dump to file area, click browse and pick somewhere easy to get to, like your Desktop. Dump the file as `PRODINFO.bin`. Click start and wait for it to complete. Then close the window. (NOTE: There is no need to enter any keys in the boxes at the top of the dialog at this moment.)
- - 4c. Select the row named `BCPKG2-1-Normal-Main`. Under the dump to file area, click browse and pick somewhere easy to get to, like your Desktop. Dump the file as `BCPKG2-1-Normal-Main.bin`. Click start and wait for it to complete. Again, no keys are necessary at this point. After it finishes, close the window.
- - 4d. Copy the `PRODINFO.bin` and `BCPKG2-1-Normal-Main.bin` files to the `%YUZU_DIR%/sysdata` dir.
- - 4e. Double-click on the row named `SYSTEM`. In the keys box, enter the `bis_key2_crypt` key in the crypt box and the `bis_key2_tweak` key in the tweak box and click test. If the text is red, double check your keys. If the text is blue, click on `Install` and wait until it says `Driver (ver XXXXX) installed, Service is running` where XXXXX is anything, then select `Y:` in the dropdown and click `Mount`. The application may become unresponsive for a moment. Press Windows-R and type `Y:` into the box and click OK and there will be a couple of folders with some named `Contents` and `save`. Copy all of these into `%YUZU_DIR%/nand/system`. After this is done, click `Unmount` and close the window.
- - 4f. Double-click on the row named `USER`. Enter the same key. Click `Mount`, and the tool may become unresponsive again. Once this mounts, open the new drive and copy the `Contents` and `save` folders to `%YUZU_DIR%/nand/user`. After, click `Unmount` and close the window and then the program.
- - 4g. If you have games or game data stored on your sd card, copy the `Nintendo` folder of your sd card into `%YUZU_DIR%/sdmc`.
+4. We will now boot Hekate to dump your system files:
+ - 4a. Boot your Nintendo Switch into RCM mode (steps 2d to 2f) and make sure it is connected to your computer.
+ - 4b. Run TegraRcmGUI. In the `Payload` tab of TegraRcmGUI, click on the folder icon and navigate to the `hekate.bin` file you extracted earlier. (step 3b)
+ - 4c. Click on `Inject Payload` and your Switch will boot into the Hekate menu.
+ - 4d. Select `Tools`, the wrench icon at the top of the screen, and select `Backup eMMC`. 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.
+ - 4e. Click `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.
+ - 4f. Power off your switch to avoid damage to your SD card by selecting `Back` and then selecting `Power Off` and then eject your SD card. Insert your SD card into your computer and use your file explorer to open the contents. Place the `yuzu_copy.bat` file you downloaded earlier into the root of your SD card. Double-click it to start combining your `rawnand.bin` if it was dumped into sections i.e. `rawnand.bin.00`. If your `rawnand.bin` dumped as one ~30gb file, then proceed with the guide.
+ - 4g. If you needed to dump the `rawnand.bin` into sections due to lack of space on your sd card, transfer the files that did dump to a new folder on your desktop, and then resume the backup of your `eMMC RAW GPP`. After you have obtained all of the `rawnand.bin` files, add them to the same folder as before, place the `yuzu_copy.bat` file you downloaded earlier into that same folder and double-click to run. After they are combined, please proceed with the guide.
+
+# Moving SYSTEM and USER to the yuzu directory
+
+5. We will now extract the necessary directories from your `rawnand.bin` for yuzu to read your system files.
+ - 5a. Open `HacDiskMount` as Administrator (Right-click and select Run As Administrator) and go to `File > Open file` and select your `rawnand.bin`.
+ - 5b. Double-click on the row marked `PRODINFO`. Under the dump to file area, click browse and pick somewhere easy to get to, like your Desktop. Dump the file as `PRODINFO.bin`. Click start and wait for it to complete. Then close the window. (NOTE: There is no need to enter any keys in the boxes at the top of the dialog at this moment.)
+ - 5c. Select the row named `BCPKG2-1-Normal-Main`. Under the dump to file area, click browse and pick somewhere easy to get to, like your Desktop. Dump the file as `BCPKG2-1-Normal-Main.bin`. Click start and wait for it to complete. Again, no keys are necessary at this point. After it finishes, close the window.
+ - 5d. Copy the `PRODINFO.bin` and `BCPKG2-1-Normal-Main.bin` files to the `%YUZU_DIR%/sysdata` directory.
+ - 5e. Double-click on the row named `SYSTEM`. In the keys box, enter the `bis_key2_crypt` key in the crypt box and the `bis_key2_tweak` key in the tweak box and click test. If the text is red, double check your keys. If the text is blue, click on `Install` and wait until it says `Driver (ver XXXXX) installed, Service is running` where XXXXX is anything, then select `Y:` in the dropdown and click `Mount`. The application may become unresponsive for a moment. Press Windows-R and type `Y:` into the box and click OK and there will be a couple of folders with some named `Contents` and `save`. Copy all of these into `%YUZU_DIR%/nand/system`. After this is done, click `Unmount` and close the window.
+ - 5f. Double-click on the row named `USER`. Enter the same key and click `Mount` (the tool may become unresponsive again). Once this mounts, open the new drive and copy the `Contents` and `save` folders to `%YUZU_DIR%/nand/user`. After this, click `Unmount` and close the window and then the program.
+ - 5g. If you have games or game data stored on your SD card, copy the `Nintendo` folder of your SD card into `%YUZU_DIR%/sdmc`.
-# Dumping cartridge games
-5. We will now dump the `Cartridge Image (XCI)` files from your game cartridge, to use in yuzu. Insert the game cartridge of your choice.
- - 5a. Extract the contents of the Kosmos package you downloaded earlier from the prerequisites onto the root of your SD card.
- - 5b. Extract the contents of the nxdumptool package you downloaded earlier and place the contents of the Switch folder into the Switch folder of your sd card.
- - 5c. Run TegraRCMGui, and in the `Payload` tab of TegraRCMGui, click on the folder icon and navigate to the Hekate file you downloaded earlier from the prerequisites.
- - 5d. Click on `Inject Payload` to inject the Hekate payload. The Hekate browser will now display on your Nintendo Switch.
- - 5e. In the Hekate browser on your Nintendo Switch, click on `Launch`, and then click on `CFW (SYSNAND)`. Your Switch will launch into Custom Firmware Mode (CFW), and once your Switch has booted into the home menu, while holding the `R` button, click on the Album application. This will launch the Homebrew Menu.
- - 5f. Either use the touchscreen or navigate using your controller, and choose `nxdumptool`
- - 5g. Chose the `Dump gamecard content` option.
- - 5h. Chose the `Cartridge Image (XCI) dump` option.
- - 5i. Make sure to dump the certificate with the cartridge. The options can be toggled by pressing `left` or `right`.
- - 5j. Once the cartridge image has been dumped, place it into a new folder in a location of your choice.
+# Dumping Cartridge Games
+
+6. 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.
+ - 6a. Boot your Nintendo Switch into RCM mode (steps 2d to 2f) and make sure it is connected to your computer.
+ - 6b. Run TegraRcmGUI. In the `Payload` tab of TegraRcmGUI, click on the folder icon and navigate to the `hekate.bin` file you extracted earlier. (step 3b)
+ - 6c. Click on `Inject Payload` and your Switch will boot into the Hekate menu.
+ - 6d. When it has successfully booted into the Hekate menu, tap on `Payloads`. This will show a list of payloads.
+ - 6e. Tap on `fusee-primary.bin` in the list of payloads.
+ - 6f. Your Switch will launch into Custom Firmware Mode (CFW), and once your Switch has booted into the home menu, click/tap on the Album application. This will launch the Homebrew Menu.
+ - 6g. Either use the touchscreen or navigate using your controller, and choose `nxdumptool`.
+ - 6h. Choose the `Dump gamecard content` option.
+ - 6i. Choose the `Cartridge Image (XCI) dump` option.
+ - 6j. Make sure to dump the certificate with the cartridge. The options can be toggled by pressing `left` or `right`.
+ - 6k. Once the cartridge image has been dumped, power off your switch by holding the power button for a few seconds, then select the Power Options > Turn off.
+ - 6l. With your Switch powered off, remove the SD card.
+ - 6m. Insert your SD card into your computer. If the XCI was dumped in parts combine them with this command, for example: `copy /b "Super Mario Odyssey.xc0" + "Super Mario Odyssey.xc1" "Super Mario Odyssey.xci"`. Now you can place this XCI in a game directory of your choice.
+
+# Dumping Save Files (Optional)
+
+7. We will now dump the games' save files from your switch to use in yuzu.
+ - 7a. Download [Checkpoint.nro](https://github.com/FlagBrew/Checkpoint/releases)
+ - 7b. Insert your SD card into your computer.
+ - 7c. Create a folder named `Checkpoint` within the `switch` folder of your SD card and place the `Checkpoint.nro` file inside it.
+ - 7d. Eject your SD card and place it in your Switch.
+ - 7e. Boot your Nintendo Switch into RCM mode (steps 2d to 2f) and make sure it is connected to your computer.
+ - 7f. Run TegraRcmGUI. In the `Payload` tab of TegraRcmGUI, click on the folder icon and navigate to the `hekate.bin` file you extracted earlier. (step 3b)
+ - 7g. Click on `Inject Payload` and your Switch will boot into the Hekate menu.
+ - 7h. When it has successfully booted into the Hekate menu, tap on `Payloads`. This will show a list of payloads.
+ - 7i. Tap on `fusee-primary.bin` in the list of payloads.
+ - 7j. Your Switch will launch into Custom Firmware Mode (CFW), and once your Switch has booted into the home menu, click/tap on the Album application. This will launch the Homebrew Menu.
+ - 7k. Either use the touchscreen or navigate using your controller, and choose `Checkpoint`.
+ - 7l. 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.
+ - 7m. Once you have backed up the save files, power off your switch by holding the power button for a few seconds, then select the Power Options > Turn off.
+ - 7n. With your Switch powered off, remove the SD card.
+ - 7o. Insert your SD card into your computer. Your save files will be located in the `switch/Checkpoint` folder.
# Running yuzu
-5. We will now run yuzu to verify that your keys and system files were dumped and are being read correctly by yuzu.
- - 6a. Locate the `yuzu.exe` file in the location indicated by the installer and run the program. You should see the screen populate with your games located both on your SD card and system memory.
- - 6b. If you extracted your `XCI` files from your Nintendo Switch cartridges, then, in yuzu, click on `+ Add New Game Directory` in the browser, and navigate to the folder where you placed your `XCI` files.
+8. We will now run yuzu to verify that your keys and system files were dumped and are being read correctly by yuzu.
+ - 8a. Run either the `yuzu` or `yuzu Early Access` shortcuts that were created by the yuzu installer tool. If you have moved your `Nintendo` folder from your SD card to `%YUZU_DIR%/sdmc` you should see your SD installed games populate.
+ - 8b. If you extracted your `XCI` files from your Nintendo Switch cartridges, then, in yuzu, click on `+ Add New Game Directory` in the browser, and navigate to the folder where you placed your `XCI` files.
### 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!
-
diff --git a/site/content/help/quickstart/sd_template.png b/site/content/help/quickstart/sd_template.png
index 8d14028cf09dc2c19fabae43e54869518d5ed0fa..fec5f46c65206679171c72bf9c2b8ec0d89a1ccc 100644
GIT binary patch
literal 38132
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