Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion LICENSE.txt
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Copyright (c) 2017-2023 RiiConnect24
Copyright (c) 2023 Nintendo Homebrew
Copyright (c) 2023-2026 Nintendo Homebrew

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
2 changes: 1 addition & 1 deletion docs/.vitepress/i18n/en_US.js
Original file line number Diff line number Diff line change
Expand Up @@ -661,7 +661,7 @@ const themeConfig = {
],
},
footer: {
copyright: 'Copyright © 2025 Nintendo Homebrew',
copyright: 'Copyright © 2026 Nintendo Homebrew',
items: [
{ text: localeData.pages["donations"], link: `/donations` },
{ text: localeData.pages["privacy-policy"], link: `/privacy-policy` },
Expand Down
4 changes: 2 additions & 2 deletions docs/bricks.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ Verify in AnyRegion Changer that your console region is the same as the theme or

If this was caused by a theme you installed, use [csm-installer](themes) to reinstall the original theme.

If this was caused by a Wii Menu WAD you installed, use [NUS Downloader](https://wiibrew.org/wiki/NUSD) to re-obtain your original Wii Menu.
If this was caused by a Wii Menu WAD you installed, use [NUSGet](https://github.com/NinjaCheetah/NUSGet) to re-obtain your original Wii Menu.

::: danger

Expand Down Expand Up @@ -184,7 +184,7 @@ You must have BootMii as boot2 to fix this.

You can either restore a NAND backup, or do this:

1. Use [NUS Downloader](https://wiibrew.org/wiki/NUSD) to pack a WAD of your original Wii Menu.
1. Use [NUSGet](https://github.com/NinjaCheetah/NUSGet) to pack a WAD of your original Wii Menu.
1. Use BootMii to enter the Homebrew Channel, and use a WAD manager to install the Wii Menu WAD.

For vWii, see [Recover a vWii IOS/Channel](https://wiiu.hacks.guide/recover-vwii-ioses-channels).
Expand Down
40 changes: 24 additions & 16 deletions docs/cios.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,9 +36,9 @@ Ensure that if you are using an SD card, the lock switch is in the unlocked posi

### Section I - Downloading

::: info
::: warning

If you are on macOS or Linux, you may download & run [this script](/assets/files/d2x_offline_ios.zip), and it will download the WAD files for you.
Your browser or antivirus software may flag NUSGet as malware - this is a false positive. NUSGet does NOT contain any malware.

:::

Expand All @@ -48,26 +48,34 @@ If you are able to connect your Wii to the internet, you may skip to [Section II

:::

1. Power off your console.
1. Insert your SD card or USB drive into your computer.
1. On your computer, download [NUS Downloader](https://github.com/WiiDatabase/nusdownloader/releases/latest/download/NUSD-Mod-NUS-Fix.zip).
1. Copy all files from the NUS Downloader `.zip` to a folder on your computer.
1. Run `NUS Downloader.exe`.
1. Navigate to `Database` > `IOS` > `IOS38`, then select `v4123`.
+ Ensure that "Pack WAD" is checked.
+ *Don't* check "Patch IOS". That is the cIOS Installer's job.
1. Click `Start NUS Download!`.
1. Repeat the above steps for `IOS56 v5661`, `IOS57 v5918` and `IOS58 v6175`.
1. When the process is complete, there will be a folder named `titles` in the same folder as the NUS Downloader.
1. Open the `titles` folder and navigate through them until you locate the four WAD files you downloaded.
1. Power off your console, and insert your SD card or USB drive into your computer.
1. On your computer, download [NUSGet](https://github.com/NinjaCheetah/NUSGet/releases/latest/), choosing the archive corresponding to your operating system. For Windows users, you should choose the `NUSGet-Windows-x86_64-bin.zip` file.
1. Unzip the archive and run the NUSGet executable.
1. Navigate to `IOS` > `IOS 38` > `World` and select `v4123`. Uncheck `Keep encrypted contents`. Check `Use a custom download directory` and select the folder that your NUSGet executable is in, then click `Start Download`.

![](/images/desktop-apps/nusget/nusget-4123.png)
1. Repeat the above step for `IOS 56 (v5661)`, `IOS 57 (v5918)` and `IOS 58 (v6175)`.
1. When you have finished downloading the above IOS, navigate to the folder where your NUSGet executable is stored. This should now contain four different folders with the title IDs for the above IOS.

![](/images/desktop-apps/nusget/nusget-folder-ios.png)
1. Enter the four directories, locating a `IOS-XX-vXXXX-Wii.wad` file in each.

![](/images/desktop-apps/nusget/nusget-ios-output.png)
1. Place each WAD file on the root of your SD card or USB drive.
+ This must be the same device containing the d2x cIOS Installer.

1. Ensure that each WAD file is named as listed below for compatability purposes with d2x-cios-installer:

| IOS | File Name |
| :---------: | :---------------------: |
| IOS 38 | IOS38-64-v4123.wad |
| IOS 56 | IOS56-64-v5661.wad |
| IOS 57 | IOS57-64-v5918.wad |
| IOS 58 | IOS58-64-v6175.wad |
::: info

The WAD files should be on your SD card like this:

![](/images/cios/d2x_offline_ios.png)
![](/images/desktop-apps/nusget/nusget-ios-on-sd.png)

:::

Expand Down
2 changes: 1 addition & 1 deletion docs/dump-wads.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ This guide will show you how to dump WADs from your Wii System Memory.

![](/images/homebrew/DumpWADS/6.png)

The WAD has now been dumped, and should appear at the specified directory on your SD card or USB drive.
The WAD has now been dumped, and should appear inside the specified folder on your SD card or USB drive.

![](/images/homebrew/DumpWADS/7.png)

Expand Down
2 changes: 1 addition & 1 deletion docs/homebrew-dolphin.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ On Dolphin Emulator version `5.0-4588` or later, the Wii Menu can be easily inst

## Requirements

* A Windows/MacOS/Linux computer with an Internet connection
* A Windows/macOS/Linux computer with an Internet connection
* [Dolphin Emulator](https://dolphin-emu.org/download/) version `5.0-4588` or later
* The latest version of [Open Homebrew Channel](https://github.com/Wii-Mini-Hacking/hbc/releases)

Expand Down
2 changes: 1 addition & 1 deletion docs/letterbomb.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Do NOT use any of the MAC address examples shown in this guide, as they will sim

* An SD card formatted as FAT32 that is 32GB or less
* A Wii on System Menu version 4.3
* A Windows/MacOS/Linux computer with an Internet connection
* A Windows/macOS/Linux computer with an Internet connection

## Instructions

Expand Down
2 changes: 1 addition & 1 deletion docs/nintendowfc.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ A method for Wiimmfi patching which runs on game disc images, but must be manual
1. Download the patcher and extract the `.zip` file.
1. Open the extracted folder and copy your Wii game images into it.
+ If you're on Windows, double-click the `patch-images.bat` file (this may also be displayed as "patch-images" Batch File). If you run into Cygwin-related issues, try the `patch-images-32.bat` file instead.
+ If you're on MacOS, open a command line prompt in the current folder, make the shell script executable through the command `chmod +x *.sh` and then execute `./patch-images.sh`.
+ If you're on macOS, open a command line prompt in the current folder, make the shell script executable through the command `chmod +x *.sh` and then execute `./patch-images.sh`.
+ If you're on Linux, double-click the `patch-images.desktop` file (this may also be displayed as "Patch Images") or execute the `./patch-images.sh` file in a terminal after making it executable through the command `chmod +x *.sh`.
1. If the above was successful, you should see a window pop-up that displays the patching process. Once the process finishes, you will find the patched images in a folder called `wiimmfi-images`.

Expand Down
4 changes: 2 additions & 2 deletions docs/osc.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ If you get a User Account Control pop-up that asks whether or not you would like

![](/images/osc/app-download-OSCDL.png)

1. If downloaded directly, a dialog box will pop up asking you for a download location. OSCDL will prompt you if it detects a storage device with an apps directory, and if downloaded there, it will automatically unzip the homebrew and be ready to use. Otherwise, you may specify a manual download location and unzip it yourself.
1. If downloaded directly, a dialog box will pop up asking you for a download location. OSCDL will prompt you if it detects a storage device with an apps folder, and if downloaded there, it will automatically unzip the homebrew and be ready to use. Otherwise, you may specify a manual download location and unzip it yourself.

![](/images/osc/download-prompt-OSCDL.png)

Expand Down Expand Up @@ -92,7 +92,7 @@ You will need Python 3 installed in order to use OSCDL on these platforms.

![](/images/osc/app-download-OSCDL-linux.png)

1. If downloaded directly, a dialog box will pop up asking you for a download location. OSCDL will prompt you if it detects a storage device with an apps directory, and if downloaded there, it will automatically unzip the homebrew and be ready to use. Otherwise, you may specify a manual download location and unzip it yourself.
1. If downloaded directly, a dialog box will pop up asking you for a download location. OSCDL will prompt you if it detects a storage device with an apps folder, and if downloaded there, it will automatically unzip the homebrew and be ready to use. Otherwise, you may specify a manual download location and unzip it yourself.

![](/images/osc/download-prompt-OSCDL-linux.png)

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
65 changes: 34 additions & 31 deletions docs/themes.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,52 +62,55 @@ Before proceeding, it helps to know the difference between .MYM and .CSM as file

::::

:::: tab (Wii) Via NUS Downloader

1. On your computer, download [NUS Downloader](https://github.com/WiiDatabase/nusdownloader/releases/latest/download/NUSD-Mod-NUS-Fix.zip).
1. Copy all files from the NUS Downloader `.zip` to a folder on your computer.
1. Run `NUS Downloader.exe`.
1. Navigate to `Database` -> `System` -> `System Menu`.
1. Select the version that corresponds to your Wii menu version.
1. Check the `Create decrypted contents (*.app)` box.
1. Click `Start NUS Download!`.
1. Once the download is finished, there will be a folder named `titles` in the same folder as the NUS Downloader.
1. Open the `titles` folder, then the `0000000100000002` folder inside it.
1. Find the **largest .app file** (usually 6~7MB) inside the folder.
:::: tab (Wii) Via NUSGet

1. On your computer, download [NUSGet](https://github.com/NinjaCheetah/NUSGet/releases/latest/), choosing the archive corresponding to your operating system. For Windows users, you should choose the `NUSGet-Windows-x86_64-bin.zip` file.
1. Unzip the archive and run the NUSGet executable.
1. Navigate to `System` > `System Menu` > `Your Region` and then select the Wii menu version you are running. Check the `Create decrypted contents (*.app)` option. Check `Use a custom download directory` and select the folder that your NUSGet executable is in, then click `Start Download`.

![](/images/desktop-apps/nusget/nusget-wiimenu-dl.png)
1. When you have finished downloading the Wii menu files, navigate to the folder where your NUSGet executable is stored. You should locate and open the `0000000100000002` folder inside it.

![](/images/desktop-apps/nusget/nusget-folder-wiimenu.png)
1. Find the **largest .app file** (usually ~6-7MB) inside the folder.

![](/images/desktop-apps/nusget/nusget-wiimenu-output.png)
1. Create a `themes` folder on the root of your SD card/USB device.
1. Copy the .app file to the newly created `themes` folder. This is the base theme you will use to build your custom theme.

::::

:::: tab (vWii) Via NUS Downloader
:::: tab (vWii) Via NUSGet

1. On your computer, download [NUS Downloader (vWii)](/assets/files/NUSDownloader-vwii.zip)
1. Copy all files from the vWii NUS Downloader `.zip` to a folder on your computer.
1. Run `NUS Downloader.exe`.
1. Navigate to `Database` -> `System` -> `System Menu`.
1. On your computer, download [NUSGet](https://github.com/NinjaCheetah/NUSGet/releases/latest/), choosing the archive corresponding to your operating system. For Windows users, you should choose the `NUSGet-Windows-x86_64-bin.zip` file.
1. Unzip the archive and run the NUSGet executable.
1. Select the `vWii` tab and navigate to `System` > `System Menu` > `Your Region`.
1. Select the version that corresponds to your Wii U's region in the table below:

| Region | vWii Menu version |
| --------- | -------------------- |
| Japan | v608 |
| USA | v609 |
| Europe | v610 |
| Region | vWii Menu version |
| :---------: | :---------------------------: |
| Japan | v608 (4.3J - Wii U v5.2.0J) |
| USA | v609 (4.3U - Wii U v5.2.0U) |
| Europe | v610 (4.3E - Wii U v5.2.0E) |

1. Check the `Create decrypted contents (*.app)` box.
1. Click `Start NUS Download!`.
1. Once the download is finished, there will be a folder named `titles` in the same folder as the NUS Downloader.
1. Open the `titles` folder, then the `0000000700000002` folder inside it.
1. Check the `Create decrypted contents (*.app)` box. Check `Use a custom download directory` and select the folder that your NUSGet executable is in, then click `Start Download`.

![](/images/desktop-apps/nusget/nusget-vwiimenu-dl.png)
1. When you have finished downloading the Wii menu files, navigate to the folder where your NUSGet executable is stored. You should locate and open the `0000000700000002` folder inside it.

![](/images/desktop-apps/nusget/nusget-folder-vwiimenu.png)
1. Find the .app file that corresponds to your Wii U's region in the table below:

| Region | .app file |
| --------- | ------------- |
| Japan | 0000001c.app |
| USA | 0000001f.app |
| Europe | 00000022.app |
| Region | .app file |
| :---------: | :-------------: |
| Japan | 0000001C.app |
| USA | 0000001F.app |
| Europe | 00000022.app |

1. Create a `themes` folder on the root of your SD card/USB device.
1. Copy the .app file to the newly created `themes` folder. This is the base theme you will use to build your custom theme.


::::

:::: tab (Wii) Via ThemeMii
Expand Down
36 changes: 20 additions & 16 deletions docs/update.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,29 +13,33 @@ It is much safer to use [ModMii](modmii) (Windows only) to update your Wii to 4.
* a Wii with The Homebrew Channel 1.0.8 or later
* If you do not have the Homebrew Channel or it is out of date, please [start here](get-started) to (re)install it first.
* An SD card or USB drive
* A computer with Windows on it
* [NUS Downloader](https://github.com/WiiDatabase/nusdownloader/releases/latest)
* A Windows/macOS/Linux computer
* [NUSGet](https://github.com/NinjaCheetah/NUSGet/releases/latest/)
* [Priiloader](priiloader)
* [YAWM ModMii Edition](https://oscwii.org/library/app/yawmme)

## Instructions

### Section I - Downloading

1. Extract the .zip file for NUS Downloader Wii and open the application.
1. Go to `Database...` > `System` > `0000000100000002 - System Menu` and select the version corresponding to your region as shown in the table below.
1. Make sure `Pack WAD` is checked.
1. Press `Start NUS Download!`.
1. Open the `titles` -> `0000000100000002` -> (Wii Menu version) and copy the .wad file to a folder called `wad` on your SD Card or USB drive.
1. Repeat steps 2-5 with `IOS` -> `000000010000003A` -> `Latest Version` and `IOS` -> `0000000100000050` -> `Latest Version`.
1. After you have copied all 3 `.wad` files, eject your SD card/USB drive from your PC and put it back into your Wii.

| Region | Wii Menu version |
| ------ | ---------------- |
| Japan | v512 (4.3J) |
| USA | v513 (4.3U) |
| Europe | v514 (4.3E) |
| Korea | v518 (4.3K) |
1. On your computer, download NUSGet using the link above, choosing the archive corresponding to your operating system. For Windows users, you should choose the `NUSGet-Windows-x86_64-bin.zip` file.
1. Unzip the archive and run the NUSGet executable.
1. Go to `System` > `0000000100000002 - System Menu` > `Your Region` and then select the latest 4.3 version of the menu (e.g. `v513 4.3U` for USA). Uncheck `Keep encrypted contents`. Check `Use a custom download directory` and select the folder that your NUSGet executable is in, then click `Start Download`.

![](/images/desktop-apps/nusget/nusget-wiimenu-dl-alt.png)
1. Go to `IOS` > `000000010000003A - IOS 58` > `World` > `Latest Version`. Uncheck `Keep encrypted contents`. Check `Use a custom download directory` and select the folder that your NUSGet executable is in, then click `Start Download`.

![](/images/desktop-apps/nusget/nusget-ios58-dl.png)
1. Go to `IOS` > `0000000100000050 - IOS 80` > `World` > `Latest Version`. Uncheck `Keep encrypted contents`. Check `Use a custom download directory` and select the folder that your NUSGet executable is in, then click `Start Download`.

![](/images/desktop-apps/nusget/nusget-ios80-dl.png)
1. When you have finished the above steps, navigate to the folder where your NUSGet executable is stored. This should now contain three different folders with the title IDs for the downloaded IOS and Wii menu files.

![](/images/desktop-apps/nusget/nusget-folder-wiimenu-alt.png)
1. Go into the folders corresponding to the title numbers for the above, and locate the singular WAD file in each. You will need to copy these to a folder called `wad` on your SD card or USB drive. The end result should include the files below in the folder:

![](/images/desktop-apps/nusget/nusget-copy-wiimenu-sd.png)
1. After you have copied all 3 WAD files, eject your SD card/USB drive from your PC and insert it back into your Wii.

### Section II - Installing

Expand Down
12 changes: 6 additions & 6 deletions docs/wii-backups.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Managing Wii Backups

This guide provides instructions on how to manage your Wii backups, from joining .PART files that are output through CleanRip, to shrinking game files that can be copied onto a FAT32 device. Two programs that can be used to manage your Wii backups are Wii Backup Manager (for Windows) and Wii Backup Fusion (for Linux and MacOS) and are covered below.
This guide provides instructions on how to manage your Wii backups, from joining .PART files that are output through CleanRip, to shrinking game files that can be copied onto a FAT32 device. Two programs that can be used to manage your Wii backups are Wii Backup Manager (for Windows) and Wii Backup Fusion (for Linux and macOS) and are covered below.

::: info

Expand Down Expand Up @@ -55,7 +55,7 @@ If your disc was dumped to a FAT32 device, you should have gotten at least two f

![](/images/desktop-apps/WBM/dumpedpartfileslinux.png)

1. Open a terminal in the directory where your files are at, or `cd [PATH]` to it.
1. Open a terminal in the folder where your files are located, or `cd [PATH]` to it.

![](/images/desktop-apps/WBM/openterminallinux.png)

Expand Down Expand Up @@ -102,7 +102,7 @@ If your disc was dumped to a FAT32 device, you should have gotten at least two f

### Requirements

* A PC running MacOS or Linux
* A PC running macOS or Linux
* A USB drive or SD card
* A dumped ISO from a Wii game disc
* [Wii Backup Fusion](https://github.com/larsenv/Wii-Backup-Fusion/releases)
Expand All @@ -125,16 +125,16 @@ If your disc was dumped to a FAT32 device, you should have gotten at least two f

![](/images/desktop-apps/WBM/loadwbf.png)

1. Select the directory where your game ISO is at.
1. Select the folder where your game ISO is located.

![](/images/desktop-apps/WBM/opendirectorywbf.png)

1. Right click on the game that you want to transfer to a drive, and press `Transfer to image`. Use the following settings:

![](/images/desktop-apps/WBM/settingswbf.png)

1. If there is not already a `wbfs` directory on your game drive, make one.
1. Make another directory inside of the `wbfs` folder for the game backup. Take note of the Game ID in Wii Backup Fusion as you will need this for the game folder.
1. If there is not already a `wbfs` folder on your game drive, make one.
1. Make another folder inside of the `wbfs` folder for the game backup. Take note of the Game ID in Wii Backup Fusion as you will need this for the game folder.
1. Make a game folder for your game, formatted as `game name [GAMEID]`. For the game dumped as an example in this guide, it would be named `New Super Mario Bros. Wii [SMNE01]`.

![](/images/desktop-apps/WBM/wbfsname.png)
Expand Down
Loading