In memory of Ben “bushing” Byer, who passed away on Monday, February 8th, 2016.

Difference between revisions of "WiiBrew:FAQ"

From WiiBrew
Jump to navigation Jump to search
m (Whoops)
 
(153 intermediate revisions by 57 users not shown)
Line 1: Line 1:
These are some currently popular questions in the #wiihelp channel. Remember to read the [[Channel FAQ]] before you jump in.
+
This '''frequently asked questions''' page lists the most common problems associated with using Wii homebrew and does its best to provide solutions for you the reader. If you are having problems, chances are the solution to your problem(s) is present in this guide. Please at least skim through this guide before you ask your question to other people. Because, like I said before, the answers to your problems are most likely in here.
  
 +
== Homebrew safety ==
 +
=== Will installing homebrew damage my Wii? ===
 +
Updating the Wii is statistically more likely to cause a brick than installing homebrew. Additionally, installing homebrew offers brick protection that Nintendo's code fails to provide.
  
'''THIS IS NOT A PLACE TO ASK QUESTIONS.'''
+
Homebrew will not result in a ban from online services either (even when installed to internal memory), and all data prior to installing homebrew will remain intact.
  
 +
Do note, however, that other software (namely [[cIOS]] installers and WAD managers) may cause issues, and should not be run. Such software is not documented on this wiki.
  
==General==
+
=== Will Nintendo refuse to fix my Wii if I have homebrew installed? ===
 +
Yes. However, they no longer fix Wii's in the first place, and homebrew users generally fix hardware issues themselves to avoid having to deal with Nintendo.
  
===Does Homebrew cost money?===
+
=== Can homebrew be uninstalled? ===
No. Everything is completely free. If you have paid for homebrew, you have been '''scammed'''.
+
Yes. If any software refuses to uninstall, it can always be manually deleted.
  
===Are we using the SDK? Is there an SDK from Nintendo for Wii development? Is it leaked?===
+
=== Is it illegal to install homebrew? ===
[http://warioworld.com/apply No,] we are using the [http://en.wikipedia.org/wiki/Open_source open-source], freely available [[devkitPro]] and [[libogc]].
+
No. However, downloading pirated games is. Playing backups is also illegal under the DMCA and EUCD, as it breaks the Wii's copy protection. Neither downloading nor playing backups is supported here.
  
===Are there any homebrew applications available for the Wii?===
+
=== Does Homebrew cost money? ===
Many applications are available at the [[Homebrew apps]] page.
+
No. Everything is absolutely free. If you have paid for homebrew, you have been '''scammed'''.
  
===Will a Wii System Update brick my hacked Wii?===
+
=== So, what will I gain from installing homebrew? ===
Probably not, however, you must be careful what hacked programs you run on your Wii as the programs themselves are capable of bricking your Wii.
+
Homebrew unlocks a wide variety of things, such as emulators and custom games. A list of apps that can be run can be found [[List of homebrew applications|here]].
  
===How do I turn off my Wii if the application does not have an option to turn off, or hangs?===
+
== Getting started ==
Hold the power button for 5 seconds until the Wii powers down.
 
  
===What if the next Wii update patches the Twilight Hack?===
+
=== What does this word mean? ===
The [[System Menu 3.3]] & [[System Menu 3.4| 3.4]] Updates tried to patch this bug by deleting the Twilight Hack save and preventing it from being copied from an SD card into the internal storage.  Flaws in the implementation of those checks allowed the Twilight Hack to work around it, but we expect that the next update will do a better job of blocking the Twilight Hack.
+
We have a glossary of terms here: [[Glossary]]
  
Work is underway to find a hack in a new game, but we will not release it until the Twilight Hack stops working.
+
=== What System version do I need to install homebrew? ===
 +
Any version will work. However, it is recommended not to update to [[4.2]] or later (even if you do not plan on installing homebrew), although if you are already at 4.2 or later, you are safe to update and should NOT downgrade.
  
===What if the next Wii update patches the trucha bug?===
+
This is due to the fact that the update process for installing 4.2 is known to [[brick]] consoles, even without homebrew installed. To access [[4.3]] features, use tools such as [[WiiSCU]] and [[DOP-Mii]] to update the safe components.
The [[System Menu 3.3]] Update partially patched this bug (by including a newer version of IOS30). The [[23_Oct_Updates|October 23 update]] properly patched the trucha bug out of the rest of the IOSs.
 
  
 +
=== Will you help me install my modchip? ===
 +
No. Modchips are not supported here.
  
 +
=== What kind of an SD card should I use? ===
 +
As long as they're formatted to FAT 16 (FAT) or FAT 32, most SD cards should work for you. All SD cards smaller than 256mb will not work for you because they are too small to be formatted properly. If you are still unsure which type of card to use, this page may help you: [[SD/SDHC Card Compatibility Tests]].
  
==Wii Hacking==
+
=== What is the root of my SD card? ===
 +
A place on your SD card that is not inside any folders.
  
===What's happening now?===
+
=== In general, how do I install homebrew? ===
A lot of people are working on fancy Wii homebrew. Lots of work remains to be done.
+
First, you run an exploit. The exploit crashes the Wii and runs unsigned code in the form of a .dol/.elf file on the root of your SD Card. If that unsigned code is the [http://hackmii.com/2009/08/hackmii-installer-v0-3/ hackmii installer], you can then install the Homebrew Channel or BootMii.
  
For example:
+
== Twilight Hack Questions ==
* Building a working toolchain environment
 
* Making a working low-level library to access hardware (CPU/GPU/controllers/USB/Framebuffers and debugging)
 
* Documenting memory maps
 
* Discovering usage of registers for (Audio Interface, Serial Interface, Memory Interface, Video Interface)
 
* Triggering and setting up interrupt handling
 
* Working on a stable Initial Program Loader
 
* Reverse engineering [[IOS]] and other binary files
 
  
:Where can someone start learning skills like these, and start helping the community? Are there tutorials or pages anywhere that teach you the basics?--[[User:IqAndreas|IqAndreas]] 04:13, 15 November 2008 (UTC)
+
=== Can I use a backup of Twilight Princess? ===
 +
You should be using a legitimate copy of the game. We do not support backups/piracy here.
  
===The Fish Disc looks really promising===
+
=== Can I use the GameCube version of Twilight Princess? ===
The [[Wii Backup Disc|Fish Disc]] is able to transfer the bare essentials (savegames, preferences) of one Wii to another. It also allows all personal data to be erased, much like the "Format System Memory" option.  It is not useful for most end-users.
+
No. You need the Wii version of the game.
  
===How can I boot homebrew on my Wii?===
+
=== I cannot copy the Twilight Hack from my SD card to my Wii ===
See the [[Twilight Hack]].
+
Make sure you have a normal Twilight Princess save file in your Wii before you copy over the Twilight Hack. Also, it cannot be be copied if you are on firmware 4.0 or higher.
  
===What new features are you planning for the next release?===
+
=== It's not working ===
Hopefully, source code.
+
Make sure you are using beta 2 of the Twilight Hack if you are on 3.4 firmware and beta 1 if you are on firmware below 3.4. Make sure you have the correct region of the Twilight Hack on your Wii.
  
===How did this happen?===
+
== Bannerbomb Questions ==
The "tweezer" attack was originally used to access the restricted parts of the RAM. This allowed them to access/discover an exploit (as used in the original video).
 
  
This [[Signing bug]] exploit has been patched by Nintendo. More information on the signing exploit can be found in [http://debugmo.de/?p=61 this blog post] by tmbinc.
+
=== Why should I use Bannerbomb instead of the Twilight Hack? ===
 +
System Menu 4.0 and its successors have rendered the Twilight Hack useless. Bannerbomb is capable of working on every system menu up to 4.2. 4.3 fixed the exploit BannerBomb used. Also, some people feel that it is easier to use than the Twilight Hack. Finally, it does not require you to purchase a specific game.
  
There are a lot of keys, encryption methods, protection and systems in place. Most of these are not public.
+
=== Bannerbomb is freezing on me, what do I do? ===
 +
Below are some typical scenarios and options in case Bannerbomb freezes on you:
  
===Can I use the Wii Remote in the homebrew applications?===
+
* If you are on System Menu 4.1 or lower, do not use the SD Menu; instead go to Options -> Data Management -> Wii Channels -> SD Card. For 4.2 use SD Menu.
Most [[homebrew]] applications support the [[Wii Remote]]. See [[Wiiuse]] for more information. You may need to use a GameCube controller for some homebrew.
 
  
===Can I use GameCube homebrew on the Wii with a loader?===
+
* If Bannerbomb freezes before the prompt "Load boot.dol/elf?" try a different version.
[[Wii Gamecube Homebrew Launcher]] may work.
 
  
==Twilight Hack==
+
* If you run Bannerbomb and get the prompt "Load boot.dol/elf?" and it then freezes, confirm that you have a boot.dol or boot.elf in the root of your SD card (same as with the Twilight Hack). If it is there, try another homebrew application, but most likely Bannerbomb will not work for you.
  
===How does the Twilight Hack work?===
+
* If you are on any 3.x System Menu and you're having trouble running Bannerbomb, you could give up on Bannerbomb and try the Twilight Hack.
An exploit has been found in the Wii game "The Legend of Zelda: Twilight Princess". Once used it launches custom code. It is similar to the [http://en.wikipedia.org/wiki/Grand_Theft_Auto:_Liberty_City_Stories#PSP_exploit GTA PSP Exploit].
 
  
===How do I use the Twilight Hack?===
+
== Indiana Pwns Questions ==
The [[Twilight Hack]] page has everything you need to know on how to use the exploit.
 
  
===Is the Twilight Hack affected by the latest update?===
+
=== Can I use a backup of LEGO Indiana Jones? ===
Although the hack itself may not be, the [[System Menu 3.4 | November 17 update]] will check for and, if found,  delete the Twilight Hack save game and refuse to recopy it onto the Wii. A newer version of the Twilight Hack was made to defeat this check; it works, but gets deleted on every reboot.
+
No, you should be using the original copy. Backups are not supported or condoned by WiiBrew.
  
==Homebrew channel==
+
=== I have some problems... ===
 +
*Make sure you are using the correct region of the hack
 +
*Make sure you are looking at the ''second'' character in the art room
  
===Where can I get the homebrew channel?===
+
== Smash Stack Questions ==
[[Homebrew Channel|Right here]].
 
  
===Does the homebrew channel do "X"?===
+
=== I have some problems... ===
Check on [[Homebrew Channel|this]] page.
+
*You need to remember that this exploit only works if you are using a US NTSC version of the game and Wii.
 +
*Make sure you have renamed your entire original "private" directory on the SD card to "privateold" or something similar.
 +
*Make sure the Smash Stack "private" folder has been copied to the root of your SD card and you have a valid .elf file in the root directory.
  
===Can I request a feature for the homebrew channel?===
+
== Homebrew Channel Questions ==
[http://hackmii.com/2008/11/hbc-beta10-aka-your-last-chance/| Not anymore.]
+
 
 +
=== When installing the Homebrew Channel it fails to find boot.elf or boot.dol ===
 +
Make sure the Homebrew Channels boot.dol file is in the root of your SD card. If that still does not solve your problem, try a different SD card. Some SD cards are simply not compatible with exploits. SD Cards smaller than 256MB will not work. Note: SDHC cards cannot be used to install the Homebrew Channel from an exploit if the Wii itself does not support them.
 +
 
 +
=== Where are my apps? The Homebrew Channel is only a screen with bubbles. ===
 +
Make sure that you have these three basic things set up for apps on your SD card:
 +
 
 +
* There is a folder in the root of your SD card named apps. NOTE: apps is case sensitive. It can not be named APPS, aPpS or anything else other than apps in all lower case letters.
 +
 
 +
* Make sure that no more and no less than one folder is between the apps folder and the boot.dol or boot.elf file of an application.
 +
 
 +
* Make sure that each of your applications have a path that looks like: /apps/afolder/boot.dol or /apps/afolder/boot.elf
 +
 
 +
Also, make sure you are using a correctly formatted SD or SDHC card or USB device. (The card you used to install the Homebrew Channel will also work to run apps from).
 +
 
 +
=== Invalid Wii App ===
 +
Convert the .elf file of the application to a .dol file with the [[ELF to DOL Converter]].
 +
 
 +
=== I have another question... ===
 +
Read the official [http://hbc.hackmii.com/faq/ HBC FAQ] to find your answer.
 +
 
 +
== BootMii Questions ==
 +
 
 +
=== What is BootMii? ===
 +
Reading the [[BootMii|BootMii page on WiiBrew]] is the best thing you can do to learn what BootMii is.
 +
 
 +
=== Do I need to install BootMii? ===
 +
No. Installing BootMii is completely optional. However, it is highly recommended that you do install it. It has many benefits and there isn't really any reason not to.
 +
 
 +
=== I have another question... ===
 +
Read the official [http://bootmii.org/faq/ BootMii FAQ] to find your answer.
 +
 
 +
== After Homebrew Installation ==
 +
 
 +
=== Is it safe to update my Wii? ===
 +
Yes. The current updates will not ruin (brick) or hurt your Wii in any way on account of homebrew being installed on your Wii.
 +
 
 +
=== Is it safe to leave [[WiiConnect24]] on? ===
 +
It doesn't matter, as WiiConnect24 has been discontinued. If you wish to experience WiiConnect24 functionality again, use a re-implementation, such as [[RiiConnect24]] or [[WiiLink]].
 +
 
 +
=== I am looking for an app that... ===
 +
Please refer to the complete list of Wii Homebrew Applications here: [[Homebrew applications|Homebrew Applications List]] If you can not find an application that does what you are looking for it is either 1) Not supported by WiiBrew or 2) It doesn't exist. NOTE: New applications are being created just about every week so check back often.
 +
 
 +
=== Downgrading? ===
 +
Downgrading is '''not''' recommended. Every Wii system menu version will work equally well with homebrew at the moment and the risk of downgrading is not worth the reward.
 +
 
 +
== For Even More Help ==
 +
 
 +
=== This FAQ stinks! It didn't solve my problems! ===
 +
Please refer to all of these WiiBrew pages for further assistance:
 +
 
 +
[[Twilight Hack]]
 +
 
 +
[[Indiana Pwns‎]]
 +
 
 +
[[Bannerbomb]]
 +
 
 +
[[Smash Stack]]
 +
 
 +
[[LetterBomb]]
 +
 
 +
[[Homebrew Channel]]
 +
 
 +
[[DVDX]]
 +
 
 +
[[BootMii]]
 +
 
 +
[[Homebrew setup]]
 +
 
 +
=== I still have problems/questions/concerns ===
 +
Please post a topic in our [http://forum.wiibrew.org WiiBrew Forums] and you will be assisted shortly after.
 +
 
 +
=== I don't have time to read! I need help NOW!!! Like, this-instant NOW!!! ===
 +
Please go to the IRC. The server is EFNET (irc.efnet.org) The channel is #wiihelp. If you do not have an IRC client you may use mibbit to access the IRC with this link: [http://www.mibbit.com/chat/?url=irc://irc.efnet.org/wiihelp Mibbit WebIRC]. When you get to the channel, please remember to read the rules by typing "!rules" without quotes in the channel.
 +
 
 +
[[Category:FAQs]]

Latest revision as of 13:09, 17 November 2023

This frequently asked questions page lists the most common problems associated with using Wii homebrew and does its best to provide solutions for you the reader. If you are having problems, chances are the solution to your problem(s) is present in this guide. Please at least skim through this guide before you ask your question to other people. Because, like I said before, the answers to your problems are most likely in here.

Homebrew safety

Will installing homebrew damage my Wii?

Updating the Wii is statistically more likely to cause a brick than installing homebrew. Additionally, installing homebrew offers brick protection that Nintendo's code fails to provide.

Homebrew will not result in a ban from online services either (even when installed to internal memory), and all data prior to installing homebrew will remain intact.

Do note, however, that other software (namely cIOS installers and WAD managers) may cause issues, and should not be run. Such software is not documented on this wiki.

Will Nintendo refuse to fix my Wii if I have homebrew installed?

Yes. However, they no longer fix Wii's in the first place, and homebrew users generally fix hardware issues themselves to avoid having to deal with Nintendo.

Can homebrew be uninstalled?

Yes. If any software refuses to uninstall, it can always be manually deleted.

Is it illegal to install homebrew?

No. However, downloading pirated games is. Playing backups is also illegal under the DMCA and EUCD, as it breaks the Wii's copy protection. Neither downloading nor playing backups is supported here.

Does Homebrew cost money?

No. Everything is absolutely free. If you have paid for homebrew, you have been scammed.

So, what will I gain from installing homebrew?

Homebrew unlocks a wide variety of things, such as emulators and custom games. A list of apps that can be run can be found here.

Getting started

What does this word mean?

We have a glossary of terms here: Glossary

What System version do I need to install homebrew?

Any version will work. However, it is recommended not to update to 4.2 or later (even if you do not plan on installing homebrew), although if you are already at 4.2 or later, you are safe to update and should NOT downgrade.

This is due to the fact that the update process for installing 4.2 is known to brick consoles, even without homebrew installed. To access 4.3 features, use tools such as WiiSCU and DOP-Mii to update the safe components.

Will you help me install my modchip?

No. Modchips are not supported here.

What kind of an SD card should I use?

As long as they're formatted to FAT 16 (FAT) or FAT 32, most SD cards should work for you. All SD cards smaller than 256mb will not work for you because they are too small to be formatted properly. If you are still unsure which type of card to use, this page may help you: SD/SDHC Card Compatibility Tests.

What is the root of my SD card?

A place on your SD card that is not inside any folders.

In general, how do I install homebrew?

First, you run an exploit. The exploit crashes the Wii and runs unsigned code in the form of a .dol/.elf file on the root of your SD Card. If that unsigned code is the hackmii installer, you can then install the Homebrew Channel or BootMii.

Twilight Hack Questions

Can I use a backup of Twilight Princess?

You should be using a legitimate copy of the game. We do not support backups/piracy here.

Can I use the GameCube version of Twilight Princess?

No. You need the Wii version of the game.

I cannot copy the Twilight Hack from my SD card to my Wii

Make sure you have a normal Twilight Princess save file in your Wii before you copy over the Twilight Hack. Also, it cannot be be copied if you are on firmware 4.0 or higher.

It's not working

Make sure you are using beta 2 of the Twilight Hack if you are on 3.4 firmware and beta 1 if you are on firmware below 3.4. Make sure you have the correct region of the Twilight Hack on your Wii.

Bannerbomb Questions

Why should I use Bannerbomb instead of the Twilight Hack?

System Menu 4.0 and its successors have rendered the Twilight Hack useless. Bannerbomb is capable of working on every system menu up to 4.2. 4.3 fixed the exploit BannerBomb used. Also, some people feel that it is easier to use than the Twilight Hack. Finally, it does not require you to purchase a specific game.

Bannerbomb is freezing on me, what do I do?

Below are some typical scenarios and options in case Bannerbomb freezes on you:

  • If you are on System Menu 4.1 or lower, do not use the SD Menu; instead go to Options -> Data Management -> Wii Channels -> SD Card. For 4.2 use SD Menu.
  • If Bannerbomb freezes before the prompt "Load boot.dol/elf?" try a different version.
  • If you run Bannerbomb and get the prompt "Load boot.dol/elf?" and it then freezes, confirm that you have a boot.dol or boot.elf in the root of your SD card (same as with the Twilight Hack). If it is there, try another homebrew application, but most likely Bannerbomb will not work for you.
  • If you are on any 3.x System Menu and you're having trouble running Bannerbomb, you could give up on Bannerbomb and try the Twilight Hack.

Indiana Pwns Questions

Can I use a backup of LEGO Indiana Jones?

No, you should be using the original copy. Backups are not supported or condoned by WiiBrew.

I have some problems...

  • Make sure you are using the correct region of the hack
  • Make sure you are looking at the second character in the art room

Smash Stack Questions

I have some problems...

  • You need to remember that this exploit only works if you are using a US NTSC version of the game and Wii.
  • Make sure you have renamed your entire original "private" directory on the SD card to "privateold" or something similar.
  • Make sure the Smash Stack "private" folder has been copied to the root of your SD card and you have a valid .elf file in the root directory.

Homebrew Channel Questions

When installing the Homebrew Channel it fails to find boot.elf or boot.dol

Make sure the Homebrew Channels boot.dol file is in the root of your SD card. If that still does not solve your problem, try a different SD card. Some SD cards are simply not compatible with exploits. SD Cards smaller than 256MB will not work. Note: SDHC cards cannot be used to install the Homebrew Channel from an exploit if the Wii itself does not support them.

Where are my apps? The Homebrew Channel is only a screen with bubbles.

Make sure that you have these three basic things set up for apps on your SD card:

  • There is a folder in the root of your SD card named apps. NOTE: apps is case sensitive. It can not be named APPS, aPpS or anything else other than apps in all lower case letters.
  • Make sure that no more and no less than one folder is between the apps folder and the boot.dol or boot.elf file of an application.
  • Make sure that each of your applications have a path that looks like: /apps/afolder/boot.dol or /apps/afolder/boot.elf

Also, make sure you are using a correctly formatted SD or SDHC card or USB device. (The card you used to install the Homebrew Channel will also work to run apps from).

Invalid Wii App

Convert the .elf file of the application to a .dol file with the ELF to DOL Converter.

I have another question...

Read the official HBC FAQ to find your answer.

BootMii Questions

What is BootMii?

Reading the BootMii page on WiiBrew is the best thing you can do to learn what BootMii is.

Do I need to install BootMii?

No. Installing BootMii is completely optional. However, it is highly recommended that you do install it. It has many benefits and there isn't really any reason not to.

I have another question...

Read the official BootMii FAQ to find your answer.

After Homebrew Installation

Is it safe to update my Wii?

Yes. The current updates will not ruin (brick) or hurt your Wii in any way on account of homebrew being installed on your Wii.

Is it safe to leave WiiConnect24 on?

It doesn't matter, as WiiConnect24 has been discontinued. If you wish to experience WiiConnect24 functionality again, use a re-implementation, such as RiiConnect24 or WiiLink.

I am looking for an app that...

Please refer to the complete list of Wii Homebrew Applications here: Homebrew Applications List If you can not find an application that does what you are looking for it is either 1) Not supported by WiiBrew or 2) It doesn't exist. NOTE: New applications are being created just about every week so check back often.

Downgrading?

Downgrading is not recommended. Every Wii system menu version will work equally well with homebrew at the moment and the risk of downgrading is not worth the reward.

For Even More Help

This FAQ stinks! It didn't solve my problems!

Please refer to all of these WiiBrew pages for further assistance:

Twilight Hack

Indiana Pwns‎

Bannerbomb

Smash Stack

LetterBomb

Homebrew Channel

DVDX

BootMii

Homebrew setup

I still have problems/questions/concerns

Please post a topic in our WiiBrew Forums and you will be assisted shortly after.

I don't have time to read! I need help NOW!!! Like, this-instant NOW!!!

Please go to the IRC. The server is EFNET (irc.efnet.org) The channel is #wiihelp. If you do not have an IRC client you may use mibbit to access the IRC with this link: Mibbit WebIRC. When you get to the channel, please remember to read the rules by typing "!rules" without quotes in the channel.