ihaveahax 1 month ago committed by GitHub
commit 6f3b6810b8
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

@ -1,7 +1,6 @@
- **User Guide**
- [Introduction](introduction)
- [Aroma](aroma/getting-started)
- **vWii**
- [vWii Modding](vwii/sd-preparation)
- **Troubleshooting**
- [Common Issues & Fixes](common-issues-fixes)

@ -12,11 +12,11 @@
- **FSGetMountSource failed:** Same as -3 above, means no SD Card detected. Re-insert the SD and try again. This could also mean that the SD card is locked (Slider is down instead of up) or the SD card label is "WIIU", which is stated in the guide causes conflict. If it's not any of these issues, refer to the last suggestion from -3.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder, and the wiiu folder on the root.
- **FSOpenFile failed:** Missing `homebrew_launcher` on SD. Make sure you have `homebrew_launcher.elf` in the <code>/wiiu<wbr>/apps<wbr>/homebrew_launcher</code> folder.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly, and it is not damaged. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
### Data Management asks to delete unnecessary data, what does it mean?

@ -11,7 +11,7 @@ Currently, every time you want to launch Tiramisu you will have to launch the He
1. Press A to select `Check`.
1. Select `Boot options`.
1. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
1. When the process finished, press A to shutdown the console.
1. When the process is finished, press A to shutdown the console.
1. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console. You cannot change the boot title until you set a default environment first.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.

@ -14,7 +14,7 @@ We are going to make the Tiramisu environment start automatically when your cons
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting up.
1. On the Tiramisu Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Tiramisu Boot Selector in the future, you have hold START (+) while your Wii U is booting up.
- To open the Tiramisu Boot Selector in the future, you have to hold START (+) while your Wii U is booting up.
?> Once you're booted into the Tiramisu environment, you can open the Mii Maker at any time to get into the Homebrew Launcher. <br>Homebrew Launcher will be empty for first-time modders. Follow the rest of the guide to install apps into the Homebrew Launcher. <br>To get back into the Mii Maker, simply press the HOME button while in the Homebrew Launcher.

@ -18,7 +18,7 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
1. Press the A button to start the dumping process.
1. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. The files will appear on the root of the SD card.
1. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` (and if you chose to go with a full backup, `every mlc.bin.part`) file to your computer.
1. Delete the files from your SD Card to free up space.

@ -4,9 +4,11 @@
Currently, every time you want to launch Aroma you will have to launch the Health and Safety information app. If you wish to automatically launch into Aroma on every boot, you can autoboot the Health and Safety Information app.
If you don't want to autoboot Aroma, you can skip this step and follow the Setting Up PayloadLoader section below.
### Instructions
1. Start the console to boot into the Wii U Menu, launch the Health and Safety Information app.
1. Start the console to boot into the Wii U Menu, and then launch the Health and Safety Information app.
2. Press A to launch the `aroma` environment.
3. Press A to launch the Wii U Menu.
4. Once you are at the Wii U Menu, launch the PayloadLoader Installer.
@ -15,6 +17,22 @@ Currently, every time you want to launch Aroma you will have to launch the Healt
7. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
8. When the process has finished, press A to shutdown the console.
9. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console.
### Setting up PayloadLoader, Environment Loader and Aroma
Now, we are going to make the Aroma environment start automatically when your console loads the Health and Safety Information app and select Wii U Menu as the default boot option.
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
2. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
3. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
4. Aroma will now be launched each time you boot the console (or load Health and Safety) and then straight into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have to hold START (+) while the console is booting or loading the Health and Safety Information app.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.
- Press A to launch the selected title.

@ -11,3 +11,5 @@ Make sure your Wii U has internet access for this step.
3. Click on `Run Exploit!` and hold the B button until you see a screen that says `Please choose your payload:`, this will be necessary for the next steps.
- If your Wii U gets stuck on a white or otherwise frozen screen, wait a few seconds. If nothing happens, reboot the console, [reset the browser's save data](https://en-americas-support.nintendo.com/app/answers/detail/a_id/1507/~/how-to-delete-the-internet-browser-history) and try again.
- If you see the EnvironmentLoader, you did not hold down B long enough. Try again.
?> If you get any errors like FSOpenfile failed, FSGetMountSorce failed, or SD Mount failed, refer to the browser errors in [Common Issues and Fixes](../common-issues-fixes).

@ -4,21 +4,8 @@
Now that PayloadLoader, Environment Loader and Aroma are installed, we are going to finalize the setup.
We are going to make the Aroma environment start automatically when your console autoboots the Health and Safety Information app (or when manually launching it if you chose not to autoboot it) and select Wii U Menu as default as well as getting additional homebrew apps. Please note that the following steps assumes you are autobooting the Health and Safety Information app.
### Setting up PayloadLoader, Environment Loader and Aroma
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
1. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
1. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have hold START (+) while the console is booting or loading the Health and Safety Information app.
### Blocking Updates
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Tiramisu, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Aroma, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
### Additional Homebrew Apps
@ -47,9 +34,15 @@ While Aroma's PayloadLoader already has built-in update blocking functionality,
| [Bloopair](https://github.com/GaryOderNichts/Bloopair/) ([Download](https://github.com/GaryOderNichts/Bloopair/releases)) | Allows wirelessly connecting most popular Bluetooth capable controllers. | 1. Extract the contents of the newly downloaded `Bloopair_vX.X.X.zip` file. <br> 2. Copy the `30_bloopair.rpx` to the `wiiu/environments/aroma/modules/setup/` folder on the root of your SD Card. <br> 3. Copy the `wiiu` folder to the root of your SD Card. |
| [Screenshot Plugin](https://github.com/wiiu-env/ScreenshotWUPS/) ([Download](https://github.com/wiiu-env/ScreenshotWUPS/releases)) | Allows taking screenshots directly to the SD Card. | 1. Extract the downloaded `screenshot_plugin_vX_X.zip` file. <br> 2. Copy the `screenshot.wps` to the `wiiu/environments/aroma/plugins` folder on the root of your SD Card. |
### Booting Tiramisu
### Pretendo Network
Pretendo is a replacement service for the Nintendo Network, which brings back online services as they are set to be discontinued. It also revives the Miiverse service, via juxtaposition. The official guide can be found [here](https://pretendo.network/docs/install/wiiu).
### Booting Tiramisu (optional)
?> Tiramisu is now archived, and was succeeded by Aroma and considered outdated. No more Homebrew will be developed for it, and services like Pretendo have ended support for it.
If you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
However, if you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
1. Download the latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
1. Copy the `wiiu` folder to the root of your SD Card.
@ -57,6 +50,7 @@ If you find the need to boot into Tiramisu, for example, to use a legacy Homebre
1. Take the SD Card out of your computer and plug it into your Wii U console.
1. Start the EnvironmentLoader.
- If you're autobooting into it, this can be done by powering on your console and holding X.
- You do not need to reinstall the PayloadLoader if you already did so with Aroma.
1. Highlight the entry called `tiramisu` using the D-Pad.
1. Launch Tiramisu by pressing A.
1. Launch the Wii U Menu by pressing A.

@ -15,7 +15,7 @@ For a detailed overview check out [this blogpost](https://maschell.github.io/hom
#### Modules
Aroma supports modules, which unlike setup modules, always run in the background.
This allows further extending the functionality of the console.
This allows for further extending the functionality of the console.
#### Plugins

@ -15,6 +15,7 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
1. Take the SD Card out of your PC and plug it into your Wii U.
2. Execute the web browser exploit as [previously explained](browser-exploit) but this time, you will need to hold the X button to open the Environment Loader menu.
3. Press A to launch the `aroma` environment.
- You will get a warning message about the update folder existing. This is normal. Press A to continue.
4. Press A to launch the Wii U Menu.
5. At the Wii U Menu, look for the newly appeared `PayloadLoader Installer` title (the round circle with an A inside of it) and launch it.
6. Press the A button to check if you can install the PayloadLoader.
@ -22,5 +23,3 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
7. Press the A button to select `Install / Update`.
8. You'll be asked if you are sure you want to install the PayloadLoader. Use the D-Pad to select `Install` and press A.
9. After installing has finished, press A to shut down the console.
!> If you do not wish to autoboot Aroma on your console, you can skip the `Autobooting Aroma` part and head directly to [Finalizing Setup](finalizing-setup).

@ -18,6 +18,6 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
3. Press the A button to start the dumping process.
4. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
4. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
5. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` and if you chose to go with a full backup, `every mlc.bin.part` file to your computer.
6. Delete the files from your SD Card to free up space.

@ -7,22 +7,20 @@ We will now place the required Aroma files on the SD Card.
?> **Notice** Your SD Card will need to be formatted as FAT32. If your SD Card is not formatted to FAT32, use [GUIFormat](http://ridgecrop.co.uk/index.htm?guiformat.htm) with 32k (32768) allocation unit size to format it.
**Do not** label the SD Card as `wiiu` or it will cause issues with homebrew.
### What You Need
- The latest files from the [Aroma download page](https://aroma.foryour.cafe).
1. Scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
- The latest release of the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases).
### Instructions
1. On the [Aroma](https://aroma.foryour.cafe) site, scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
1. Download the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases/download/v0.1/PayloadLoaderInstaller_20220905-105329.zip)
1. Insert your Wii U's SD Card into your PC.
1. **Extract** and copy the `wiiu` folder of the three newly downloaded *`.zip`* files to the root of your SD Card.
- The three `wiiu` folders should be merged if not done automatically.
?> If your computer asks you to overwrite existing files on your SD Card, you will need to click yes.
?> If you're on a Mac machine, select `Merge` instead of replace. If the merge option does not show immediately, press and hold the `Option` key while moving files to the root.
----------
### SD Card Layout {docsify-ignore}

@ -47,6 +47,8 @@ This guide has the end goal of taking a completely unmodified Wii U from stock t
>
> A 32GB SD Card will be enough for most use-cases. A Micro SD Card in an adapter will work fine.
?> **If you have an existing legacy CFW setup** </br> For **CBHC** users: Go to the [Uninstall CBHC](../uninstall-cbhc) page to uninstall CBHC. </br> For **Haxchi** users: Uninstall the Haxchi app from Data Management in the System Settings app. </br> For **Mocha CFW (Indexiine)** users: Go to the [Uninstall Indexiine](../uninstall-indexiine) page to uninstall Indexiine. </br> For **Mocha CFW (Online Exploit)** users: You do not need to do anything before following this guide.
If everything goes according to plan, you will lose no data and end up with everything that you started with (games, saves, NNID, etc, will be preserved).
Keep your device plugged in throughout the entire process to avoid data loss or damage from an unexpected power-off.

@ -2,8 +2,6 @@
## Installing cIOSes
!> Make sure you have no `.wad` files anywhere else than in the `apps` folder on your SD Card.
1. Power on your Wii U and launch vWii.
2. Launch The Homebrew Channel.
3. Launch d2x cIOS Installer.

@ -2,9 +2,8 @@
## Installing the Homebrew Channel
1. Boot into [Tiramisu](browser-exploit).
2. Launch the Homebrew Launcher, by opening the Mii Maker.
3. Launch the vWii Compat Installer.
4. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
5. Launch vWii (the Wii Menu icon).
1. Boot into [Aroma](browser-exploit).
2. Launch the `vWii Compat Installer` from the Wii U Menu.
3. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
4. Launch vWii (the Wii Menu icon).
- If the installation has succeeded, you should see the Homebrew Channel in your Wii Menu.

@ -2,7 +2,7 @@
## NAND Backup
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it.
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it, or you can completely [reinstall the vWii](http://wiiu.hacks.guide/#/recover-vwii-ioses-channels).
?> If you have recently made a NAND backup that includes SLCCMPT and OTP, feel free to skip this step.

@ -12,6 +12,6 @@ Patching IOS 80 allows you to have custom channels on the SD card, including wad
4. Wait until it says <code>IOS80 <wbr>Installation <wbr>is <wbr>complete!</code>.
5. Press any button to exit.
!> Installing custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing a custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing any IOS (including TED IOSes) or wads made for the original Wii on your vWii will brick it. WiiWare wads are fine, but some need to be converted to work.

@ -13,12 +13,15 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
?> If you have hacked your Wii U in the past, you can use the same SD Card for this process.
?> Unlike Wii U homebrew, vWii apps go in a separate `apps` folder on the root. Compat Installer is the **only** Wii U app here.
### What You Need
- The latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
- Click on `Download Tiramisu`.
- If you have already installed Tiramisu, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hb-app.store/wiiu/CompatTitleInstaller).
- The latest files from [Aroma for your café](https://aroma.foryour.cafe).
- Click on `Download Payloads` and `Download Base Aroma`.
- Read through the steps and click on the checkboxes.
- If you have already installed Aroma, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hbas-frontend.b-cdn.net/wiiu/CompatTitleInstaller).
- The <a href="docs/files/Patched_IOS80_Installer_for_vWii.zip" download>Patched IOS 80 Installer for vWii</a>. ([Source](https://github.com/Lazr1026/Patched-IOS80-Installer-for-vWii))
- The <a href ="docs/files/d2x_cIOS_Installer.zip" download>d2x cIOS Installer</a>.
@ -27,6 +30,6 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
1. Insert your Wii U's SD Card into your PC.
2. Copy the `apps` folder from the `Patched_IOS80_Installer_for_vWii.zip` file to the root of your SD Card.
3. Copy the `d2x-cios-installer` from the `d2x_cIOS_Installer.zip` file to the apps folder on the root of your SD Card.
4. Copy the contents of the downloaded Tiramisu _`.zip`_ file to the root of your SD Card.
4. Copy the contents of the downloaded Base Aroma and payloads `.zip` files to the root of your SD Card.
5. Copy the contents of the `CompatTitleInstaller.zip` file to the root of your SD Card.
6. Take the SD Card out of your computer and plug it into your Wii U console.

@ -1,7 +1,6 @@
- **User Guide**
- [Introduction](introduction)
- [Aroma](aroma/getting-started)
- **vWii**
- [vWii Modding](vwii/sd-preparation)
- **Troubleshooting**
- [Common Issues & Fixes](common-issues-fixes)

@ -12,11 +12,11 @@
- **FSGetMountSource failed:** Same as -3 above, means no SD Card detected. Re-insert the SD and try again. This could also mean that the SD card is locked (Slider is down instead of up) or the SD card label is "WIIU", which is stated in the guide causes conflict. If it's not any of these issues, refer to the last suggestion from -3.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder, and the wiiu folder on the root.
- **FSOpenFile failed:** Missing `homebrew_launcher` on SD. Make sure you have `homebrew_launcher.elf` in the <code>/wiiu<wbr>/apps<wbr>/homebrew_launcher</code> folder.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly, and it is not damaged. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
### Data Management asks to delete unnecessary data, what does it mean?

@ -11,7 +11,7 @@ Currently, every time you want to launch Tiramisu you will have to launch the He
1. Press A to select `Check`.
1. Select `Boot options`.
1. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
1. When the process finished, press A to shutdown the console.
1. When the process is finished, press A to shutdown the console.
1. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console. You cannot change the boot title until you set a default environment first.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.

@ -14,7 +14,7 @@ We are going to make the Tiramisu environment start automatically when your cons
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting up.
1. On the Tiramisu Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Tiramisu Boot Selector in the future, you have hold START (+) while your Wii U is booting up.
- To open the Tiramisu Boot Selector in the future, you have to hold START (+) while your Wii U is booting up.
?> Once you're booted into the Tiramisu environment, you can open the Mii Maker at any time to get into the Homebrew Launcher. <br>Homebrew Launcher will be empty for first-time modders. Follow the rest of the guide to install apps into the Homebrew Launcher. <br>To get back into the Mii Maker, simply press the HOME button while in the Homebrew Launcher.

@ -18,7 +18,7 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
1. Press the A button to start the dumping process.
1. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. The files will appear on the root of the SD card.
1. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` (and if you chose to go with a full backup, `every mlc.bin.part`) file to your computer.
1. Delete the files from your SD Card to free up space.

@ -4,9 +4,11 @@
Currently, every time you want to launch Aroma you will have to launch the Health and Safety information app. If you wish to automatically launch into Aroma on every boot, you can autoboot the Health and Safety Information app.
If you don't want to autoboot Aroma, you can skip this step and follow the Setting Up PayloadLoader section below.
### Instructions
1. Start the console to boot into the Wii U Menu, launch the Health and Safety Information app.
1. Start the console to boot into the Wii U Menu, and then launch the Health and Safety Information app.
2. Press A to launch the `aroma` environment.
3. Press A to launch the Wii U Menu.
4. Once you are at the Wii U Menu, launch the PayloadLoader Installer.
@ -15,6 +17,22 @@ Currently, every time you want to launch Aroma you will have to launch the Healt
7. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
8. When the process has finished, press A to shutdown the console.
9. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console.
### Setting up PayloadLoader, Environment Loader and Aroma
Now, we are going to make the Aroma environment start automatically when your console loads the Health and Safety Information app and select Wii U Menu as the default boot option.
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
2. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
3. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
4. Aroma will now be launched each time you boot the console (or load Health and Safety) and then straight into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have to hold START (+) while the console is booting or loading the Health and Safety Information app.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.
- Press A to launch the selected title.

@ -11,3 +11,5 @@ Make sure your Wii U has internet access for this step.
3. Click on `Run Exploit!` and hold the B button until you see a screen that says `Please choose your payload:`, this will be necessary for the next steps.
- If your Wii U gets stuck on a white or otherwise frozen screen, wait a few seconds. If nothing happens, reboot the console, [reset the browser's save data](https://en-americas-support.nintendo.com/app/answers/detail/a_id/1507/~/how-to-delete-the-internet-browser-history) and try again.
- If you see the EnvironmentLoader, you did not hold down B long enough. Try again.
?> If you get any errors like FSOpenfile failed, FSGetMountSorce failed, or SD Mount failed, refer to the browser errors in [Common Issues and Fixes](../common-issues-fixes).

@ -4,21 +4,8 @@
Now that PayloadLoader, Environment Loader and Aroma are installed, we are going to finalize the setup.
We are going to make the Aroma environment start automatically when your console autoboots the Health and Safety Information app (or when manually launching it if you chose not to autoboot it) and select Wii U Menu as default as well as getting additional homebrew apps. Please note that the following steps assumes you are autobooting the Health and Safety Information app.
### Setting up PayloadLoader, Environment Loader and Aroma
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
1. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
1. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have hold START (+) while the console is booting or loading the Health and Safety Information app.
### Blocking Updates
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Tiramisu, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Aroma, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
### Additional Homebrew Apps
@ -47,9 +34,15 @@ While Aroma's PayloadLoader already has built-in update blocking functionality,
| [Bloopair](https://github.com/GaryOderNichts/Bloopair/) ([Download](https://github.com/GaryOderNichts/Bloopair/releases)) | Allows wirelessly connecting most popular Bluetooth capable controllers. | 1. Extract the contents of the newly downloaded `Bloopair_vX.X.X.zip` file. <br> 2. Copy the `30_bloopair.rpx` to the `wiiu/environments/aroma/modules/setup/` folder on the root of your SD Card. <br> 3. Copy the `wiiu` folder to the root of your SD Card. |
| [Screenshot Plugin](https://github.com/wiiu-env/ScreenshotWUPS/) ([Download](https://github.com/wiiu-env/ScreenshotWUPS/releases)) | Allows taking screenshots directly to the SD Card. | 1. Extract the downloaded `screenshot_plugin_vX_X.zip` file. <br> 2. Copy the `screenshot.wps` to the `wiiu/environments/aroma/plugins` folder on the root of your SD Card. |
### Booting Tiramisu
### Pretendo Network
Pretendo is a replacement service for the Nintendo Network, which brings back online services as they are set to be discontinued. It also revives the Miiverse service, via juxtaposition. The official guide can be found [here](https://pretendo.network/docs/install/wiiu).
### Booting Tiramisu (optional)
?> Tiramisu is now archived, and was succeeded by Aroma and considered outdated. No more Homebrew will be developed for it, and services like Pretendo have ended support for it.
If you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
However, if you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
1. Download the latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
1. Copy the `wiiu` folder to the root of your SD Card.
@ -57,6 +50,7 @@ If you find the need to boot into Tiramisu, for example, to use a legacy Homebre
1. Take the SD Card out of your computer and plug it into your Wii U console.
1. Start the EnvironmentLoader.
- If you're autobooting into it, this can be done by powering on your console and holding X.
- You do not need to reinstall the PayloadLoader if you already did so with Aroma.
1. Highlight the entry called `tiramisu` using the D-Pad.
1. Launch Tiramisu by pressing A.
1. Launch the Wii U Menu by pressing A.

@ -15,7 +15,7 @@ For a detailed overview check out [this blogpost](https://maschell.github.io/hom
#### Modules
Aroma supports modules, which unlike setup modules, always run in the background.
This allows further extending the functionality of the console.
This allows for further extending the functionality of the console.
#### Plugins

@ -15,6 +15,7 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
1. Take the SD Card out of your PC and plug it into your Wii U.
2. Execute the web browser exploit as [previously explained](browser-exploit) but this time, you will need to hold the X button to open the Environment Loader menu.
3. Press A to launch the `aroma` environment.
- You will get a warning message about the update folder existing. This is normal. Press A to continue.
4. Press A to launch the Wii U Menu.
5. At the Wii U Menu, look for the newly appeared `PayloadLoader Installer` title (the round circle with an A inside of it) and launch it.
6. Press the A button to check if you can install the PayloadLoader.
@ -22,5 +23,3 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
7. Press the A button to select `Install / Update`.
8. You'll be asked if you are sure you want to install the PayloadLoader. Use the D-Pad to select `Install` and press A.
9. After installing has finished, press A to shut down the console.
!> If you do not wish to autoboot Aroma on your console, you can skip the `Autobooting Aroma` part and head directly to [Finalizing Setup](finalizing-setup).

@ -18,6 +18,6 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
3. Press the A button to start the dumping process.
4. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
4. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
5. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` and if you chose to go with a full backup, `every mlc.bin.part` file to your computer.
6. Delete the files from your SD Card to free up space.

@ -7,22 +7,20 @@ We will now place the required Aroma files on the SD Card.
?> **Notice** Your SD Card will need to be formatted as FAT32. If your SD Card is not formatted to FAT32, use [GUIFormat](http://ridgecrop.co.uk/index.htm?guiformat.htm) with 32k (32768) allocation unit size to format it.
**Do not** label the SD Card as `wiiu` or it will cause issues with homebrew.
### What You Need
- The latest files from the [Aroma download page](https://aroma.foryour.cafe).
1. Scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
- The latest release of the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases).
### Instructions
1. On the [Aroma](https://aroma.foryour.cafe) site, scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
1. Download the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases/download/v0.1/PayloadLoaderInstaller_20220905-105329.zip)
1. Insert your Wii U's SD Card into your PC.
1. **Extract** and copy the `wiiu` folder of the three newly downloaded *`.zip`* files to the root of your SD Card.
- The three `wiiu` folders should be merged if not done automatically.
?> If your computer asks you to overwrite existing files on your SD Card, you will need to click yes.
?> If you're on a Mac machine, select `Merge` instead of replace. If the merge option does not show immediately, press and hold the `Option` key while moving files to the root.
----------
### SD Card Layout {docsify-ignore}

@ -47,6 +47,8 @@ This guide has the end goal of taking a completely unmodified Wii U from stock t
>
> A 32GB SD Card will be enough for most use-cases. A Micro SD Card in an adapter will work fine.
?> **If you have an existing legacy CFW setup** </br> For **CBHC** users: Go to the [Uninstall CBHC](../uninstall-cbhc) page to uninstall CBHC. </br> For **Haxchi** users: Uninstall the Haxchi app from Data Management in the System Settings app. </br> For **Mocha CFW (Indexiine)** users: Go to the [Uninstall Indexiine](../uninstall-indexiine) page to uninstall Indexiine. </br> For **Mocha CFW (Online Exploit)** users: You do not need to do anything before following this guide.
If everything goes according to plan, you will lose no data and end up with everything that you started with (games, saves, NNID, etc, will be preserved).
Keep your device plugged in throughout the entire process to avoid data loss or damage from an unexpected power-off.

@ -2,8 +2,6 @@
## Installing cIOSes
!> Make sure you have no `.wad` files anywhere else than in the `apps` folder on your SD Card.
1. Power on your Wii U and launch vWii.
2. Launch The Homebrew Channel.
3. Launch d2x cIOS Installer.

@ -2,9 +2,8 @@
## Installing the Homebrew Channel
1. Boot into [Tiramisu](browser-exploit).
2. Launch the Homebrew Launcher, by opening the Mii Maker.
3. Launch the vWii Compat Installer.
4. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
5. Launch vWii (the Wii Menu icon).
1. Boot into [Aroma](browser-exploit).
2. Launch the `vWii Compat Installer` from the Wii U Menu.
3. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
4. Launch vWii (the Wii Menu icon).
- If the installation has succeeded, you should see the Homebrew Channel in your Wii Menu.

@ -2,7 +2,7 @@
## NAND Backup
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it.
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it, or you can completely [reinstall the vWii](http://wiiu.hacks.guide/#/recover-vwii-ioses-channels).
?> If you have recently made a NAND backup that includes SLCCMPT and OTP, feel free to skip this step.

@ -12,6 +12,6 @@ Patching IOS 80 allows you to have custom channels on the SD card, including wad
4. Wait until it says <code>IOS80 <wbr>Installation <wbr>is <wbr>complete!</code>.
5. Press any button to exit.
!> Installing custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing a custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing any IOS (including TED IOSes) or wads made for the original Wii on your vWii will brick it. WiiWare wads are fine, but some need to be converted to work.

@ -13,12 +13,15 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
?> If you have hacked your Wii U in the past, you can use the same SD Card for this process.
?> Unlike Wii U homebrew, vWii apps go in a separate `apps` folder on the root. Compat Installer is the **only** Wii U app here.
### What You Need
- The latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
- Click on `Download Tiramisu`.
- If you have already installed Tiramisu, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hb-app.store/wiiu/CompatTitleInstaller).
- The latest files from [Aroma for your café](https://aroma.foryour.cafe).
- Click on `Download Payloads` and `Download Base Aroma`.
- Read through the steps and click on the checkboxes.
- If you have already installed Aroma, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hbas-frontend.b-cdn.net/wiiu/CompatTitleInstaller).
- The <a href="docs/files/Patched_IOS80_Installer_for_vWii.zip" download>Patched IOS 80 Installer for vWii</a>. ([Source](https://github.com/Lazr1026/Patched-IOS80-Installer-for-vWii))
- The <a href ="docs/files/d2x_cIOS_Installer.zip" download>d2x cIOS Installer</a>.
@ -27,6 +30,6 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
1. Insert your Wii U's SD Card into your PC.
2. Copy the `apps` folder from the `Patched_IOS80_Installer_for_vWii.zip` file to the root of your SD Card.
3. Copy the `d2x-cios-installer` from the `d2x_cIOS_Installer.zip` file to the apps folder on the root of your SD Card.
4. Copy the contents of the downloaded Tiramisu _`.zip`_ file to the root of your SD Card.
4. Copy the contents of the downloaded Base Aroma and payloads `.zip` files to the root of your SD Card.
5. Copy the contents of the `CompatTitleInstaller.zip` file to the root of your SD Card.
6. Take the SD Card out of your computer and plug it into your Wii U console.

@ -1,7 +1,6 @@
- **User Guide**
- [Introduction](introduction)
- [Aroma](aroma/getting-started)
- **vWii**
- [vWii Modding](vwii/sd-preparation)
- **Troubleshooting**
- [Common Issues & Fixes](common-issues-fixes)

@ -12,11 +12,11 @@
- **FSGetMountSource failed:** Same as -3 above, means no SD Card detected. Re-insert the SD and try again. This could also mean that the SD card is locked (Slider is down instead of up) or the SD card label is "WIIU", which is stated in the guide causes conflict. If it's not any of these issues, refer to the last suggestion from -3.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder, and the wiiu folder on the root.
- **FSOpenFile failed:** Missing `homebrew_launcher` on SD. Make sure you have `homebrew_launcher.elf` in the <code>/wiiu<wbr>/apps<wbr>/homebrew_launcher</code> folder.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly, and it is not damaged. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
### Data Management asks to delete unnecessary data, what does it mean?

@ -11,7 +11,7 @@ Currently, every time you want to launch Tiramisu you will have to launch the He
1. Press A to select `Check`.
1. Select `Boot options`.
1. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
1. When the process finished, press A to shutdown the console.
1. When the process is finished, press A to shutdown the console.
1. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console. You cannot change the boot title until you set a default environment first.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.

@ -14,7 +14,7 @@ We are going to make the Tiramisu environment start automatically when your cons
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting up.
1. On the Tiramisu Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Tiramisu Boot Selector in the future, you have hold START (+) while your Wii U is booting up.
- To open the Tiramisu Boot Selector in the future, you have to hold START (+) while your Wii U is booting up.
?> Once you're booted into the Tiramisu environment, you can open the Mii Maker at any time to get into the Homebrew Launcher. <br>Homebrew Launcher will be empty for first-time modders. Follow the rest of the guide to install apps into the Homebrew Launcher. <br>To get back into the Mii Maker, simply press the HOME button while in the Homebrew Launcher.

@ -18,7 +18,7 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
1. Press the A button to start the dumping process.
1. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. The files will appear on the root of the SD card.
1. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` (and if you chose to go with a full backup, `every mlc.bin.part`) file to your computer.
1. Delete the files from your SD Card to free up space.

@ -4,9 +4,11 @@
Currently, every time you want to launch Aroma you will have to launch the Health and Safety information app. If you wish to automatically launch into Aroma on every boot, you can autoboot the Health and Safety Information app.
If you don't want to autoboot Aroma, you can skip this step and follow the Setting Up PayloadLoader section below.
### Instructions
1. Start the console to boot into the Wii U Menu, launch the Health and Safety Information app.
1. Start the console to boot into the Wii U Menu, and then launch the Health and Safety Information app.
2. Press A to launch the `aroma` environment.
3. Press A to launch the Wii U Menu.
4. Once you are at the Wii U Menu, launch the PayloadLoader Installer.
@ -15,6 +17,22 @@ Currently, every time you want to launch Aroma you will have to launch the Healt
7. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
8. When the process has finished, press A to shutdown the console.
9. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console.
### Setting up PayloadLoader, Environment Loader and Aroma
Now, we are going to make the Aroma environment start automatically when your console loads the Health and Safety Information app and select Wii U Menu as the default boot option.
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
2. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
3. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
4. Aroma will now be launched each time you boot the console (or load Health and Safety) and then straight into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have to hold START (+) while the console is booting or loading the Health and Safety Information app.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.
- Press A to launch the selected title.

@ -11,3 +11,5 @@ Make sure your Wii U has internet access for this step.
3. Click on `Run Exploit!` and hold the B button until you see a screen that says `Please choose your payload:`, this will be necessary for the next steps.
- If your Wii U gets stuck on a white or otherwise frozen screen, wait a few seconds. If nothing happens, reboot the console, [reset the browser's save data](https://en-americas-support.nintendo.com/app/answers/detail/a_id/1507/~/how-to-delete-the-internet-browser-history) and try again.
- If you see the EnvironmentLoader, you did not hold down B long enough. Try again.
?> If you get any errors like FSOpenfile failed, FSGetMountSorce failed, or SD Mount failed, refer to the browser errors in [Common Issues and Fixes](../common-issues-fixes).

@ -4,21 +4,8 @@
Now that PayloadLoader, Environment Loader and Aroma are installed, we are going to finalize the setup.
We are going to make the Aroma environment start automatically when your console autoboots the Health and Safety Information app (or when manually launching it if you chose not to autoboot it) and select Wii U Menu as default as well as getting additional homebrew apps. Please note that the following steps assumes you are autobooting the Health and Safety Information app.
### Setting up PayloadLoader, Environment Loader and Aroma
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
1. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
1. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have hold START (+) while the console is booting or loading the Health and Safety Information app.
### Blocking Updates
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Tiramisu, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Aroma, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
### Additional Homebrew Apps
@ -47,9 +34,15 @@ While Aroma's PayloadLoader already has built-in update blocking functionality,
| [Bloopair](https://github.com/GaryOderNichts/Bloopair/) ([Download](https://github.com/GaryOderNichts/Bloopair/releases)) | Allows wirelessly connecting most popular Bluetooth capable controllers. | 1. Extract the contents of the newly downloaded `Bloopair_vX.X.X.zip` file. <br> 2. Copy the `30_bloopair.rpx` to the `wiiu/environments/aroma/modules/setup/` folder on the root of your SD Card. <br> 3. Copy the `wiiu` folder to the root of your SD Card. |
| [Screenshot Plugin](https://github.com/wiiu-env/ScreenshotWUPS/) ([Download](https://github.com/wiiu-env/ScreenshotWUPS/releases)) | Allows taking screenshots directly to the SD Card. | 1. Extract the downloaded `screenshot_plugin_vX_X.zip` file. <br> 2. Copy the `screenshot.wps` to the `wiiu/environments/aroma/plugins` folder on the root of your SD Card. |
### Booting Tiramisu
### Pretendo Network
Pretendo is a replacement service for the Nintendo Network, which brings back online services as they are set to be discontinued. It also revives the Miiverse service, via juxtaposition. The official guide can be found [here](https://pretendo.network/docs/install/wiiu).
### Booting Tiramisu (optional)
?> Tiramisu is now archived, and was succeeded by Aroma and considered outdated. No more Homebrew will be developed for it, and services like Pretendo have ended support for it.
If you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
However, if you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
1. Download the latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
1. Copy the `wiiu` folder to the root of your SD Card.
@ -57,6 +50,7 @@ If you find the need to boot into Tiramisu, for example, to use a legacy Homebre
1. Take the SD Card out of your computer and plug it into your Wii U console.
1. Start the EnvironmentLoader.
- If you're autobooting into it, this can be done by powering on your console and holding X.
- You do not need to reinstall the PayloadLoader if you already did so with Aroma.
1. Highlight the entry called `tiramisu` using the D-Pad.
1. Launch Tiramisu by pressing A.
1. Launch the Wii U Menu by pressing A.

@ -15,7 +15,7 @@ For a detailed overview check out [this blogpost](https://maschell.github.io/hom
#### Modules
Aroma supports modules, which unlike setup modules, always run in the background.
This allows further extending the functionality of the console.
This allows for further extending the functionality of the console.
#### Plugins

@ -15,6 +15,7 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
1. Take the SD Card out of your PC and plug it into your Wii U.
2. Execute the web browser exploit as [previously explained](browser-exploit) but this time, you will need to hold the X button to open the Environment Loader menu.
3. Press A to launch the `aroma` environment.
- You will get a warning message about the update folder existing. This is normal. Press A to continue.
4. Press A to launch the Wii U Menu.
5. At the Wii U Menu, look for the newly appeared `PayloadLoader Installer` title (the round circle with an A inside of it) and launch it.
6. Press the A button to check if you can install the PayloadLoader.
@ -22,5 +23,3 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
7. Press the A button to select `Install / Update`.
8. You'll be asked if you are sure you want to install the PayloadLoader. Use the D-Pad to select `Install` and press A.
9. After installing has finished, press A to shut down the console.
!> If you do not wish to autoboot Aroma on your console, you can skip the `Autobooting Aroma` part and head directly to [Finalizing Setup](finalizing-setup).

@ -18,6 +18,6 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
3. Press the A button to start the dumping process.
4. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
4. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
5. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` and if you chose to go with a full backup, `every mlc.bin.part` file to your computer.
6. Delete the files from your SD Card to free up space.

@ -7,22 +7,20 @@ We will now place the required Aroma files on the SD Card.
?> **Notice** Your SD Card will need to be formatted as FAT32. If your SD Card is not formatted to FAT32, use [GUIFormat](http://ridgecrop.co.uk/index.htm?guiformat.htm) with 32k (32768) allocation unit size to format it.
**Do not** label the SD Card as `wiiu` or it will cause issues with homebrew.
### What You Need
- The latest files from the [Aroma download page](https://aroma.foryour.cafe).
1. Scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
- The latest release of the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases).
### Instructions
1. On the [Aroma](https://aroma.foryour.cafe) site, scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
1. Download the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases/download/v0.1/PayloadLoaderInstaller_20220905-105329.zip)
1. Insert your Wii U's SD Card into your PC.
1. **Extract** and copy the `wiiu` folder of the three newly downloaded *`.zip`* files to the root of your SD Card.
- The three `wiiu` folders should be merged if not done automatically.
?> If your computer asks you to overwrite existing files on your SD Card, you will need to click yes.
?> If you're on a Mac machine, select `Merge` instead of replace. If the merge option does not show immediately, press and hold the `Option` key while moving files to the root.
----------
### SD Card Layout {docsify-ignore}

@ -47,6 +47,8 @@ This guide has the end goal of taking a completely unmodified Wii U from stock t
>
> A 32GB SD Card will be enough for most use-cases. A Micro SD Card in an adapter will work fine.
?> **If you have an existing legacy CFW setup** </br> For **CBHC** users: Go to the [Uninstall CBHC](../uninstall-cbhc) page to uninstall CBHC. </br> For **Haxchi** users: Uninstall the Haxchi app from Data Management in the System Settings app. </br> For **Mocha CFW (Indexiine)** users: Go to the [Uninstall Indexiine](../uninstall-indexiine) page to uninstall Indexiine. </br> For **Mocha CFW (Online Exploit)** users: You do not need to do anything before following this guide.
If everything goes according to plan, you will lose no data and end up with everything that you started with (games, saves, NNID, etc, will be preserved).
Keep your device plugged in throughout the entire process to avoid data loss or damage from an unexpected power-off.

@ -2,8 +2,6 @@
## Installing cIOSes
!> Make sure you have no `.wad` files anywhere else than in the `apps` folder on your SD Card.
1. Power on your Wii U and launch vWii.
2. Launch The Homebrew Channel.
3. Launch d2x cIOS Installer.

@ -2,9 +2,8 @@
## Installing the Homebrew Channel
1. Boot into [Tiramisu](browser-exploit).
2. Launch the Homebrew Launcher, by opening the Mii Maker.
3. Launch the vWii Compat Installer.
4. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
5. Launch vWii (the Wii Menu icon).
1. Boot into [Aroma](browser-exploit).
2. Launch the `vWii Compat Installer` from the Wii U Menu.
3. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
4. Launch vWii (the Wii Menu icon).
- If the installation has succeeded, you should see the Homebrew Channel in your Wii Menu.

@ -2,7 +2,7 @@
## NAND Backup
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it.
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it, or you can completely [reinstall the vWii](http://wiiu.hacks.guide/#/recover-vwii-ioses-channels).
?> If you have recently made a NAND backup that includes SLCCMPT and OTP, feel free to skip this step.

@ -12,6 +12,6 @@ Patching IOS 80 allows you to have custom channels on the SD card, including wad
4. Wait until it says <code>IOS80 <wbr>Installation <wbr>is <wbr>complete!</code>.
5. Press any button to exit.
!> Installing custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing a custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing any IOS (including TED IOSes) or wads made for the original Wii on your vWii will brick it. WiiWare wads are fine, but some need to be converted to work.

@ -13,12 +13,15 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
?> If you have hacked your Wii U in the past, you can use the same SD Card for this process.
?> Unlike Wii U homebrew, vWii apps go in a separate `apps` folder on the root. Compat Installer is the **only** Wii U app here.
### What You Need
- The latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
- Click on `Download Tiramisu`.
- If you have already installed Tiramisu, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hb-app.store/wiiu/CompatTitleInstaller).
- The latest files from [Aroma for your café](https://aroma.foryour.cafe).
- Click on `Download Payloads` and `Download Base Aroma`.
- Read through the steps and click on the checkboxes.
- If you have already installed Aroma, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hbas-frontend.b-cdn.net/wiiu/CompatTitleInstaller).
- The <a href="docs/files/Patched_IOS80_Installer_for_vWii.zip" download>Patched IOS 80 Installer for vWii</a>. ([Source](https://github.com/Lazr1026/Patched-IOS80-Installer-for-vWii))
- The <a href ="docs/files/d2x_cIOS_Installer.zip" download>d2x cIOS Installer</a>.
@ -27,6 +30,6 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
1. Insert your Wii U's SD Card into your PC.
2. Copy the `apps` folder from the `Patched_IOS80_Installer_for_vWii.zip` file to the root of your SD Card.
3. Copy the `d2x-cios-installer` from the `d2x_cIOS_Installer.zip` file to the apps folder on the root of your SD Card.
4. Copy the contents of the downloaded Tiramisu _`.zip`_ file to the root of your SD Card.
4. Copy the contents of the downloaded Base Aroma and payloads `.zip` files to the root of your SD Card.
5. Copy the contents of the `CompatTitleInstaller.zip` file to the root of your SD Card.
6. Take the SD Card out of your computer and plug it into your Wii U console.

@ -1,7 +1,6 @@
- **User Guide**
- [Introduction](introduction)
- [Aroma](aroma/getting-started)
- **vWii**
- [vWii Modding](vwii/sd-preparation)
- **Troubleshooting**
- [Common Issues & Fixes](common-issues-fixes)

@ -12,11 +12,11 @@
- **FSGetMountSource failed:** Same as -3 above, means no SD Card detected. Re-insert the SD and try again. This could also mean that the SD card is locked (Slider is down instead of up) or the SD card label is "WIIU", which is stated in the guide causes conflict. If it's not any of these issues, refer to the last suggestion from -3.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder, and the wiiu folder on the root.
- **FSOpenFile failed:** Missing `homebrew_launcher` on SD. Make sure you have `homebrew_launcher.elf` in the <code>/wiiu<wbr>/apps<wbr>/homebrew_launcher</code> folder.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly, and it is not damaged. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
### Data Management asks to delete unnecessary data, what does it mean?

@ -11,7 +11,7 @@ Currently, every time you want to launch Tiramisu you will have to launch the He
1. Press A to select `Check`.
1. Select `Boot options`.
1. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
1. When the process finished, press A to shutdown the console.
1. When the process is finished, press A to shutdown the console.
1. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console. You cannot change the boot title until you set a default environment first.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.

@ -14,7 +14,7 @@ We are going to make the Tiramisu environment start automatically when your cons
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting up.
1. On the Tiramisu Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Tiramisu Boot Selector in the future, you have hold START (+) while your Wii U is booting up.
- To open the Tiramisu Boot Selector in the future, you have to hold START (+) while your Wii U is booting up.
?> Once you're booted into the Tiramisu environment, you can open the Mii Maker at any time to get into the Homebrew Launcher. <br>Homebrew Launcher will be empty for first-time modders. Follow the rest of the guide to install apps into the Homebrew Launcher. <br>To get back into the Mii Maker, simply press the HOME button while in the Homebrew Launcher.

@ -18,7 +18,7 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
1. Press the A button to start the dumping process.
1. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. The files will appear on the root of the SD card.
1. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` (and if you chose to go with a full backup, `every mlc.bin.part`) file to your computer.
1. Delete the files from your SD Card to free up space.

@ -4,9 +4,11 @@
Currently, every time you want to launch Aroma you will have to launch the Health and Safety information app. If you wish to automatically launch into Aroma on every boot, you can autoboot the Health and Safety Information app.
If you don't want to autoboot Aroma, you can skip this step and follow the Setting Up PayloadLoader section below.
### Instructions
1. Start the console to boot into the Wii U Menu, launch the Health and Safety Information app.
1. Start the console to boot into the Wii U Menu, and then launch the Health and Safety Information app.
2. Press A to launch the `aroma` environment.
3. Press A to launch the Wii U Menu.
4. Once you are at the Wii U Menu, launch the PayloadLoader Installer.
@ -15,6 +17,22 @@ Currently, every time you want to launch Aroma you will have to launch the Healt
7. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
8. When the process has finished, press A to shutdown the console.
9. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console.
### Setting up PayloadLoader, Environment Loader and Aroma
Now, we are going to make the Aroma environment start automatically when your console loads the Health and Safety Information app and select Wii U Menu as the default boot option.
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
2. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
3. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
4. Aroma will now be launched each time you boot the console (or load Health and Safety) and then straight into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have to hold START (+) while the console is booting or loading the Health and Safety Information app.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.
- Press A to launch the selected title.

@ -11,3 +11,5 @@ Make sure your Wii U has internet access for this step.
3. Click on `Run Exploit!` and hold the B button until you see a screen that says `Please choose your payload:`, this will be necessary for the next steps.
- If your Wii U gets stuck on a white or otherwise frozen screen, wait a few seconds. If nothing happens, reboot the console, [reset the browser's save data](https://en-americas-support.nintendo.com/app/answers/detail/a_id/1507/~/how-to-delete-the-internet-browser-history) and try again.
- If you see the EnvironmentLoader, you did not hold down B long enough. Try again.
?> If you get any errors like FSOpenfile failed, FSGetMountSorce failed, or SD Mount failed, refer to the browser errors in [Common Issues and Fixes](../common-issues-fixes).

@ -4,21 +4,8 @@
Now that PayloadLoader, Environment Loader and Aroma are installed, we are going to finalize the setup.
We are going to make the Aroma environment start automatically when your console autoboots the Health and Safety Information app (or when manually launching it if you chose not to autoboot it) and select Wii U Menu as default as well as getting additional homebrew apps. Please note that the following steps assumes you are autobooting the Health and Safety Information app.
### Setting up PayloadLoader, Environment Loader and Aroma
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
1. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
1. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have hold START (+) while the console is booting or loading the Health and Safety Information app.
### Blocking Updates
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Tiramisu, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Aroma, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
### Additional Homebrew Apps
@ -47,9 +34,15 @@ While Aroma's PayloadLoader already has built-in update blocking functionality,
| [Bloopair](https://github.com/GaryOderNichts/Bloopair/) ([Download](https://github.com/GaryOderNichts/Bloopair/releases)) | Allows wirelessly connecting most popular Bluetooth capable controllers. | 1. Extract the contents of the newly downloaded `Bloopair_vX.X.X.zip` file. <br> 2. Copy the `30_bloopair.rpx` to the `wiiu/environments/aroma/modules/setup/` folder on the root of your SD Card. <br> 3. Copy the `wiiu` folder to the root of your SD Card. |
| [Screenshot Plugin](https://github.com/wiiu-env/ScreenshotWUPS/) ([Download](https://github.com/wiiu-env/ScreenshotWUPS/releases)) | Allows taking screenshots directly to the SD Card. | 1. Extract the downloaded `screenshot_plugin_vX_X.zip` file. <br> 2. Copy the `screenshot.wps` to the `wiiu/environments/aroma/plugins` folder on the root of your SD Card. |
### Booting Tiramisu
### Pretendo Network
Pretendo is a replacement service for the Nintendo Network, which brings back online services as they are set to be discontinued. It also revives the Miiverse service, via juxtaposition. The official guide can be found [here](https://pretendo.network/docs/install/wiiu).
### Booting Tiramisu (optional)
?> Tiramisu is now archived, and was succeeded by Aroma and considered outdated. No more Homebrew will be developed for it, and services like Pretendo have ended support for it.
If you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
However, if you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
1. Download the latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
1. Copy the `wiiu` folder to the root of your SD Card.
@ -57,6 +50,7 @@ If you find the need to boot into Tiramisu, for example, to use a legacy Homebre
1. Take the SD Card out of your computer and plug it into your Wii U console.
1. Start the EnvironmentLoader.
- If you're autobooting into it, this can be done by powering on your console and holding X.
- You do not need to reinstall the PayloadLoader if you already did so with Aroma.
1. Highlight the entry called `tiramisu` using the D-Pad.
1. Launch Tiramisu by pressing A.
1. Launch the Wii U Menu by pressing A.

@ -15,7 +15,7 @@ For a detailed overview check out [this blogpost](https://maschell.github.io/hom
#### Modules
Aroma supports modules, which unlike setup modules, always run in the background.
This allows further extending the functionality of the console.
This allows for further extending the functionality of the console.
#### Plugins

@ -15,6 +15,7 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
1. Take the SD Card out of your PC and plug it into your Wii U.
2. Execute the web browser exploit as [previously explained](browser-exploit) but this time, you will need to hold the X button to open the Environment Loader menu.
3. Press A to launch the `aroma` environment.
- You will get a warning message about the update folder existing. This is normal. Press A to continue.
4. Press A to launch the Wii U Menu.
5. At the Wii U Menu, look for the newly appeared `PayloadLoader Installer` title (the round circle with an A inside of it) and launch it.
6. Press the A button to check if you can install the PayloadLoader.
@ -22,5 +23,3 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
7. Press the A button to select `Install / Update`.
8. You'll be asked if you are sure you want to install the PayloadLoader. Use the D-Pad to select `Install` and press A.
9. After installing has finished, press A to shut down the console.
!> If you do not wish to autoboot Aroma on your console, you can skip the `Autobooting Aroma` part and head directly to [Finalizing Setup](finalizing-setup).

@ -18,6 +18,6 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
3. Press the A button to start the dumping process.
4. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
4. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
5. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` and if you chose to go with a full backup, `every mlc.bin.part` file to your computer.
6. Delete the files from your SD Card to free up space.

@ -7,22 +7,20 @@ We will now place the required Aroma files on the SD Card.
?> **Notice** Your SD Card will need to be formatted as FAT32. If your SD Card is not formatted to FAT32, use [GUIFormat](http://ridgecrop.co.uk/index.htm?guiformat.htm) with 32k (32768) allocation unit size to format it.
**Do not** label the SD Card as `wiiu` or it will cause issues with homebrew.
### What You Need
- The latest files from the [Aroma download page](https://aroma.foryour.cafe).
1. Scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
- The latest release of the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases).
### Instructions
1. On the [Aroma](https://aroma.foryour.cafe) site, scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
1. Download the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases/download/v0.1/PayloadLoaderInstaller_20220905-105329.zip)
1. Insert your Wii U's SD Card into your PC.
1. **Extract** and copy the `wiiu` folder of the three newly downloaded *`.zip`* files to the root of your SD Card.
- The three `wiiu` folders should be merged if not done automatically.
?> If your computer asks you to overwrite existing files on your SD Card, you will need to click yes.
?> If you're on a Mac machine, select `Merge` instead of replace. If the merge option does not show immediately, press and hold the `Option` key while moving files to the root.
----------
### SD Card Layout {docsify-ignore}

@ -47,6 +47,8 @@ This guide has the end goal of taking a completely unmodified Wii U from stock t
>
> A 32GB SD Card will be enough for most use-cases. A Micro SD Card in an adapter will work fine.
?> **If you have an existing legacy CFW setup** </br> For **CBHC** users: Go to the [Uninstall CBHC](../uninstall-cbhc) page to uninstall CBHC. </br> For **Haxchi** users: Uninstall the Haxchi app from Data Management in the System Settings app. </br> For **Mocha CFW (Indexiine)** users: Go to the [Uninstall Indexiine](../uninstall-indexiine) page to uninstall Indexiine. </br> For **Mocha CFW (Online Exploit)** users: You do not need to do anything before following this guide.
If everything goes according to plan, you will lose no data and end up with everything that you started with (games, saves, NNID, etc, will be preserved).
Keep your device plugged in throughout the entire process to avoid data loss or damage from an unexpected power-off.

@ -2,8 +2,6 @@
## Installing cIOSes
!> Make sure you have no `.wad` files anywhere else than in the `apps` folder on your SD Card.
1. Power on your Wii U and launch vWii.
2. Launch The Homebrew Channel.
3. Launch d2x cIOS Installer.

@ -2,9 +2,8 @@
## Installing the Homebrew Channel
1. Boot into [Tiramisu](browser-exploit).
2. Launch the Homebrew Launcher, by opening the Mii Maker.
3. Launch the vWii Compat Installer.
4. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
5. Launch vWii (the Wii Menu icon).
1. Boot into [Aroma](browser-exploit).
2. Launch the `vWii Compat Installer` from the Wii U Menu.
3. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
4. Launch vWii (the Wii Menu icon).
- If the installation has succeeded, you should see the Homebrew Channel in your Wii Menu.

@ -2,7 +2,7 @@
## NAND Backup
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it.
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it, or you can completely [reinstall the vWii](http://wiiu.hacks.guide/#/recover-vwii-ioses-channels).
?> If you have recently made a NAND backup that includes SLCCMPT and OTP, feel free to skip this step.

@ -12,6 +12,6 @@ Patching IOS 80 allows you to have custom channels on the SD card, including wad
4. Wait until it says <code>IOS80 <wbr>Installation <wbr>is <wbr>complete!</code>.
5. Press any button to exit.
!> Installing custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing a custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing any IOS (including TED IOSes) or wads made for the original Wii on your vWii will brick it. WiiWare wads are fine, but some need to be converted to work.

@ -13,12 +13,15 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
?> If you have hacked your Wii U in the past, you can use the same SD Card for this process.
?> Unlike Wii U homebrew, vWii apps go in a separate `apps` folder on the root. Compat Installer is the **only** Wii U app here.
### What You Need
- The latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
- Click on `Download Tiramisu`.
- If you have already installed Tiramisu, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hb-app.store/wiiu/CompatTitleInstaller).
- The latest files from [Aroma for your café](https://aroma.foryour.cafe).
- Click on `Download Payloads` and `Download Base Aroma`.
- Read through the steps and click on the checkboxes.
- If you have already installed Aroma, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hbas-frontend.b-cdn.net/wiiu/CompatTitleInstaller).
- The <a href="docs/files/Patched_IOS80_Installer_for_vWii.zip" download>Patched IOS 80 Installer for vWii</a>. ([Source](https://github.com/Lazr1026/Patched-IOS80-Installer-for-vWii))
- The <a href ="docs/files/d2x_cIOS_Installer.zip" download>d2x cIOS Installer</a>.
@ -27,6 +30,6 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
1. Insert your Wii U's SD Card into your PC.
2. Copy the `apps` folder from the `Patched_IOS80_Installer_for_vWii.zip` file to the root of your SD Card.
3. Copy the `d2x-cios-installer` from the `d2x_cIOS_Installer.zip` file to the apps folder on the root of your SD Card.
4. Copy the contents of the downloaded Tiramisu _`.zip`_ file to the root of your SD Card.
4. Copy the contents of the downloaded Base Aroma and payloads `.zip` files to the root of your SD Card.
5. Copy the contents of the `CompatTitleInstaller.zip` file to the root of your SD Card.
6. Take the SD Card out of your computer and plug it into your Wii U console.

@ -1,7 +1,6 @@
- **User Guide**
- [Introduction](introduction)
- [Aroma](aroma/getting-started)
- **vWii**
- [vWii Modding](vwii/sd-preparation)
- **Troubleshooting**
- [Common Issues & Fixes](common-issues-fixes)

@ -12,11 +12,11 @@
- **FSGetMountSource failed:** Same as -3 above, means no SD Card detected. Re-insert the SD and try again. This could also mean that the SD card is locked (Slider is down instead of up) or the SD card label is "WIIU", which is stated in the guide causes conflict. If it's not any of these issues, refer to the last suggestion from -3.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder, and the wiiu folder on the root.
- **FSOpenFile failed:** Missing `homebrew_launcher` on SD. Make sure you have `homebrew_launcher.elf` in the <code>/wiiu<wbr>/apps<wbr>/homebrew_launcher</code> folder.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly, and it is not damaged. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
### Data Management asks to delete unnecessary data, what does it mean?

@ -11,7 +11,7 @@ Currently, every time you want to launch Tiramisu you will have to launch the He
1. Press A to select `Check`.
1. Select `Boot options`.
1. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
1. When the process finished, press A to shutdown the console.
1. When the process is finished, press A to shutdown the console.
1. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console. You cannot change the boot title until you set a default environment first.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.

@ -14,7 +14,7 @@ We are going to make the Tiramisu environment start automatically when your cons
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting up.
1. On the Tiramisu Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Tiramisu Boot Selector in the future, you have hold START (+) while your Wii U is booting up.
- To open the Tiramisu Boot Selector in the future, you have to hold START (+) while your Wii U is booting up.
?> Once you're booted into the Tiramisu environment, you can open the Mii Maker at any time to get into the Homebrew Launcher. <br>Homebrew Launcher will be empty for first-time modders. Follow the rest of the guide to install apps into the Homebrew Launcher. <br>To get back into the Mii Maker, simply press the HOME button while in the Homebrew Launcher.

@ -18,7 +18,7 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
1. Press the A button to start the dumping process.
1. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. The files will appear on the root of the SD card.
1. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` (and if you chose to go with a full backup, `every mlc.bin.part`) file to your computer.
1. Delete the files from your SD Card to free up space.

@ -4,9 +4,11 @@
Currently, every time you want to launch Aroma you will have to launch the Health and Safety information app. If you wish to automatically launch into Aroma on every boot, you can autoboot the Health and Safety Information app.
If you don't want to autoboot Aroma, you can skip this step and follow the Setting Up PayloadLoader section below.
### Instructions
1. Start the console to boot into the Wii U Menu, launch the Health and Safety Information app.
1. Start the console to boot into the Wii U Menu, and then launch the Health and Safety Information app.
2. Press A to launch the `aroma` environment.
3. Press A to launch the Wii U Menu.
4. Once you are at the Wii U Menu, launch the PayloadLoader Installer.
@ -15,6 +17,22 @@ Currently, every time you want to launch Aroma you will have to launch the Healt
7. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
8. When the process has finished, press A to shutdown the console.
9. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console.
### Setting up PayloadLoader, Environment Loader and Aroma
Now, we are going to make the Aroma environment start automatically when your console loads the Health and Safety Information app and select Wii U Menu as the default boot option.
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
2. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
3. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
4. Aroma will now be launched each time you boot the console (or load Health and Safety) and then straight into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have to hold START (+) while the console is booting or loading the Health and Safety Information app.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.
- Press A to launch the selected title.

@ -11,3 +11,5 @@ Make sure your Wii U has internet access for this step.
3. Click on `Run Exploit!` and hold the B button until you see a screen that says `Please choose your payload:`, this will be necessary for the next steps.
- If your Wii U gets stuck on a white or otherwise frozen screen, wait a few seconds. If nothing happens, reboot the console, [reset the browser's save data](https://en-americas-support.nintendo.com/app/answers/detail/a_id/1507/~/how-to-delete-the-internet-browser-history) and try again.
- If you see the EnvironmentLoader, you did not hold down B long enough. Try again.
?> If you get any errors like FSOpenfile failed, FSGetMountSorce failed, or SD Mount failed, refer to the browser errors in [Common Issues and Fixes](../common-issues-fixes).

@ -4,21 +4,8 @@
Now that PayloadLoader, Environment Loader and Aroma are installed, we are going to finalize the setup.
We are going to make the Aroma environment start automatically when your console autoboots the Health and Safety Information app (or when manually launching it if you chose not to autoboot it) and select Wii U Menu as default as well as getting additional homebrew apps. Please note that the following steps assumes you are autobooting the Health and Safety Information app.
### Setting up PayloadLoader, Environment Loader and Aroma
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
1. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
1. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have hold START (+) while the console is booting or loading the Health and Safety Information app.
### Blocking Updates
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Tiramisu, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Aroma, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
### Additional Homebrew Apps
@ -47,9 +34,15 @@ While Aroma's PayloadLoader already has built-in update blocking functionality,
| [Bloopair](https://github.com/GaryOderNichts/Bloopair/) ([Download](https://github.com/GaryOderNichts/Bloopair/releases)) | Allows wirelessly connecting most popular Bluetooth capable controllers. | 1. Extract the contents of the newly downloaded `Bloopair_vX.X.X.zip` file. <br> 2. Copy the `30_bloopair.rpx` to the `wiiu/environments/aroma/modules/setup/` folder on the root of your SD Card. <br> 3. Copy the `wiiu` folder to the root of your SD Card. |
| [Screenshot Plugin](https://github.com/wiiu-env/ScreenshotWUPS/) ([Download](https://github.com/wiiu-env/ScreenshotWUPS/releases)) | Allows taking screenshots directly to the SD Card. | 1. Extract the downloaded `screenshot_plugin_vX_X.zip` file. <br> 2. Copy the `screenshot.wps` to the `wiiu/environments/aroma/plugins` folder on the root of your SD Card. |
### Booting Tiramisu
### Pretendo Network
Pretendo is a replacement service for the Nintendo Network, which brings back online services as they are set to be discontinued. It also revives the Miiverse service, via juxtaposition. The official guide can be found [here](https://pretendo.network/docs/install/wiiu).
### Booting Tiramisu (optional)
?> Tiramisu is now archived, and was succeeded by Aroma and considered outdated. No more Homebrew will be developed for it, and services like Pretendo have ended support for it.
If you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
However, if you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
1. Download the latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
1. Copy the `wiiu` folder to the root of your SD Card.
@ -57,6 +50,7 @@ If you find the need to boot into Tiramisu, for example, to use a legacy Homebre
1. Take the SD Card out of your computer and plug it into your Wii U console.
1. Start the EnvironmentLoader.
- If you're autobooting into it, this can be done by powering on your console and holding X.
- You do not need to reinstall the PayloadLoader if you already did so with Aroma.
1. Highlight the entry called `tiramisu` using the D-Pad.
1. Launch Tiramisu by pressing A.
1. Launch the Wii U Menu by pressing A.

@ -15,7 +15,7 @@ For a detailed overview check out [this blogpost](https://maschell.github.io/hom
#### Modules
Aroma supports modules, which unlike setup modules, always run in the background.
This allows further extending the functionality of the console.
This allows for further extending the functionality of the console.
#### Plugins

@ -15,6 +15,7 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
1. Take the SD Card out of your PC and plug it into your Wii U.
2. Execute the web browser exploit as [previously explained](browser-exploit) but this time, you will need to hold the X button to open the Environment Loader menu.
3. Press A to launch the `aroma` environment.
- You will get a warning message about the update folder existing. This is normal. Press A to continue.
4. Press A to launch the Wii U Menu.
5. At the Wii U Menu, look for the newly appeared `PayloadLoader Installer` title (the round circle with an A inside of it) and launch it.
6. Press the A button to check if you can install the PayloadLoader.
@ -22,5 +23,3 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
7. Press the A button to select `Install / Update`.
8. You'll be asked if you are sure you want to install the PayloadLoader. Use the D-Pad to select `Install` and press A.
9. After installing has finished, press A to shut down the console.
!> If you do not wish to autoboot Aroma on your console, you can skip the `Autobooting Aroma` part and head directly to [Finalizing Setup](finalizing-setup).

@ -18,6 +18,6 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
3. Press the A button to start the dumping process.
4. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
4. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
5. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` and if you chose to go with a full backup, `every mlc.bin.part` file to your computer.
6. Delete the files from your SD Card to free up space.

@ -7,22 +7,20 @@ We will now place the required Aroma files on the SD Card.
?> **Notice** Your SD Card will need to be formatted as FAT32. If your SD Card is not formatted to FAT32, use [GUIFormat](http://ridgecrop.co.uk/index.htm?guiformat.htm) with 32k (32768) allocation unit size to format it.
**Do not** label the SD Card as `wiiu` or it will cause issues with homebrew.
### What You Need
- The latest files from the [Aroma download page](https://aroma.foryour.cafe).
1. Scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
- The latest release of the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases).
### Instructions
1. On the [Aroma](https://aroma.foryour.cafe) site, scroll down to the **Download** section.
1. Read through the steps and click on the checkboxes.
1. Click on `Download Payloads` and `Download Base Aroma`.
1. Download the [PayloadLoader Installer](https://github.com/wiiu-env/PayloadLoaderInstaller/releases/download/v0.1/PayloadLoaderInstaller_20220905-105329.zip)
1. Insert your Wii U's SD Card into your PC.
1. **Extract** and copy the `wiiu` folder of the three newly downloaded *`.zip`* files to the root of your SD Card.
- The three `wiiu` folders should be merged if not done automatically.
?> If your computer asks you to overwrite existing files on your SD Card, you will need to click yes.
?> If you're on a Mac machine, select `Merge` instead of replace. If the merge option does not show immediately, press and hold the `Option` key while moving files to the root.
----------
### SD Card Layout {docsify-ignore}

@ -47,6 +47,8 @@ This guide has the end goal of taking a completely unmodified Wii U from stock t
>
> A 32GB SD Card will be enough for most use-cases. A Micro SD Card in an adapter will work fine.
?> **If you have an existing legacy CFW setup** </br> For **CBHC** users: Go to the [Uninstall CBHC](../uninstall-cbhc) page to uninstall CBHC. </br> For **Haxchi** users: Uninstall the Haxchi app from Data Management in the System Settings app. </br> For **Mocha CFW (Indexiine)** users: Go to the [Uninstall Indexiine](../uninstall-indexiine) page to uninstall Indexiine. </br> For **Mocha CFW (Online Exploit)** users: You do not need to do anything before following this guide.
If everything goes according to plan, you will lose no data and end up with everything that you started with (games, saves, NNID, etc, will be preserved).
Keep your device plugged in throughout the entire process to avoid data loss or damage from an unexpected power-off.

@ -2,8 +2,6 @@
## Installing cIOSes
!> Make sure you have no `.wad` files anywhere else than in the `apps` folder on your SD Card.
1. Power on your Wii U and launch vWii.
2. Launch The Homebrew Channel.
3. Launch d2x cIOS Installer.

@ -2,9 +2,8 @@
## Installing the Homebrew Channel
1. Boot into [Tiramisu](browser-exploit).
2. Launch the Homebrew Launcher, by opening the Mii Maker.
3. Launch the vWii Compat Installer.
4. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
5. Launch vWii (the Wii Menu icon).
1. Boot into [Aroma](browser-exploit).
2. Launch the `vWii Compat Installer` from the Wii U Menu.
3. Press `A` to install the Homebrew Channel and wait until you see `Install succeeded`. Then press the HOME button to return to the Wii U Menu.
4. Launch vWii (the Wii Menu icon).
- If the installation has succeeded, you should see the Homebrew Channel in your Wii Menu.

@ -2,7 +2,7 @@
## NAND Backup
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it.
In case anything goes wrong in the later process and your vWii ends up bricked, restoring a previously made NAND backup can fix it, or you can completely [reinstall the vWii](http://wiiu.hacks.guide/#/recover-vwii-ioses-channels).
?> If you have recently made a NAND backup that includes SLCCMPT and OTP, feel free to skip this step.

@ -12,6 +12,6 @@ Patching IOS 80 allows you to have custom channels on the SD card, including wad
4. Wait until it says <code>IOS80 <wbr>Installation <wbr>is <wbr>complete!</code>.
5. Press any button to exit.
!> Installing custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing a custom System Menu is a definite brick risk and you should always have an effective backup before installing one but when done right, won't brick the vWii.
!> Installing any IOS (including TED IOSes) or wads made for the original Wii on your vWii will brick it. WiiWare wads are fine, but some need to be converted to work.

@ -13,12 +13,15 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
?> If you have hacked your Wii U in the past, you can use the same SD Card for this process.
?> Unlike Wii U homebrew, vWii apps go in a separate `apps` folder on the root. Compat Installer is the **only** Wii U app here.
### What You Need
- The latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
- Click on `Download Tiramisu`.
- If you have already installed Tiramisu, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hb-app.store/wiiu/CompatTitleInstaller).
- The latest files from [Aroma for your café](https://aroma.foryour.cafe).
- Click on `Download Payloads` and `Download Base Aroma`.
- Read through the steps and click on the checkboxes.
- If you have already installed Aroma, you do not need to redownload it.
- The latest release of the [Compat Title Installer](https://hbas-frontend.b-cdn.net/wiiu/CompatTitleInstaller).
- The <a href="docs/files/Patched_IOS80_Installer_for_vWii.zip" download>Patched IOS 80 Installer for vWii</a>. ([Source](https://github.com/Lazr1026/Patched-IOS80-Installer-for-vWii))
- The <a href ="docs/files/d2x_cIOS_Installer.zip" download>d2x cIOS Installer</a>.
@ -27,6 +30,6 @@ Your SD Card will need to be formatted as FAT32. If your SD Card is not formatte
1. Insert your Wii U's SD Card into your PC.
2. Copy the `apps` folder from the `Patched_IOS80_Installer_for_vWii.zip` file to the root of your SD Card.
3. Copy the `d2x-cios-installer` from the `d2x_cIOS_Installer.zip` file to the apps folder on the root of your SD Card.
4. Copy the contents of the downloaded Tiramisu _`.zip`_ file to the root of your SD Card.
4. Copy the contents of the downloaded Base Aroma and payloads `.zip` files to the root of your SD Card.
5. Copy the contents of the `CompatTitleInstaller.zip` file to the root of your SD Card.
6. Take the SD Card out of your computer and plug it into your Wii U console.

@ -1,7 +1,6 @@
- **User Guide**
- [Introduction](introduction)
- [Aroma](aroma/getting-started)
- **vWii**
- [vWii Modding](vwii/sd-preparation)
- **Troubleshooting**
- [Common Issues & Fixes](common-issues-fixes)

@ -12,11 +12,11 @@
- **FSGetMountSource failed:** Same as -3 above, means no SD Card detected. Re-insert the SD and try again. This could also mean that the SD card is locked (Slider is down instead of up) or the SD card label is "WIIU", which is stated in the guide causes conflict. If it's not any of these issues, refer to the last suggestion from -3.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder.
- **FSOpenFile failed [...] payload.elf:** Missing payload file on SD. Make sure you have payload.elf in the wiiu folder, and the wiiu folder on the root.
- **FSOpenFile failed:** Missing `homebrew_launcher` on SD. Make sure you have `homebrew_launcher.elf` in the <code>/wiiu<wbr>/apps<wbr>/homebrew_launcher</code> folder.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
- **SD Mount Failed:** Similar to -4, the console recognizes the SD card but could not mount it. Make sure it is formatted properly, and it is not damaged. Also, your SD card is more compatible with reputable brands (i.e. SanDisk, Samsung, Lexar, etc.) and less likely to have issues.
### Data Management asks to delete unnecessary data, what does it mean?

@ -11,7 +11,7 @@ Currently, every time you want to launch Tiramisu you will have to launch the He
1. Press A to select `Check`.
1. Select `Boot options`.
1. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
1. When the process finished, press A to shutdown the console.
1. When the process is finished, press A to shutdown the console.
1. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console. You cannot change the boot title until you set a default environment first.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.

@ -14,7 +14,7 @@ We are going to make the Tiramisu environment start automatically when your cons
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting up.
1. On the Tiramisu Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Tiramisu Boot Selector in the future, you have hold START (+) while your Wii U is booting up.
- To open the Tiramisu Boot Selector in the future, you have to hold START (+) while your Wii U is booting up.
?> Once you're booted into the Tiramisu environment, you can open the Mii Maker at any time to get into the Homebrew Launcher. <br>Homebrew Launcher will be empty for first-time modders. Follow the rest of the guide to install apps into the Homebrew Launcher. <br>To get back into the Mii Maker, simply press the HOME button while in the Homebrew Launcher.

@ -18,7 +18,7 @@ In case anything should go wrong in the later process and your Wii U ends up bri
- Dump OTP: **yes**
- Dump SEEPROM: **yes**
1. Press the A button to start the dumping process.
1. When the process completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. When the process is completed, power off your Wii U, take your SD Card out of the Wii U and plug it into your PC.
1. The files will appear on the root of the SD card.
1. To make sure you don't lose the files, copy the `slc.bin`, `slccmpt.bin`, `seeprom.bin`, `otp.bin` (and if you chose to go with a full backup, `every mlc.bin.part`) file to your computer.
1. Delete the files from your SD Card to free up space.

@ -4,9 +4,11 @@
Currently, every time you want to launch Aroma you will have to launch the Health and Safety information app. If you wish to automatically launch into Aroma on every boot, you can autoboot the Health and Safety Information app.
If you don't want to autoboot Aroma, you can skip this step and follow the Setting Up PayloadLoader section below.
### Instructions
1. Start the console to boot into the Wii U Menu, launch the Health and Safety Information app.
1. Start the console to boot into the Wii U Menu, and then launch the Health and Safety Information app.
2. Press A to launch the `aroma` environment.
3. Press A to launch the Wii U Menu.
4. Once you are at the Wii U Menu, launch the PayloadLoader Installer.
@ -15,6 +17,22 @@ Currently, every time you want to launch Aroma you will have to launch the Healt
7. You will be asked if you want to switch the boot title. Press A to select `Switch to PayloadLoader`.
8. When the process has finished, press A to shutdown the console.
9. The PayloadLoader will now be launched automatically on every boot.
- To change the default boot title hold Start (+) on the Gamepad while booting the console.
### Setting up PayloadLoader, Environment Loader and Aroma
Now, we are going to make the Aroma environment start automatically when your console loads the Health and Safety Information app and select Wii U Menu as the default boot option.
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
2. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
3. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
4. Aroma will now be launched each time you boot the console (or load Health and Safety) and then straight into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have to hold START (+) while the console is booting or loading the Health and Safety Information app.
- Navigate the list using the D-Pad to hover on the title you want to autoboot in, then press the Y button to set this to your autoboot title.
- Press A to launch the selected title.

@ -11,3 +11,5 @@ Make sure your Wii U has internet access for this step.
3. Click on `Run Exploit!` and hold the B button until you see a screen that says `Please choose your payload:`, this will be necessary for the next steps.
- If your Wii U gets stuck on a white or otherwise frozen screen, wait a few seconds. If nothing happens, reboot the console, [reset the browser's save data](https://en-americas-support.nintendo.com/app/answers/detail/a_id/1507/~/how-to-delete-the-internet-browser-history) and try again.
- If you see the EnvironmentLoader, you did not hold down B long enough. Try again.
?> If you get any errors like FSOpenfile failed, FSGetMountSorce failed, or SD Mount failed, refer to the browser errors in [Common Issues and Fixes](../common-issues-fixes).

@ -4,21 +4,8 @@
Now that PayloadLoader, Environment Loader and Aroma are installed, we are going to finalize the setup.
We are going to make the Aroma environment start automatically when your console autoboots the Health and Safety Information app (or when manually launching it if you chose not to autoboot it) and select Wii U Menu as default as well as getting additional homebrew apps. Please note that the following steps assumes you are autobooting the Health and Safety Information app.
### Setting up PayloadLoader, Environment Loader and Aroma
1. Launch the EnvironmentLoader.
- If you are autobooting the PayloadLoader, simply turn on your Wii U.
- If you skipped the autobooting steps, launch the Health and Safety Information app.
1. Using the D-Pad, navigate to `aroma` and press Y to set this to your default environment, then press A to launch into Aroma.
- You might get a red warning screen telling you that updates aren't blocked properly. Press A to continue anyway. We're going to block updates in the "Blocking Updates" section below.
- To open the Environment Loader in the future, you have to hold X while your Wii U is booting or loading the Health and Safety Information app.
1. On the Aroma Boot Selector, the `Wii U Menu` should already be selected, press Y to set this to your default autobooting option, then press A to launch into the Wii U Menu.
- To open the Aroma Boot Selector in the future, you have hold START (+) while the console is booting or loading the Health and Safety Information app.
### Blocking Updates
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Tiramisu, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
While Aroma's PayloadLoader already has built-in update blocking functionality, it is recommended to delete the update folder to effectively block system updates. If you get a red warning screen while booting into Aroma, the update folder still exists and it is recommended to delete it using [this guide](../block-updates).
### Additional Homebrew Apps
@ -47,9 +34,15 @@ While Aroma's PayloadLoader already has built-in update blocking functionality,
| [Bloopair](https://github.com/GaryOderNichts/Bloopair/) ([Download](https://github.com/GaryOderNichts/Bloopair/releases)) | Allows wirelessly connecting most popular Bluetooth capable controllers. | 1. Extract the contents of the newly downloaded `Bloopair_vX.X.X.zip` file. <br> 2. Copy the `30_bloopair.rpx` to the `wiiu/environments/aroma/modules/setup/` folder on the root of your SD Card. <br> 3. Copy the `wiiu` folder to the root of your SD Card. |
| [Screenshot Plugin](https://github.com/wiiu-env/ScreenshotWUPS/) ([Download](https://github.com/wiiu-env/ScreenshotWUPS/releases)) | Allows taking screenshots directly to the SD Card. | 1. Extract the downloaded `screenshot_plugin_vX_X.zip` file. <br> 2. Copy the `screenshot.wps` to the `wiiu/environments/aroma/plugins` folder on the root of your SD Card. |
### Booting Tiramisu
### Pretendo Network
Pretendo is a replacement service for the Nintendo Network, which brings back online services as they are set to be discontinued. It also revives the Miiverse service, via juxtaposition. The official guide can be found [here](https://pretendo.network/docs/install/wiiu).
### Booting Tiramisu (optional)
?> Tiramisu is now archived, and was succeeded by Aroma and considered outdated. No more Homebrew will be developed for it, and services like Pretendo have ended support for it.
If you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
However, if you find the need to boot into Tiramisu, for example, to use a legacy Homebrew app, do the following:
1. Download the latest files from [Tiramisu for your café](https://tiramisu.foryour.cafe).
1. Copy the `wiiu` folder to the root of your SD Card.
@ -57,6 +50,7 @@ If you find the need to boot into Tiramisu, for example, to use a legacy Homebre
1. Take the SD Card out of your computer and plug it into your Wii U console.
1. Start the EnvironmentLoader.
- If you're autobooting into it, this can be done by powering on your console and holding X.
- You do not need to reinstall the PayloadLoader if you already did so with Aroma.
1. Highlight the entry called `tiramisu` using the D-Pad.
1. Launch Tiramisu by pressing A.
1. Launch the Wii U Menu by pressing A.

@ -15,7 +15,7 @@ For a detailed overview check out [this blogpost](https://maschell.github.io/hom
#### Modules
Aroma supports modules, which unlike setup modules, always run in the background.
This allows further extending the functionality of the console.
This allows for further extending the functionality of the console.
#### Plugins

@ -15,6 +15,7 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
1. Take the SD Card out of your PC and plug it into your Wii U.
2. Execute the web browser exploit as [previously explained](browser-exploit) but this time, you will need to hold the X button to open the Environment Loader menu.
3. Press A to launch the `aroma` environment.
- You will get a warning message about the update folder existing. This is normal. Press A to continue.
4. Press A to launch the Wii U Menu.
5. At the Wii U Menu, look for the newly appeared `PayloadLoader Installer` title (the round circle with an A inside of it) and launch it.
6. Press the A button to check if you can install the PayloadLoader.
@ -22,5 +23,3 @@ Installing the PayloadLoader will let you access Aroma just by running the Healt
7. Press the A button to select `Install / Update`.
8. You'll be asked if you are sure you want to install the PayloadLoader. Use the D-Pad to select `Install` and press A.
9. After installing has finished, press A to shut down the console.
!> If you do not wish to autoboot Aroma on your console, you can skip the `Autobooting Aroma` part and head directly to [Finalizing Setup](finalizing-setup).

Some files were not shown because too many files have changed in this diff Show More

Loading…
Cancel
Save