Difference between revisions of "Wii Homebrew Launcher"

From WiiBrew
Jump to: navigation, search
(Re-added WAD download link. You didn't delete the other downloads that are outdated, did you? Also, it's safe to use, like any other WAD file(including Homebrew Channel).)
m (Grammar)
 
(45 intermediate revisions by 19 users not shown)
Line 1: Line 1:
{{Infobox homebrewapp
+
{{Infobox homebrew
| image = [[Image:Wii_Homebrew_Launcher.png|200px]]
+
| title      = Wii Homebrew Launcher
| title = Wii Homebrew Launcher
+
| image       = [[File:Wii_Homebrew_Launcher.png|200px]]
| description = Front SD Elf loader
+
| type        = loader
| type = Loader
+
| author      = [[User:Hell_hibou|Hell Hibou]]
| author = Hell Hibou
+
| version    = v1.0
| display = Any
+
| download   = http://perso.latribu.com/decker/wii/download/WiiHL-1-00-bin.zip
| download = [http://perso.latribu.com/decker/wii/download/WiiHL-07.zip v0.7]
+
| source      = http://www.mediafire.com/?pivbo506epvyvx2
| peripherals = {{Wiimote1}} {{GCNController}} {{FrontSD}}
+
| website    = http://wiihomebrewlauncher.be.cx
 +
| peripherals = {{Wiimote1}} {{ClassicController}} {{GCNController}} {{DVD}} {{FrontSD}} {{FrontSDHC}} {{SDGecko}} {{USBMSD}} {{WiFi}}
 +
| hbb        =
 
}}
 
}}
  
Line 14: Line 16:
 
Each program is represented by its own customizable "channel".
 
Each program is represented by its own customizable "channel".
  
==Installation==
+
== Installation ==
  
 
*Copy boot.elf to an SD card
 
*Copy boot.elf to an SD card
*Create a folder named homebrew on the root of the SD card. (X:\homebrew)
+
*Create a folder named 'HOMEBREW' or 'APPS' on the root of the SD card, USB-flash, DVD or a SMB directory share (Windows share).
 
*For each homebrew:
 
*For each homebrew:
**Create a folder in the homebrew folder(Max 8 symbols long)(X:\homebrew\12345678)
+
**Create a folder in the homebrew folder (X:\homebrew\12345678)
**Place The elf in that folder and name it "boot.elf"
+
**Place The elf or dol in that folder and name it "boot.elf" or "boot.dol"
 
** OPTIONAL: For a custom name: add a "title.txt" containing the channel's title
 
** OPTIONAL: For a custom name: add a "title.txt" containing the channel's title
** OPTIONAL: For a custom image: add a "title.bmp", it has to be a 24-bits bitmap of 132x95 pixels.
+
** OPTIONAL: For a custom image: add a "title.png" 132x95 pixels.
 
*Any files related to a homebrew can be put anywhere, despite what it may seem in the example.
 
*Any files related to a homebrew can be put anywhere, despite what it may seem in the example.
  
==Usage==
+
== Emulator interface ==
It can only be launched from the [[Twilight Hack]] or the [[Homebrew Channel]]. It requires the use of a Wiimote or a GameCube controller.
+
 
 +
You can use Wii Homebrew Launcher for launching a ROM with an emulator. A patched version of RIN is include in the ZIP file. Copy the content of "SD" directory in the root of your SD card. Put yours GameBoy ROMS into /EMULATOR/RIN/ROMS/ directory. Optionnally you can create a .bmp or .png file with the same name of the rom file (just change the extension) of 132x95 pixels.
 +
 
 +
Homebrew compatible with the interface emulator :
 +
* [[Wii Gamecube Homebrew Launcher]] (GameCube Homebrew loader)
 +
* [[RIN Wii]] (GameBoy emulator)
 +
 
 +
 
 +
== Usage ==
 +
It can be launched from the [[Twilight Hack]] or be installed as channel. It requires the use of a Wiimote or a GameCube controller.
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! {{GCNController}} !! {{Wiimote1}}  !! Action
+
! {{GCNController}} !! {{ClassicController}} !! {{Wiimote}}  !! Action
 
|-
 
|-
| {{GCAButton}} || {{WiimoteAButton}} || Launch the Channel
+
| {{GCAButton}} || {{ClassicAButton}} || {{WiimoteAButton}} || Launch the Channel
 
|-
 
|-
| {{GCLTrigger}} || {{WiimoteMinusButton}} || Change Page
+
| {{GCBButton}} || {{ClassicBButton}} ||{{WiimoteBButton}} || Preview screen
 
|-
 
|-
| {{GCRTrigger}} || {{WiimotePlusButton}} || Change Page
+
| {{GCLTrigger}}/{{GCRTrigger}} || {{ClassicMinusButton}}/{{ClassicPlusButton}} || {{WiimoteMinusButton}}/{{WiimotePlusButton}} || Change Page
 
|-
 
|-
| {{GCDPad}} || {{WiimoteDPad}} || Select a Channel
+
| {{GCDPad}} || {{ClassicDPad}} ||{{WiimoteDPad}} || Select a Channel
 
|-
 
|-
| {{GCStartButton}} || {{WiimoteHomeButton}} || Show/Hide Menu
+
| {{GCStartButton}} || {{ClassicHomeButton}} ||{{WiimoteHomeButton}} || Show/Hide Menu
 
|-
 
|-
| {{GCZButton}} || none || Refresh Channel List
+
| {{GCZButton}} || ? ||{{Wiimote1Button}} || Refresh Channel List / Read DVD
 
|-
 
|-
 
|}
 
|}
  
==Settings==
+
== Settings ==
 +
 
 +
=== SMB share (Windows share) ===
 +
 +
* To launch homebrew from your PC, create a directory (eg Wii.) Homebrew create folders, apps or emulator in it and place it your homebrew.
 +
 
 +
* Share this directory (SMB eg.).
 +
* Create / Edit a file SYSTEM/CONFIG/SMB.INI of the SD card.
  
===Display===
 
If you have any problem with the display you can manually set the video mode.
 
Just put a file named system.ini in the system\config\ folder of your SD card, and choose one of the following setting:
 
 
<source lang="ini">
 
<source lang="ini">
VideoMode = auto
+
Server  = 192.168.0.100
# VideoMode = PAL
+
Share    = wii
# VideoMode = mPAL
+
User    = gest
# VideoMode = euRGB60
+
Password =
# VideoMode = NTSC
 
 
</source>
 
</source>
  
Lines beginning with the # are comments.
+
=== Translation ===
 
 
===Translation===
 
 
To install a translation unzip the archive in the root of your SD card.
 
To install a translation unzip the archive in the root of your SD card.
Check the [[Homebrew_apps/Wii_Homebrew_Launcher#Downloads | Downloads]] section for available translations.
+
Check the [[Homebrew apps/Wii Homebrew Launcher#Downloads|Downloads]] section for available translations.
  
To make your own translation, create a file called lang.ini and put it in the system\config\ folder.
+
To make your own translation, create a file called lang.ini and put it in the SYSTEM/CONFIG/ folder.
 
Each line is a message to be translated. Only modify what is on the right of the = sign.
 
Each line is a message to be translated. Only modify what is on the right of the = sign.
 
Here is an example:
 
Here is an example:
  
 
<source lang="ini">
 
<source lang="ini">
NoHomebrewFound = No Homebrew found
+
nohomebrewfound = No Homebrew found
HomebrewMenu    = Homebrew menu
+
emulator   = Emulators
Return          = Return
+
homebrewmenu   = Homebrew menu
WiiMenu        = Wii menu
+
return   = Return
RestartLoader   = Restart loader
+
wiimenu   = Wii menu
Shutdown       = Shutdown Wii
+
restartloader   = Restart loader
Press           = Press
+
shutdown   = Shutdown Wii
 +
homebrew   = Homebrew
 +
applications   = Applications
 +
themes   = Themes
 +
themedefault   = Default theme
 +
wiichannels   = Wii Channels
 +
pressa   = Press (A)
 +
invalidexe   = Invalid executable file
 +
receptinprogress = Reception in progress...
 +
connexionerror   = Error data reception
 +
nofilesfound   = No files found
 
</source>
 
</source>
  
===Skin===
+
=== Skin ===
Skins must be installed in the SYSTEM/THEME folder of your SD card.
+
Skins must be installed in the SYSTEM/THEME/THEME NAME folder of your SD card.
To make your own skin you must create 11 24-bits bitmaps:
+
To make your own skin you must create 24-bits bitmaps or PNG:
  
*bar.bmp : Bar at the bottom of the screen
+
*bar.png : Bar at the bottom of the screen
*Bkgr.bmp : Background
+
*Bkgr.png : Background
*Button1.bmp : Unselected button
+
*Button1.png : Unselected button
*Button2.bmp : Selected button
+
*Button2.png : Selected button
*Default.bmp : Default icon for homebrew channel
+
*Default.png : Default icon for homebrew channel
*Empty.bmp : Empty icon for homebrew channel
+
*Empty.png : Empty icon for homebrew channel
*Font.bmp : Font
+
*Font.png : Font
*Right.bmp : Right arrow
+
*FontLight.png : Font lite
*Left.bmp : Left arrow
+
*Right.png : Right arrow
*Select.bmp : Image for selected channel
+
*Left.png : Left arrow
*Sprite.bmp : Mask to apply at channel icon *bar.bmp
+
*Select.png : Image for selected channel
 +
*Sprite.png : Mask to apply at channel icon bar.png
 +
*Used.png
 +
*Cursor.png : Cursor
 +
*MsgBox.png : Message box
 +
*Dir.png : Directory icon
  
Images could have any size, except default.bmp and sprite.bmp. They need to be 192 x 95 pixels.
+
Images could have any size, except default.png and sprite.png . They need to be 192 x 95 pixels.
 
 
The transparent color is (R:255 G:0 B:255), transparency works for all images, except default.bmp and Bkgr.bmp.
 
  
 
You must also create a file called theme.ini with the following information:
 
You must also create a file called theme.ini with the following information:
 +
Colors are in RGB in version >= 0.8.
 
<source lang="ini">
 
<source lang="ini">
ColorFontBar = 0xFA79FA82
+
ColorFontBar = 0x808080
ColorFontMenu = 0x80808080
+
ColorFontMenu = 0xFFFFF
ColorMenu = 0x00800080
+
ColorMenu = 0xFFFFFF
 
BackgroundInMenu = 1
 
BackgroundInMenu = 1
 
</source>
 
</source>
  
Colors are in the Wii format and not in RGB. Here are some examples taken from the libogc library:
 
{| class="wikitable"
 
|-
 
! Name
 
! Code
 
|-
 
| BLACK
 
| 0x00800080
 
|-
 
| MAROON
 
| 0x266A26C0
 
|-
 
| GREEN
 
| 0x4B554B4A
 
|-
 
| OLIVE
 
| 0x7140718A
 
|-
 
| NAVY
 
| 0x0EC00E75
 
|-
 
| PURPLE
 
| 0x34AA34B5
 
|-
 
| TEAL
 
| 0x59955940
 
|-
 
| GRAY
 
| 0x80808080
 
|-
 
| SILVER
 
| 0xC080C080
 
|-
 
| RED
 
| 0x4C544CFF
 
|-
 
| LIME
 
| 0x952B9515
 
|-
 
| YELLOW
 
| 0xE100E194
 
|-
 
| BLUE
 
| 0x1DFF1D6B
 
|-
 
| FUCHSIA
 
| 0x69D469EA
 
|-
 
| AQUA
 
| 0xB2ABB200
 
|-
 
| WHITE
 
| 0xFF80FF80
 
|-
 
| MONEYGREEN
 
| 0xD076D074
 
|-
 
| SKYBLUE
 
| 0xC399C36A
 
|-
 
| CREAM
 
| 0xFA79FA82
 
|-
 
| MEDGRAY
 
| 0xA082A07F
 
|}
 
 
Background music could be added to the theme. Just put an MP3 file named loop.mp3 in the same folder.
 
  
==Downloads==
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-07.zip Version 0.7]
 
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-06.zip Version 0.6]
 
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-05.zip Version 0.5]
 
  
 +
== Downloads ==
 +
=== Program ===
 +
*[http://perso.latribu.com/decker/wii/download/WiiHL-1-00-bin.zip Version 1.0] | [http://www.mediafire.com/?2jzdn243wd2 Mirror] (unnecessary files removed for smaller download size)
 +
*[http://perso.latribu.com/decker/wii/download/WiiHL-012.zip Version 0.12]
 +
*[http://perso.latribu.com/decker/wii/download/WiiHL-011.zip Version 0.11]
 +
*[http://perso.latribu.com/decker/wii/download/WiiHL-010.zip Version 0.10]
 +
*[http://perso.latribu.com/decker/wii/download/WiiHL-09.zip Version 0.9]
 +
*[http://perso.latribu.com/decker/wii/download/WiiHL-08.zip Version 0.8]
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-04.zip Version 0.4]
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-04.zip Version 0.4]
 
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-03.zip Version 0.3]
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-03.zip Version 0.3]
 
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-02.zip Version 0.2] | [http://ostsoft.net/go?to=wiidl&dl=16 Mirror] by Oste Hovel
 
*[http://perso.latribu.com/decker/wii/download/WiiHL-02.zip Version 0.2] | [http://ostsoft.net/go?to=wiidl&dl=16 Mirror] by Oste Hovel
 
 
*[http://perso.latribu.com/decker/wii/download/RTU-WiiHL-Homebrew-Pack.zip Homebrew pack] - 8 Wii homebrew apps in the correct format for the launcher (including images)
 
*[http://perso.latribu.com/decker/wii/download/RTU-WiiHL-Homebrew-Pack.zip Homebrew pack] - 8 Wii homebrew apps in the correct format for the launcher (including images)
[[Category:Loaders|Homebrew Launcher]]
 
 
*Channels:
 
:(NOTE: WAD files can be '''very dangerous'''. If there is anything wrong with the file, or if anything goes wrong with the installation, your Wii will be irreversibly bricked. DO NOT attempt to use this unless you fully understand the risks involved. Again, if anything goes wrong with the process, YOUR WII WILL NEVER WORK AGAIN. Only use this file if you are okay with this.)
 
{{HomebrewDangerousMisuse|WAD file}}
 
:*[http://www.mediafire.com/?hpjtdkm6na3 ORIGINAL Version 0.4 Channel Installer] by PaRaDoX
 
  
*Custom Icon Pack:
+
=== Custom Icon Pack ===
**[http://pspplayground.condor.serverpro3.com/index.php?topic=7526.0/ Custom Icon Pack] - A custom icon pack covering all (I think) Wii homebrew icons (plus some wishes!) | [http://www.box.net/shared/ep4aksr0o8 Mirror]
+
* [http://pspplayground.condor.serverpro3.com/index.php?topic=7526.0/ Custom Icon Pack] - A custom icon pack covering all (I think) Wii homebrew icons (plus some wishes!) | [http://www.box.net/shared/ep4aksr0o8 Mirror]
[[Category:Loaders|Homebrew Launcher]]
+
* [http://www.wiigen.fr/index.php?option=com_smf&Itemid=43&topic=4114.0 Custom Icon Pack] - On a French forum
**[http://www.wiigen.fr/index.php?option=com_smf&Itemid=43&topic=4114.0 Custom Icon Pack] - On a French forum
 
  
*Custom Skins:
+
=== Custom Skins ===
**[http://www.fileden.com/files/2007/3/19/902259/grrlib.zip GRRLib Skin]
+
* [http://www.fileden.com/files/2007/3/19/902259/grrlib.zip GRRLib Skin]
**[http://perso.latribu.com/decker/wii/download/Theme-Mario-05.zip Mario Bros Skin] - [http://perso.latribu.com/decker/wii/images/Mario.png Screenshot]
+
* [http://perso.latribu.com/decker/wii/download/Theme-Mario-05.zip Mario Bros Skin] - [http://perso.latribu.com/decker/wii/images/Mario.png Screenshot]
**[http://pspplayground.condor.serverpro3.com/index.php?topic=7648.msg41961#msg41961 "Classic" Custom Menu] by Mr_Nick666 - [http://i266.photobucket.com/albums/ii243/MisterNick666/N666WiiLaunchMenuMOCK.png Screenshot]
+
* [[Media:Condorstrike_Wiihl.zip|Condorstrike Skin "Wiihl-edition"]] - by {{u|Condorstrike}} - [[Media:Condorstrike_Wiihl_screenshot1.jpg|Screenshot1]] - [[Media:Condorstrike_Wiihl_screenshot2.jpg|Screenshot2]] - [[Media:Condorstrike_Wiihl_screenshot3.jpg|Screenshot3]]
 +
*[http://pspplayground.condor.serverpro3.com/index.php?topic=7648.msg41961#msg41961 "Classic" Custom Menu] by Mr_Nick666 - [http://i266.photobucket.com/albums/ii243/MisterNick666/N666WiiLaunchMenuMOCK.png Screenshot]
  
*Translations:
+
=== Translations ===
** [http://perso.latribu.com/decker/wii/download/Lang-En.zip English]
+
* [http://perso.latribu.com/decker/wii/download/Lang-Fr.zip French]
** [http://rapidshare.com/files/111067798/Lang-De.zip.html Deutsch]
+
* [[Media:Lang-eo.zip|Esperanto]]
** [[:Image:Lang-it.zip|Italian]]
+
* [http://rapidshare.com/files/111067798/Lang-De.zip.html German]
** [[:Image:Lang-es.zip|Spanish]]
+
* [[Media:Lang-it.zip|Italian]]
 +
* [[Media:Lang-es.zip|Spanish]]
 +
* Pirate Speak (as seen in Minecraft) - [https://dl-web.dropbox.com/get/Lang-piratespeak-WHBL.zip?_subject_uid=351447022&w=AADGVx0f_oS6hSkN7jd1sdD85vg_p4qAguNkKxGBSsAXOw&dl=1 Launcher + Translation] - [[Media:Lang-piratespeak-WHBL.zip|Translation Only]]
  
==Contact==
+
== Contact ==
 
*[http://wiihomebrewlauncher.be.cx/ The official Web site] ([http://translate.google.com/translate?u=http%3A%2F%2Fwiihomebrewlauncher.be.cx%2F&langpair=fr%7Cen&hl=en&ie=UTF8 English translation])
 
*[http://wiihomebrewlauncher.be.cx/ The official Web site] ([http://translate.google.com/translate?u=http%3A%2F%2Fwiihomebrewlauncher.be.cx%2F&langpair=fr%7Cen&hl=en&ie=UTF8 English translation])
  
[[Category:Loaders| Wii Homebrew Launcher]]
+
*[http://www.devsgen.com/forum/index.php?topic=2432.0 Forum]

Latest revision as of 01:10, 30 August 2017

Wii Homebrew Launcher
Wii Homebrew Launcher.png
General
Author(s)Hell Hibou
TypeLoader
Versionv1.0
Links
Download
Website
Source
Peripherals
Wiimote1.svg ClassicController.svg GameCube Controller DVD Loads files from the Front SD slot Loads files from SDHC cards in the Front SD slot SD Gecko USB mass storage device Local WiFi


Wii Homebrew Launcher is an interface similar to that of the Wii menu. It allows you to start homebrew stored on your SD card in the Wii front SD slot. Each program is represented by its own customizable "channel".

Installation

  • Copy boot.elf to an SD card
  • Create a folder named 'HOMEBREW' or 'APPS' on the root of the SD card, USB-flash, DVD or a SMB directory share (Windows share).
  • For each homebrew:
    • Create a folder in the homebrew folder (X:\homebrew\12345678)
    • Place The elf or dol in that folder and name it "boot.elf" or "boot.dol"
    • OPTIONAL: For a custom name: add a "title.txt" containing the channel's title
    • OPTIONAL: For a custom image: add a "title.png" 132x95 pixels.
  • Any files related to a homebrew can be put anywhere, despite what it may seem in the example.

Emulator interface

You can use Wii Homebrew Launcher for launching a ROM with an emulator. A patched version of RIN is include in the ZIP file. Copy the content of "SD" directory in the root of your SD card. Put yours GameBoy ROMS into /EMULATOR/RIN/ROMS/ directory. Optionnally you can create a .bmp or .png file with the same name of the rom file (just change the extension) of 132x95 pixels.

Homebrew compatible with the interface emulator :


Usage

It can be launched from the Twilight Hack or be installed as channel. It requires the use of a Wiimote or a GameCube controller.

GameCube Controller ClassicController.svg Wiimote.svg Action
Gamecube A Button Classic a Button Wiimote A Button Launch the Channel
Gamecube B Button Classic b Button Wiimote B Button Preview screen
GameCube L Trigger/GameCube R Trigger Classic - Button/Classic + Button Wiimote - Button/Wiimote + Button Change Page
GameCube D-Pad Classic D-Pad Wiimote D-Pad Select a Channel
GameCube START Button Classic HOME Button Wiimote HOME Button Show/Hide Menu
GameCube Z Button ? Wiimote 1 Button Refresh Channel List / Read DVD

Settings

SMB share (Windows share)

  • To launch homebrew from your PC, create a directory (eg Wii.) Homebrew create folders, apps or emulator in it and place it your homebrew.
  • Share this directory (SMB eg.).
  • Create / Edit a file SYSTEM/CONFIG/SMB.INI of the SD card.
Server   = 192.168.0.100
Share    = wii
User     = gest
Password =

Translation

To install a translation unzip the archive in the root of your SD card. Check the Downloads section for available translations.

To make your own translation, create a file called lang.ini and put it in the SYSTEM/CONFIG/ folder. Each line is a message to be translated. Only modify what is on the right of the = sign. Here is an example:

nohomebrewfound = No Homebrew found
emulator	  = Emulators
homebrewmenu	  = Homebrew menu
return		  = Return
wiimenu	  = Wii menu
restartloader	  = Restart loader
shutdown	  = Shutdown Wii
homebrew	  = Homebrew
applications	  = Applications
themes		  = Themes
themedefault	  = Default theme
wiichannels	  = Wii Channels
pressa		  = Press (A)
invalidexe	  = Invalid executable file
receptinprogress = Reception in progress...
connexionerror	  = Error data reception
nofilesfound	  = No files found

Skin

Skins must be installed in the SYSTEM/THEME/THEME NAME folder of your SD card. To make your own skin you must create 24-bits bitmaps or PNG:

  • bar.png : Bar at the bottom of the screen
  • Bkgr.png : Background
  • Button1.png : Unselected button
  • Button2.png : Selected button
  • Default.png : Default icon for homebrew channel
  • Empty.png : Empty icon for homebrew channel
  • Font.png : Font
  • FontLight.png : Font lite
  • Right.png : Right arrow
  • Left.png : Left arrow
  • Select.png : Image for selected channel
  • Sprite.png : Mask to apply at channel icon bar.png
  • Used.png
  • Cursor.png : Cursor
  • MsgBox.png : Message box
  • Dir.png : Directory icon

Images could have any size, except default.png and sprite.png . They need to be 192 x 95 pixels.

You must also create a file called theme.ini with the following information: Colors are in RGB in version >= 0.8.

ColorFontBar = 0x808080
ColorFontMenu = 0xFFFFF
ColorMenu = 0xFFFFFF
BackgroundInMenu = 1


Downloads

Program

Custom Icon Pack

Custom Skins

Translations

Contact