Homebrew Official Homebrew Launcher for WiiU

  • Thread starter Cyan
  • Start date
  • Views 731,201
  • Replies 1,171
  • Likes 97

Cyan

GBATemp's lurking knight
OP
Former Staff
Joined
Oct 27, 2002
Messages
23,422
Trophies
2
Age
43
Location
Engine room, learning
XP
14,525
Country
France

Homebrew Launcher for WiiU
icon.png



The homebrew launcher for WiiU is finally here !
This homebrew launcher is developed by Dimok.

It allows you to list and launch elf files and rpx files located on your SD card, but is also compatible with elf or rpx files sent to the WiiU though the network.


Compatibility

It's compatible with WiiU:
3.0.0 and 3.1.0
4.0.0 and 4.1.0
5.0.0
5.1.0
5.3.2
5.4.0
5.5.x

Download

There are two different versions:
The Homebrew version is like any other homebrew, located on your SD card and loaded from a website exploit.
The Channel version is installed into your console and doesn't require any network connection to launch it.

Homebrew version
Releases: https://github.com/dimok789/homebrew_launcher/releases (v1.x)
Sources: https://github.com/dimok789/homebrew_launcher

Channel version
Releases: https://github.com/dimok789/homebrew_launcher/releases (v2.x)
Sources: https://github.com/dimok789/homebrew_launcher/tree/homebrew_launcher_rpx


Homebrew launcher mod
• WiiU Classic controller support, added by CreeperMario. both elf and channel version available. Please, read the comments before using.
https://github.com/dimok789/homebrew_launcher/issues/28


Installation and launching process


The Homebrew version with browser hax

Download and extract the wiiu folder from the release package to the root of your SD card.
It should look like this:
SD:/wiiu/apps/homebrew_launcher/homebrew_launcher.elf
SD:/wiiu/apps/homebrew_launcher/icon.png
SD:/wiiu/apps/homebrew_launcher/meta.xml

First launch:
Host the "www" folder and run the browser exploit to launch it, or use an existing public host website, for example loadiine.ovh or wiiubru.com/x

subsequent launches:
On first launch and until you shutdown the console or launch WiiU settings app, HBL is replacing Miimaker channel.
To run Homebrew Launcher again, just run miimaker channel instead of launching the browserhax exploit a second time, or it will freeze the console.


Note:
The homebrew channel is also available in rpx format, which is the native executable format of the WiiU.
The install steps are similar, but only updated website exploit can launch the rpx version. The 551hbl.mp4 and the 532 codebin are provided here to update the hosted website exploit.



The Homebrew version with haxchi

Download and extract the wiiu folder from the release package to the root of your SD card.
It should look like this:
SD:/wiiu/apps/homebrew_launcher/homebrew_launcher.elf
SD:/wiiu/apps/homebrew_launcher/icon.png
SD:/wiiu/apps/homebrew_launcher/meta.xml

Run haxchi without pressing any button and, if you didn't change the config.txt, the homebrew launcher will be launched by default.
Haxchi config.txt looks like this:
a=fw.img
b=sysmenu
default=wiiu/apps/homebrew_launcher/homebrew_launcher.elf


The channel version
1. Download and extract the channel version to sd:/install/ (put your .app files here, not the .zip)
2. run a custom firmware (Mocha or an old Dimok's IOSUHax fw.img*, or haxchi or CBHC).
3. Use WUP installer (any version) or WUP Server with install() command to install the Homebrew channel package on a signature patched firmware.

:!: NOTE installing using fw.img:
*To install the channel version you need a SPECIFIC fw.img, do not use an existing and previously compiled fw.img, you need to get the newest Dimok's branch (The custom firmware needs to be from Nov 18, 2016 or newer) and compile with "make cfw" to get the proper fw.img for sysNAND or "make redNAND" to get a proper fw.img for redNAND with The homebrew Launcher compatibility.
If you don't use the correct fw.img, you will get an installation error!

Just use Mocha instead! you'll know you have the correct custom firmware. fw.img is an old and deprecated CFW method.


4. To launch the installed Homebrew Launcher channel, run your CFW once (Mocha sysmenu patcher, or Haxchi sysmenu patcher) if you just powered ON your console, or if you use CBHC you don't have to run anything first, and select the homebrew launcher from your WiiU home menu.
Note1: you don't need to run haxchi or Mocha a second time before launching the channel version a second time, the CFW is still in memory until you shutdown your console.
Note2: if you have Haxchi, you don't need the Channel version, you can use the "Homebrew version with haxchi" section from above, unless the homebrew you want to run is specifically compiled for the channel version. Usually, homebrew are released for both normal and channel version, just use the correct one based on the HBL you setup.


5. You can run the Homebrew Launcher channel again if you want to run homebrew again. Don't run Miimaker channel (miimaker channel is used only for Homebrew Launcher 1.x, installed with browser hax)



Usage

Installing homebrew to SD card
The Homebrew Launcher lists all elf files or rpx files located in this folder:
sd:/wiiu/apps/<folder you want>/

It will read these 3 files:
Filename.elf or Filename.rpx
meta.xml
icon.png

The meta.xml is the same format used by The Homebrew Channel (Wii)
The icon.png is twice the size (256x96px) as HBC.
the elf or the rpx can be named ANYTHING (not necessarily the same as the folder).


Launching homebrew from the network
You can send an elf file or a rpx file directly to your console though your wifi connection.
Currently, only SendElf has been tested.

Other tools like wiiload or TransmitMii might work, please test them.


Installing homebrew from the network
You can send a zip package to HBL with Sendelf, the zip will be decompressed and automatically installed into the /apps/ folder.
pack your filename.elf or filename.rpx, meta.xml and icon.png into a zip, rename the zip to the folder name you want to create and send it through the network.


How to compile a homebrew for this Homebrew Launcher

(This section might be old?)

A hello world example is available here:
https://github.com/dimok789/hello_world

You can also check the ftpiiU or even homebrew launcher sources.

How to port existing homebrew developed for libwiiu to this launcher?
Dimok ported Pong for libwiiu to Homebrew launcher elf format.
This port is available in two different formats:

1) Without dynamic libraries: https://github.com/dimok789/pong_port/tree/master/no_dynamic_libs
2) With dynamic libraries: https://github.com/dimok789/pong_port


Is my homebrew compatible?
You will probably have to recompile your project to make it compatible with this homebrew launcher.
if you compiled your application to be located at the address 0x00802000 it will work.
You can specify the address by editing the linker parameter like this:
-Wl,--section-start,.init=0x00802000

Limitation

Currently only ELF files of up to 6.5 MB are supported.
rpx file support has been added on HBL v1.4, rpx files up to 68MB are supported.

Some existing homebrew are currently not working with the channel version. They are relying on the MiiMaker titleID (for example ddd or WUP Installer) and will have to be updated.
This is NOT a homebrew launcher issue, the launched homebrew needs an update!


All launched homebrew will automatically return to the launcher when exiting them.
Launching Miimaker will reload the Homebrew launcher, except with Loadiine which will reload loadiine. you need to exit loadiine (home button) to return to the homebrew launcher.


Themes

You can change the theme without recompiling by placing the images in the resources sub-folder.
sd/wiiu/apps/homebrew_launcher/resources/

the filename can be found on github, in the /data/images/.


Donation

Dimok doesn't accept donation for this project.​
 
Last edited by Cyan, , Reason: edited compatibility version to 5.5.x

Filo97

Pink = Best colour
Member
Joined
Oct 8, 2015
Messages
4,097
Trophies
0
Location
Hyrule Castle
XP
2,550
Country
Italy
Hey everyone,

it was a bit of work but now I hope there will be more homebrew applications coming. Use the launcher itself, ftpiiu or the hello world applications I created as starting points to get quick into it.
Do you know if this laumcher works for 5.5+? (Obviusly not for loadiine and co.)
 

dimok

Well-Known Member
Member
Joined
Jan 11, 2009
Messages
728
Trophies
0
XP
2,583
Country
United States
No it will not work without a kernel exploit. The kernel exploit is necessary to setup memory access for the applications. Otherwise there is not enough space for a descent application.
 

Cyan

GBATemp's lurking knight
OP
Former Staff
Joined
Oct 27, 2002
Messages
23,422
Trophies
2
Age
43
Location
Engine room, learning
XP
14,525
Country
France
Does the gamepad have anything on the screen?
TV and gamepad are mirrored.
Wiimote works on TV


Ahh, we forgot to tell this :
We are looking for users who could make nice icons for homebrew.
I make ftpiiu, loadiinegx2 and homebrew launcher very quickly/badly.
If you feel like making better icons, please don't hesitate !
 

memomo

( ͡° ͜ʖ ͡°)
Member
Joined
Nov 30, 2013
Messages
1,079
Trophies
0
Age
28
XP
719
Country
for 5.4.0 users, ready for self hosting (payload.mp4 and suitable index.html)

have fun
 

Attachments

  • www.rar
    34.4 KB · Views: 1,770
  • root of sd card.rar
    831.5 KB · Views: 1,404
Last edited by memomo,
  • Like
Reactions: licantropo94
General chit-chat
Help Users
  • The Real Jdbye @ The Real Jdbye:
    they're still clinging to lightning on what is probably a very profitable accessory market on the iphone
    +1
    Gift
  • The Real Jdbye @ The Real Jdbye:
    and there are actually people defending them saying they don't want apple to change the connector because they'd have to buy new accessories
    Gift
  • The Real Jdbye @ The Real Jdbye:
    but like most of us have usb-c accessories already to use with our laptops or whatever
    +1
    Gift
  • The Real Jdbye @ The Real Jdbye:
    like usb/video out hubs
    +1
    Gift
  • The Real Jdbye @ The Real Jdbye:
    that could be supported on the iphone
    +2
    Gift
  • The Real Jdbye @ The Real Jdbye:
    they can buy new charging cables if they dont have any usb-c cables are cheap anyway
    +1
    Gift
  • RichardTheKing @ RichardTheKing:
    Do the Xbox Series and PS5 consoles have USB-C ports, or did Sony and Microsoft stick with "traditional" USB-A?
    Gift
  • RichardTheKing @ RichardTheKing:
    I know that the PS4 Pro has A, so I'm curious about the new ones.
    Gift
  • The Real Jdbye @ The Real Jdbye:
    no idea
    Gift
  • The Real Jdbye @ The Real Jdbye:
    i don't really like seeing C ports on host devices because in most cases i'm gonna need adapters to plug stuff in anyway
    Gift
  • The Real Jdbye @ The Real Jdbye:
    or new cables
    Gift
  • Julie_Pilgrim @ Julie_Pilgrim:
    @RichardTheKing ps5 has both types of usb
    +1
    Gift
  • The Real Jdbye @ The Real Jdbye:
    usb-c is not quite standard on the host side most desktops only have 1 usb c port maybe none and on laptops it's really just the ultra slim ones where they use usb-c for everything normal sized laptops and gaming laptops still mostly use type A
    Gift
  • The Real Jdbye @ The Real Jdbye:
    not that i don't hate the type A 3.0 connector because i do
    Gift
  • The Real Jdbye @ The Real Jdbye:
    they're not very reliable and they lose connection easily or if you don't plug them in at just the right angle you only get 2.0 speeds
    Gift
  • KennieDaMeanie @ KennieDaMeanie:
    Ps5 does have usb c
    Gift
  • The Real Jdbye @ The Real Jdbye:
    in theory i would rather have usb-c on everything in practice things haven't come quite that far yet
    +1
    Gift
  • RichardTheKing @ RichardTheKing:
    Yeah, my 2018 Lenovo Legion laptop has one USB-C at the back, and one USB-A on each side (total two).
    Gift
  • RichardTheKing @ RichardTheKing:
    Apparently, from what I read, Microsoft stuck with USB-A for Series. No C anywhere.
    Gift
  • The Real Jdbye @ The Real Jdbye:
    i want all my external drives to use usb c (because that 3.0 micro connector is awful) and i want anything i need to charge up to use usb-c so i don't need both a micro and c cable, i can just go with one, but for the host side, type A is still far more common so most cables that come with stuff
    are A to C
    Gift
  • RichardTheKing @ RichardTheKing:
    Kinda shitty, but okay sure.
    Gift
  • RichardTheKing @ RichardTheKing:
    About Microsoft, that is.
    Gift
  • The Real Jdbye @ The Real Jdbye:
    it's microsoft what do you expect?
    +1
    Gift
  • KennieDaMeanie @ KennieDaMeanie:
    Don't forget to buy $400 2tb expansion cards
    Gift
  • RichardTheKing @ RichardTheKing:
    For the consoles?
    Gift
    RichardTheKing @ RichardTheKing: For the consoles?