The-Homebrew-Cloud/homebrew_launcher
2
0
Fork 0
mirror of https://github.com/wiiu-env/homebrew_launcher.git synced 2024-11-27 23:24:16 +01:00
Code Issues Packages Projects Releases Wiki Activity
WiiU Homebrew Launcher
42 Commits 1 Branch 8 Tags 4.5 MiB
C++ 88.9%
C 8.5%
Makefile 1.9%
Shell 0.7%
cfaf2bbc6d
Go to file
dimok789 cfaf2bbc6d - added automatic gx2sploit execution and detection of existing environment 
- the RPX file can now be used in a channel with for example the NUSPacker (HBL works now as a standalone channel with no PPC exploit pre-requisite like the browser exploit)
- adaptions in sd_launcher
- fixed listing ELF files
- fix launching of ELF files from HBL channel
- since HBL RPX does not use 0x0080000 area anymore, the maximum homebrew size is increased to 0x800000 - 0x2000 bytes
- removed browser installer from RPX branch as it is of no use here

NOTE:
A channel will not yet be provided. app.xml, cos.xml, meta.xml and the icons/splash images will be provided later. Possible title id choice 00050000-13371337 :P.
2016-11-12 15:06:26 +01:00
data initial commit 2016-02-29 22:28:18 +01:00
meta - filter homebrew launcher itself from the list of homebrews (issue 13) 2016-11-04 20:47:39 +01:00
sd_loader - added automatic gx2sploit execution and detection of existing environment 2016-11-12 15:06:26 +01:00
src - added automatic gx2sploit execution and detection of existing environment 2016-11-12 15:06:26 +01:00
www/homebrew_launcher code i forgot to commit in may (haha) 2016-10-12 19:24:22 +02:00
.gitignore - added automatic gx2sploit execution and detection of existing environment 2016-11-12 15:06:26 +01:00
filelist.sh initial changes for an rpx homebrew launcher 2016-11-12 15:05:35 +01:00
LICENSE initial commit 2016-02-29 22:28:18 +01:00
Makefile - added automatic gx2sploit execution and detection of existing environment 2016-11-12 15:06:26 +01:00
README.md Some README fixes 2016-05-08 22:37:08 +02:00

README.md

WiiU Homebrew Launcher

The Homebrew Launcher is a WiiU homebrew that lists homebrew applications located on a SD card and permits launching them (similar to the Homebrew Channel of the Wii).

Usage

To use the Homebrew Launcher (or HBL, for short) you must copy homebrew_launcher.elf into SD:/wiiu/apps/homebrew_launcher/homebrew_launcher.elf, and run the installer throught your WiiU browser.

The apps that will be listed are should be in the following path /wiiu/apps/homebrew_name/some_elf_name.elf on the root of the SD card. A meta.xml and an icon.png (256x96) are optional. Here is an example:

  • sd:/
    • wiiu/
      • apps/
      • homebrew_launcher/
        • homebrew_launcher.elf
        • meta.xml
        • icon.png
      • loadiine_gx2/
        • loadiine_gx2.elf
        • meta.xml
        • icon.png
      • ddd/
        • ddd.elf
        • meta.xml
        • icon.png
      • ftpiiu/
        • ftpiiu.elf
        • meta.xml
        • icon.png

Building the Homebrew Launcher

To build the main application devkitPPC is required as well as some additionally libraries. If not yet done export the path of devkitPPC and devkitPro to the evironment variables DEVKITPRO and DEVKITPPC. Additionally you will need to include the libogc and portlibs packages in your devkitPro path.

All remaining is to enter the main application path and enter "make". You should get a homebrew_launcher.elf and a homebrew__launcher_dbg.elf in the main path.

To compile the installer application enter the "installer" path on the source code and type "make".

Building an application / homebrew (ELF) for the Homebrew Launcher

For an example on how to build an application for the HBL check out the Hello World example application or the port of the libwiiu application Pong for HBL.

Meta XML

The meta.xml is optional and can be put in the same path as the homebrew ELF file to display additional information about the homebrew.

Here is a XML example:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<app version="1">
<name>name</name>
<coder>coder<coder>
<version>app version</version>
<release_date>app release date</release_date>
<short_description>short description</short_description> 
<long_description>long description</long_description> 
</app>

Icon PNG

The icon.png has to be of the resolution 256 x 96 and can be placed in the same path as the homebrew ELF file. This file is optional and shows an icon for the homebrew inside the homebrew launcher.