                                 Mocca 
                          ====================


 1. What is it?
------------------
Mocca is an alternative menu and application launcher for the GP2X handheld
console.

It's released under the GPL; you can find a full copy of the GPL in the file
COPYING.

You can find the source of this distribution at:
    http://gp2xforge.rix0r.nl/svn/mocca/tags/0.2.1

Obtain this locally by running:
    svn co http://gp2xforge.rix0r.nl/svn/mocca/tags/0.2.1

You can leave feature requests and bug reports at:
    http://gp2xforge.rix0r.nl/projects/mocca/newticket

For an a list of all current open issues, see:
    http://gp2xforge.rix0r.nl/projects/mocca/report/1


 2. A word of warning!
---------------

One of Mocca's features is toto replace the standard shell! While I have tested
this and am using it without problems on my own GP2X, replacing the shell is an
inherently risky operation that may brick your device if something goes wrong.

Use this feature at your own risk, use only with a fully charged battery, and
make sure you have unbricking facilities available!

Feature tested on firmwares:
    1.0.0


 3. Features
---------------

Mocca is extremely easy to use; it's intention is not to confuse new users with
all kinds of launchers and emulators, but to provide a unified interface to all
content stored on the GP2X.

- Locates all files on the GP2X and makes them available with a few keystrokes
- Automatically locates emulators and ROMs
- Quickly access the SYNC command from Mocca's menu (prevent losing savegames)
- Highly skinnable
- Can replace standard shell
- Drops back to the classic shell if the SD with Mocca on it is not mounted


 5. Emulators and applications supported out-of-the-box
------------------

This distribution of Mocca already comes with support for the following
applications and emulators:

- nkNES2x (not yet effective)
- pdfview
- SquidgeSNES >= 0.33
- Gnuboy2x >= 0.6


 5. Known Issues
------------------

- Right now, there is no video or music player available that will accept
  command-line arguments. Hence, Mocca cannot play video or music files. You
  can switch back to the classic shell for that.

- A lot of emulators do not yet support command-line arguments; this limits the
  power of Mocca somewhat. If you wish to help Mocca and similar projects,
  please accept command-line arguments in your emulators, and ask other
  emulator authors to do the same!
