Wii - Getting Started With Homebrew
[FIELDSET="Preface"]This guide will run through how to open your wii to execute unsigned code (homebrew). In this guide we will be using the Twilight Hack to install the Homebrew Channel to easily launch homebrew apps from a dedicated channel on the System Menu. Be aware that this process does make a persistant change and there is a *slight* chance that things may go wrong, and you may brick. However, Team Twiizers have taken the upmost care to prevent this scenario. Niether MforMature or Team Twiizers accept any responsibility in the event you damage your Wii[/FIELDSET]
[FIELDSET="Materials"]
- Nintendo Wii (any firmware)
- A Copy of The Legend of Zelda: Twilight Princess
- A SD Card (even SDHC!)
- The Twilight Hack (available from hackmii)
- The Homebrew Channel (available from hackmii)
[FIELDSET="Process"]1. Download a copy of the Twilight Hack that corresponds to the region of your Zelda disc. Most of the time, you should be able to guess what region is mostly applicable
2. Extract the hack onto your SD card. This belongs in the folder /private/wii/title/ (EG: X:\private\wii\title\rzpd\ for windows).
2. Download the Homebrew Channel (HBC) installer from the link above. You will need an unarchiving program such as 7-Zip to extract from the .tar.gz archive (*nix users: .tar.gz unarchiving is most likely natively supported by your system already)
3. Place the HBC .dol in the root of your SD card. Ensure that it is named 'boot.dol'.
4. Insert the SD card and Twilight Princess disc into your wii and turn it on. Using the System Menu, navigate to Wii Settings, then point to the Save Data button. Select the Wii button from there.
5. Delete(1) your existing TP save. Switch to the SD Card, and then copy over the twilight hack onto your Wii.
6. Return to the System Menu. Point to the Disc channel to start up TP.
7. Once the game loads, select the available gamesave. You will then be presented with a screen showing link in one of the beginning stages of the game. Speak to the man or walk backwards to initiate the hack
8. The HBC installer will now begin. Simply follow the onscreen prompts to begin the installation. When you reboot your Wii console, you will notice a new channel. This is the homebrew channel and can be used to launch further homebrew.[/FIELDSET]
[FIELDSET="Extras"]Now with your shiny new HBC, you can launch homebrew conveniently without needing the twilight hack. Homebrew apps are stored on the SD card.
[FIELDSET="Adding Apps"]1. Download a piece of homebrew. Most likely, you will recieve:
- A .dol or .elf (the app itself) (The new HBC beta 9 prefers .dol, and some old .elf will not work)
- A meta.xml (a descriptor file for the HBC)
- An icon.png (a thumbnail for the HBC)
2. Place the boot.dol(2), meta.xml and icon.png into a dedicated folder on your SD card in the folder /apps/ (EG: X:\Apps\homebrew\)
3. Place the SD Card into the Wii and boot up the HBC. The app will now appear as an entry. Clicking on it will show a description pane where you may choose to launch the application.[/FIELDSET][/FIELDSET]
[FIELDSET="FAQs"]Q: Do I really need the HBC to run homebrew?
A: Technically, no. The boot.elf used by the twilight hack can contain any code, but the HBC was designed to streamline the process
Q: Do I need icon.png/meta.xml in the HBC?
A: No, these are simply used as iads to make launching from the HBC easier. Most homebrew already comes packaged with these files.
Q: What happens?
A: The twilight hack facilitates a 'stack smash' where to launch unsigned code. What actually happens is the name of your horse is made ridiculously long with launcher code so that when the game reads the name, the launcher code ends up in the stack, which is then executed.
Q: Hey! ELFs don't work anymore!
A: The new HBC adopted the standardised format for ELFs, so the old ELFs that weren't made correctly won't work anymore. You may have to convert them to DOL for them to work.
[/FIELDSET]
[FIELDSET="Kudos"]
- Team Twiizers, for their Twilight Hack and their Homebrew Channel software
- WiiBrew, for providing a definitive resource for all things related to Wii hackery, and for their guide from which this is derived.
[FIELDSET="Footnotes"]
- (1) : You may wish to back up your existing game save and restore it later on.
- (2) : You may have to rename the .elf or .dol to boot.elf or boot.dol respectively.
Feel free to post any troubles you may have along the way, and also any additions that can be made to this guide.