Difference between revisions of "Homebrew Disc Loader"

From WiiBrew
Jump to navigation Jump to search
m (Typos)
(Updated to v0.3)
Line 1: Line 1:
 
{{Infobox homebrewapp
 
{{Infobox homebrewapp
| title      = Homebrew Disc Channel
+
| title      = Homebrew Disc Loader
 
| image      =
 
| image      =
 
| desc        = Run homebrew from DVD
 
| desc        = Run homebrew from DVD
 
| type        = Loader
 
| type        = Loader
 
| author      = Sierradev
 
| author      = Sierradev
| version    = 0.2
+
| version    = 0.3
| download    = [http://wiiki.sierradev.org/images/f/fb/Hdc_0-2.zip From the Official Website]
+
| download    = [http://wiiki.sierradev.org/images/7/7b/Hdl_0-3.zip From the Official Website]
 
| source      =
 
| source      =
 
| website    = [http://www.sierradev.org Sierradev]
 
| website    = [http://www.sierradev.org Sierradev]
Line 13: Line 13:
 
| hbb        =  
 
| hbb        =  
 
}}
 
}}
 
+
Using the '''Homebrew Disc Loader''', you can load homebrew programs from regular ISO9660 DVDs. It supports (sub)directories.
Using the '''Homebrew Disc Channel''', you can load homebrew programs from regular ISO9660 DVDs. It supports (sub)directories.
 
 
 
Note: the name Homebrew Disc ''Channel'' is actually wrong; the program was intended as either an add-on to the Wii Disc Channel or a separate channel, but due to the fact that BootMii will need an SD card to load, turning this program into anything other than a regular homebrew program will be useless in a couple of months. The name will be changed at the next release to Homebrew Disc Loader.
 
  
 
== Requirements ==
 
== Requirements ==
 
* Some way to run homebrew
 
* Some way to run homebrew
* [[DVDx]]
+
* [http://wiibrew.org/wiki/DVDx DVDx]
  
 
== Usage ==
 
== Usage ==
 
* Rename programs to boot.dol and put them in separate (sub)directories on the DVD.
 
* Rename programs to boot.dol and put them in separate (sub)directories on the DVD.
 +
* Put meta.xml in the same directories if you want friendly program names and descriptions
 +
* Put DISCINFO-file in the root of the DVD if you want disc information
 
* Burn as ISO9660 DVD.
 
* Burn as ISO9660 DVD.
 
* Put disc in console and start program.
 
* Put disc in console and start program.
 
* Follow on-screen instructions.
 
* Follow on-screen instructions.
 +
 +
== DISCINFO-file ==
 +
As of version 0.3, Homebrew Disc Loader supports a DISCINFO-file in the root of the DVD. This file contains info about the homebrew DVD. At the moment, only the first line is read and displayed as the disc title above the program menu. More fields may be implemented in the future; the recommended format is as follows:
 +
 +
<pre><Disc title>
 +
<Author>
 +
<Year of release>
 +
<E-mail-address author>
 +
<Legal information></pre>
 +
 +
Example:
 +
 +
<pre>Sierradev's Homebrew Compilation Disc
 +
Sierradev
 +
2008
 +
foo@example.com
 +
Various licenses apply</pre>
 +
 +
Note: not all fields may apply to your disc; just leave the non-applicable fields open by using an empty line
 +
 +
== Known issues ==
 +
* Programs like Quake, which depend on data files in the same directory as the program, may not work. At the moment, it is unclear whether and, if so, when this will be fixed.
 +
* If the disc title is longer than 60 characters, it will wrap to the next line and the menu may scroll up.
  
 
== Todo ==
 
== Todo ==
* Support for (parts of) meta.xml, to show friendly program names (Implemented in next release)
 
 
* Graphical interface?
 
* Graphical interface?
* Change Name to Homebrew Disc Loader (Implemented in next release)
 
* Add a 'retry'-function when a non-homebrew disc is inserted; may come in handy if loading with Twilight Hack (Implemented in next release)
 
 
* Add loading from USB drive?
 
* Add loading from USB drive?
 
* Clean up code
 
* Clean up code
* Add an 'eject'-function (Implemented in next release)
 
  
== Known issues ==
+
== Changelog ==
* Burning a lot of programs (more than 25 I think) on one DVD results in not being able to scroll through the upper part of the list. This is fixed in the next release.
+
* 0.3:
* When selecting one app, it may load another. This probably has something to do with the sorting mechanism; it seems to be fixed in the next release.
+
** Added support for meta.xml (name and long_description)
* Programs like Quake, which depend on data files in the same directory as the program, may not work. At the moment, it is unclear whether and, if so, when this will be fixed.
+
** Added support for DISCINFO-file (see below)
* Homebrew Disc Loader may randomly crash during loading, due to a bug in memory allocation. This problem is fixed in the new release.
+
** Added eject- and retry-functions
 +
** Fixed issue with scrolling through a long list
 +
** Fixed issue where program crashed randomly due to a bug in memory allocation
 +
** Changed name to Homebrew Disc Loader
 +
 
 +
* 0.2
 +
** Initial public release

Revision as of 03:08, 7 December 2008

Homebrew Disc Loader
General
Author(s)Sierradev
TypeLoader
Version0.3
Links
[[From the Official Website|Download]]
[[Sierradev|Website]]
Peripherals
Wiimote1.svg DVD

Using the Homebrew Disc Loader, you can load homebrew programs from regular ISO9660 DVDs. It supports (sub)directories.

Requirements

  • Some way to run homebrew
  • DVDx

Usage

  • Rename programs to boot.dol and put them in separate (sub)directories on the DVD.
  • Put meta.xml in the same directories if you want friendly program names and descriptions
  • Put DISCINFO-file in the root of the DVD if you want disc information
  • Burn as ISO9660 DVD.
  • Put disc in console and start program.
  • Follow on-screen instructions.

DISCINFO-file

As of version 0.3, Homebrew Disc Loader supports a DISCINFO-file in the root of the DVD. This file contains info about the homebrew DVD. At the moment, only the first line is read and displayed as the disc title above the program menu. More fields may be implemented in the future; the recommended format is as follows:

<Disc title>
<Author>
<Year of release>
<E-mail-address author>
<Legal information>

Example:

Sierradev's Homebrew Compilation Disc
Sierradev
2008
foo@example.com
Various licenses apply

Note: not all fields may apply to your disc; just leave the non-applicable fields open by using an empty line

Known issues

  • Programs like Quake, which depend on data files in the same directory as the program, may not work. At the moment, it is unclear whether and, if so, when this will be fixed.
  • If the disc title is longer than 60 characters, it will wrap to the next line and the menu may scroll up.

Todo

  • Graphical interface?
  • Add loading from USB drive?
  • Clean up code

Changelog

  • 0.3:
    • Added support for meta.xml (name and long_description)
    • Added support for DISCINFO-file (see below)
    • Added eject- and retry-functions
    • Fixed issue with scrolling through a long list
    • Fixed issue where program crashed randomly due to a bug in memory allocation
    • Changed name to Homebrew Disc Loader
  • 0.2
    • Initial public release