Linux on the Nintendo GameCube and Wii

File Release Notes and Changelog

Release Name: kobodl-0.5.1-whiite

Notes:
Kobo Deluxe 0.5.1-whiite for the Nintendo Wii
3 Aug 2008, Albert "isobel" Herranz


1. INTRODUCTION

   Quoting the Kobo Deluxe official site, Kobo Deluxe is an enhanced version
   of Akira Higuchi's game XKobo for Un*x systems with X11.
   XKobo was a fastpaced multiway scrolling shoot-em-up. It was simple
   but clever and very addictive.

   Kobo Deluxe adds sound, smoother animation, high resolution support,
   OpenGL  acceleration (optional), an intuitive menu driven user interface,
   joystick support and other features. Recent versions also add a number of
   alternative skill levels with slightly modernized gameplay. Kobo Deluxe
   uses SDL for graphics, sound and input, which makes it possible to build
   and run the game on pretty much anything. That includes a Nintendo Wii :)

   For additional information about Kobo Deluxe please visit
   http://olofson.net/kobodl/


2. INSTALLING

   Kobo Deluxe for the Nintendo Wii comes in a Homebrew Channel friendly
   package.

   Simply untar the archive kobodl-0.5.1-whiite.tar.gz on the root directory
   of your homebrew SD card and it will create an apps/kobodl directory
   suitable for its use with the Homebrew Channel.

   For additional information about the Homebrew Channel please visit
   http://wiibrew.org/wiki/Homebrew_Channel


3. RUNNING

   Make sure that the SD card where you installed kobodl-0.5.1-whiite is
   inserted into the front SD card slot of your Nintendo Wii console.
   Start the Homebrew Channel, locate the Kobo Deluxe entry and click on its
   icon using the Nintendo Wii Remote, then click on the Load button.

   Kobo Deluxe will start after a few seconds.


4. IMPORTANT CAUTIONS

   - DO NOT REMOVE THE SD CARD WHILE PLAYING KOBO DELUXE.
   - ALWAYS EXIT CLEANLY KOBO DELUXE, USING THE "QUIT KOBO DELUXE" MENU
     OPTION.

   The SD card is mounted for reading and writing while the game is running.
   Physically removing the SD card or forcibly turning off your Nintendo Wii
   can _potentially_ corrupt the filesystem of your SD card.


5. CONTROL BINDINGS

   Kobo Deluxe (whiite) can be controlled using a Nintendo Wii Remote.
   Just press any button on the Nintendo Wii Remote when the game is
   running to get it connected (yeah, that simple).

   To play the game, the Nintendo Wii Remote must be oriented 45 degrees
   counter-clock-wise, leaving the D-pad on the left and the 1 and 2 buttons
   on the right.
    ____________________________________________________
   /                                                    \
   |      ^            (+)                            * |
   |    <-+->  ( A )   (H)   ::::::::     (1)   (2)   * |
   |      v            (-)                            * |
   | (o)                                              * |
   \____________________________________________________/

   - D-pad: drive the space ship
   - 1: cancel
   - 2: select / fire
   - Home: start

   The game can also be played using a Nintendo Classic Controller (RVL-005)
   if connected to the Nintendo Wii Remote.

   - D-pad, left analog or right analog: drive the space ship
   - b: cancel
   - a: select / fire
   - Home: start

6. MINI FAQ

   - Q: Where is the game configuration stored?
     A: The game configuration is stored in the file
        apps/kobodl/persistent/.kobodlrc

   - Q: Where are the scores / player profiles stored?
     A: The scores and player profiles are stored in the directory
        apps/kobodl/persistent/scores.

   - Q: I'm a god playing Kobo Deluxe. Will my incredible high score be lost?
     A: No, the apps/kobodl/persistent directory is... persistent.

   - Q: Why my console doesn't turn off when I press the wiimote power button?
     A: Pressing the Nintendo Wii Remote power button only powers off the
        Nintendo Wii Remote, not the console.
        To turn off your console, exit Kobo Deluxe and once in the System Menu
        press the power button on your Nintendo Wii Remote or on your console.

   - Q: Can I change the wiimote/classic/nunchuck bindings?
     A: Yes, but you'll need to figure that by yourself, and if you screw
        something it's your fault :-P
        Hints: kobodl.img.bz2, /usr/local/etc/cwiid/wminput/kobodl


7. SOFTWARE USED

   We (ab)used the following open source software to build this package:

   + Linux Kernel 2.6.24 (http://www.kernel.org/)
   + busybox 1.9.1 (http://busybox.net/)
   + Debian etch (http://packages.debian.org)
     - Package: libc6 (2.3.6.ds1-13etch7)
     - Package: libstdc++6 (4.1.1-21)
     - Package: libgcc1 (1:4.1.1-21 and others)
     - Package: libexpat1 (1.95.8-3.4)
     - Package: zlib1g (1:1.2.3-13)
     - Package: libfreetype6 (2.2.1-5+etch2)
     - Package: libsdl-image1.2 (1.2.5-2+etch1)
     - Package: libsdl-ttf2.0-0 (2.0.8-3 and others)
     - Package: libpng12-0 (1.2.15~beta5-1)
     - Package: libdbus-1-3 (1.0.2-1+etch1)
     - Package: dbus (1.0.2-1+etch1)
     - Package: libbluetooth2 (3.7-1)
     - Package: bluez-utils (3.7-1)
   + SDL 1.2.11 (http://www.libsdl.org/)
   + Cwiid 0.6.00 (http://abstrakraft.org/cwiid/)
   + Kobo Deluxe 0.5.1 (http://olofson.net/kobodl/)

   All software, except the Linux kernel, was built natively on a Nintendo
   Wii running whiite-linux.
   The Linux kernel was cross-compiled using an x86 machine.


8. CREDITS

   Special thanks go to:

   - Akira Higuchi, for the original XKobo
   - David Olofson, and friends, for the Kobo Deluxe sequel
   - Team Twiizers for quickly and easily making homebrew on the Nintendo Wii
     possible
   - all those who believe in The GameCube Linux project


9. DISCLAIMER

   THIS PROGRAM IS NOT AFFILIATED WITH NINTENDO.

   IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
   SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
   OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE AUTHOR
   HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

   THE AUTHOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
   BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
   AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
   ON AN "AS IS" BASIS, AND THE AUTHOR HAS NO OBLIGATION TO
   PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.




Changes:
---
08.08.2008 Albert Herranz
Oops, I forgot to include cwiid in the software used list section of the readme.txt...
Sorry! Fixed now in the release notes.