Skip to content

Commit

Permalink
Updated readmes
Browse files Browse the repository at this point in the history
  • Loading branch information
suloku committed Aug 29, 2015
1 parent e3735ad commit 7a52162
Show file tree
Hide file tree
Showing 4 changed files with 83 additions and 9 deletions.
2 changes: 1 addition & 1 deletion README.md
Expand Up @@ -3,7 +3,7 @@ Set of dol launching tools for GameCube

This tools are based on the dol loading code used in swiss by emu_kidid: https://github.com/emukidid/swiss-gc

· Brosexec: This is a simple dol that will load autoexec.dol from the root of a SD card in a SDGecko adapter. It's main purpose is to be used with the Home Bros. Exploit, as a wai to boot homebrew on unmodifyied consoles. One of its golas is to keep used space in the memory card as low as possible.
· Brosexec: This is a simple dol that will load autoexec.dol from the root of a SD card in a SDGecko adapter. It's main purpose is to be used with the Home Bros. Exploit, as a way to boot homebrew on unmodified consoles. One of its goals is to keep used space in the memory card as low as possible.
- Check the Home Bros. exploit here: http://www.gc-forever.com/forums/viewtopic.php?f=38&t=3023

· Brosexecconf: this is a simple configurable dol launcher, the configuration file can assing a dol to each button. Supports a timer to autoboot a default dol after a configurable amount of time passes. Also supports passing command line arguments to loaded dol files in the form of .cli files.
Expand Down
16 changes: 16 additions & 0 deletions brosexec/Readme.txt
@@ -0,0 +1,16 @@
Brosexec 0.1 by suloku '15
**************************

This is a simple dol that will load autoexec.dol from the root of a SD card in a SDGecko adapter. It's main purpose is to be used with the Home Bros. Exploit, as a way to boot homebrew on unmodified consoles. One of its goals is to keep used space in the memory card as low as possible.

Uses libfat 10.0.14 and thus supports FAT32 and SDHC.

Currently the needed space is 11 blocks on the memory card.


- Check the Home Bros. exploit here: http://www.gc-forever.com/forums/viewtopic.php?f=38&t=3023

- Check swiss here: https://github.com/emukidid/swiss-gc

_____________________
suloku 15'
48 changes: 40 additions & 8 deletions brosexecconf/Readme.txt
@@ -1,19 +1,51 @@
Configurable sd dol launcher 0.1 by suloku '15
***********************************************
BrosexecConf: Configurable SD dol launcher 0.1 by suloku '15
*************************************************************

This file takes 13 blocks in the memory card.
This is a dol loader that uses a configuration file to assign each GameCube button to a dol file. Autobooting a dol file after a set amount of time is also possible.

sdgecko:/autoboot/autoconf.txt: configuration file, up to 12 buttons can be configured for dol booting.
Launched dol files can have command line arguments trough the use of .cli files (read its section in this readme file).

Timer value: seconds until program boots default dol. If there is no default dol specified in the config file, sdgecko:/autoexec.dol will be launched.
There are two version available: the text version and the back version:
- Text version: takes 13 blocks when converted to gci, its purpose is to be used with the Home Bros. exploit and take less memory card space.
- Back version: takes 21 blocks when converted to gci. This file uses libPNGU by frontier to display a background image, opening customization possibilities since text displayed by brosexecconf can be disabled in the configuration file, thus it can be used to show a splash screen before autobooting, or using the background image as graphical menu to show which buttons are associated to each dol file.

If a button with no assigned dol is pressed, default dol will be launched instead, if there isn't one, autoexec.dol will be boot.
My personal recommendation for the HomeBros exploit to keep memory card space at minimum is to use the simple Brosexec, that takes only 11 blocks, which will launch autoexec.dol from the SDGecko. BrosexecConf should be placed as autoexec.dol in the sdcard. The boot sequence would be: Smash Bros --> brosexec --> brosexec conf --> the desired dol.
Seems redundant, since booting is quick no significant amount of time is lost between smash bros and autoexec.dol launched by brosexec.

If a button is configured, but the dol file isn't in the sdcard, default dol will be launched instead, if there isn't one, autoexec.dol will be boot.
Uses libfat 10.0.14 and thus supports FAT32 and SDHC.
This program uses the dol loading code and cli file parsing from swiss by emu_kidid: https://github.com/emukidid/swiss-gc


Configuration:
-------------

NOTE: dol loading code thanks to FIX94's source code from gbiargs.
sdgecko:/autoboot/autoconf.txt: configuration file, up to 12 buttons can be configured for dol booting, each with a title to be shown in the program. If there's no title, the path to the dol will be shown.

Timer value: seconds until program boots default dol. If there is no default dol specified in the config file, sdgecko:/autoexec.dol will be launched. Can be disabled with value -1.

Image path:


Some considerations:
--------------------

- If a button with no assigned dol is pressed, default dol will be launched instead, if there isn't one, autoexec.dol will be boot.

- If a button is configured, but the dol file isn't in the sdcard, default dol will be launched instead, if there isn't one, autoexec.dol will be boot in its place.


Command Line arguments:
----------------------

To pass command line arguments to launched dol, create a plain text file and rename it to the same filename as the dol to boot, with .cli extension.
For example:
gbi.dol
gbi.cli

The contents of the file are simple: each line is an argument to be passed to the launched dol. For example, we want to launch GB Interface with on screen display of and video mode to be pal 60, the cli file contents would be:

-noosd
-format=pal60

_____________________
suloku 15'
26 changes: 26 additions & 0 deletions mcloader/Readme.txt
@@ -0,0 +1,26 @@
Brosexec 0.1 by suloku '15
**************************

This is a simple dol that will mount a memory card and scan for dol files created with dol2gci, it will list them and allow to boot them.

It's main purpose is to be used with the Home Bros. Exploit, as a way to boot multiple homebrew without owning an SDGecko adapter.

Currently the needed space is 9 blocks on the memory card.


Installing dol files to the memory card:
----------------------------------------

To install dol files to the memory card, convert them with dol2gci, then install them to the memory card with your preferred method. You can use GCMM for that: http://wiibrew.org/wiki/GCMM

note: the name of the file on the memory card will be that of the dol file BEFORE converting it with dol2gci. After the conversion is done, renaming the gci file will have no impact on the memory card filename.


----------------------

- Check the Home Bros. exploit here: http://www.gc-forever.com/forums/viewtopic.php?f=38&t=3023

- Check swiss here: https://github.com/emukidid/swiss-gc

_____________________
suloku 15'

0 comments on commit 7a52162

Please sign in to comment.