Official Homebrew Launcher for WiiU

Discussion in 'Wii U - Homebrew' started by Cyan, Feb 29, 2016.

Feb 29, 2016

Official Homebrew Launcher for WiiU by Cyan at 9:33 PM (274,403 Views / 90 Likes) 913 replies

  1. Cyan
    OP

    Global Moderator Cyan GBATemp's lurking knight

    Joined:
    Oct 27, 2002
    Messages:
    16,822
    Location:
    Engine room, learning
    Country:
    France
    Homebrew Launcher for WiiU
    [​IMG]
    [​IMG]


    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.0
    5.5.1


    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


    Installation and launching process


    The Homebrew version

    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

    Host the "www" folder and run the browser exploit to launch it, or use an existing public host website.

    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 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).
    3. Use WUP installer or WUP Server with install() command to install the Homebrew channel package on a signature patched firmware.

    4. To launch the installed Homebrew Launcher, run your fw.bin again and select the homebrew launcher from your WiiU home menu.


    :!: 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.


    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

    If you want to thank Dimok for all his work in the WiiU development, you can make a gift in return.
    [​IMG]
     
    Last edited by Cyan, Jan 2, 2017 - Reason: Updated the channel installation instruction to use Mocha.


  2. Filo97

    Member Filo97 A Nintendo REALLY big hacking fan

    Joined:
    Oct 8, 2015
    Messages:
    3,415
    Location:
    an ancient videogame...
    Country:
    Italy
    5.5+ for the non-kernel related stuff works?
     
  3. dimok

    Member dimok GBAtemp Advanced Fan

    Joined:
    Jan 11, 2009
    Messages:
    719
    Country:
    United States
    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.
     
    josamilu, Adr990, m6u3 and 23 others like this.
  4. Rizzorules

    Member Rizzorules "What are you doing?" "Something unexpected."

    Joined:
    Aug 17, 2013
    Messages:
    880
    Country:
    Netherlands
    This is awesome, do you know if we will be able to have custom themes in the future?
     
  5. Filo97

    Member Filo97 A Nintendo REALLY big hacking fan

    Joined:
    Oct 8, 2015
    Messages:
    3,415
    Location:
    an ancient videogame...
    Country:
    Italy
    Do you know if this laumcher works for 5.5+? (Obviusly not for loadiine and co.)
     
  6. dimok

    Member dimok GBAtemp Advanced Fan

    Joined:
    Jan 11, 2009
    Messages:
    719
    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.
     
  7. Cyan
    OP

    Global Moderator Cyan GBATemp's lurking knight

    Joined:
    Oct 27, 2002
    Messages:
    16,822
    Location:
    Engine room, learning
    Country:
    France
    I added 5.3.2 ad 5.4.0 at the top.
     
  8. rw-r-r_0644

    Member rw-r-r_0644 GBAtemp Regular

    Joined:
    Jan 13, 2016
    Messages:
    268
    Country:
    Italy
  9. BurningDesire

    Member BurningDesire An aspring gaming Industry news reporter

    Joined:
    Jan 27, 2015
    Messages:
    4,915
    Location:
    Behind a screen reading news
    Country:
    United States
    Does the gamepad have anything on the screen?
     
  10. SlateXD

    Member SlateXD GBAtemp Regular

    Joined:
    Apr 22, 2013
    Messages:
    173
    Country:
    United States
    Awesome release. Thank's dimok. Keep at it bro. :)
     
  11. TR_mahmutpek

    Member TR_mahmutpek GBAtemp Advanced Fan

    Joined:
    Jul 28, 2015
    Messages:
    606
    Country:
    Turkey
    Nice work!
     
  12. NichyXD

    Member NichyXD GBAtemp Regular

    Joined:
    Feb 13, 2015
    Messages:
    111
    Country:
    Italy
    Awesome. Great work guys
     
  13. Cyan
    OP

    Global Moderator Cyan GBATemp's lurking knight

    Joined:
    Oct 27, 2002
    Messages:
    16,822
    Location:
    Engine room, learning
    Country:
    France
    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 !
     
  14. memomo

    Member memomo ( ͡° ͜ʖ ͡°)

    Joined:
    Nov 30, 2013
    Messages:
    1,066
    Country:
    Kuwait
    Awesome, can't wait to see more homebrews
     
  15. Azeryn

    Member Azeryn GBAtemp Regular

    Joined:
    Feb 1, 2016
    Messages:
    108
    Country:
    United States
    That's awesome. Thank you @dimok !
     
  16. Wiiunator

    Member Wiiunator GBAtemp Regular

    Joined:
    Nov 13, 2015
    Messages:
    145
    Country:
    Australia
    amazing work guys!
     
  17. Selim873

    Member Selim873 Nunnayobeesnes

    Joined:
    Jul 31, 2010
    Messages:
    1,132
    Location:
    Chillin' with Bob Ross
    Country:
    United States
    Holy crap, yes! :lol:
     
  18. memomo

    Member memomo ( ͡° ͜ʖ ͡°)

    Joined:
    Nov 30, 2013
    Messages:
    1,066
    Country:
    Kuwait
    for 5.4.0 users, ready for self hosting (payload.mp4 and suitable index.html)

    have fun
     

    Attached Files:

    Last edited by memomo, Feb 29, 2016
    licantropo94 likes this.
  19. kprovost7314

    Member kprovost7314 I AM 14, NOT 25!

    Joined:
    Dec 24, 2014
    Messages:
    1,301
    Location:
    In that bara manga ( ͡° ͜ʖ ͡°)
    Country:
    United States
    I don't think I can wait for offline homebrew anymore because of this. 0.0
     
  20. soniczx123

    Member soniczx123 GBAtemp Advanced Fan

    Joined:
    Jul 24, 2015
    Messages:
    572
    Country:
    Sweden
    Cafiine and SDCafiine with this would be amazing!!
     
    MegaSuperab2 likes this.

Share This Page