MPlayer - dvdlib edition
(c) 2008 Team Twiizers

ABOUT
-----
This is a native MPlayer (http://www.mplayerhq.hu/) Wii port.
The main focus has been DVD-Video playback on modified and unmodified consoles.
Although you can open and view various media files from SD card, this is
largely untested. At this time it can not read files off data DVD's, just
DVD-Video discs.

REQUIREMENTS
------------
This application requires a valid and working DVDX stub install, please refer
to its README for setup instructions.
A DVD-Video disc, either pressed or with the DVD-ROM booktype, might also come
in handy.

INSTALL
-------
Just copy the "mplayer" folder into the "/apps" directory on your sd card and
launch it via the HBC (http://hbc.hackmii.com/).

RUN
---
When launching this application you will be presented by a basic on screen
menu. All options should be self-explanatory, here're some hints:
- High bitrate video streams may lead to dropped frames. This really depends on
  the used DVD-Video. Some fullscreen movies seem to have the same issue.
- Hiding the menu and disabling subtitles improves the performace a little.
- Playing DVD's with libdvdnav is buggy and decreases performace (read: way
  more dropped frames)
- Choosing a DTS audio track results in noise and breaks things.
- Choosing non-playable files from SD makes it crash & burn.

CONTROLS
--------
You can use a wiimote or a gamecube pad to interact:

A - Pause
B - OSD
1/X - Toggle on screen menu
RIGHT - Seek 10s forward
LEFT - Seek 10s backward
UP - Seek 60s forward
DOWN - Seek 60s backward
+/R - Seek to the next chapter
-/L - Seek to the previous chapter
HOME/Z - Quit

When watching DVD's using libdvdnav:
2/Y - Modifier key for libdvdnav

Hold this key and use RIGHT / LEFT / UP / DOWN / A / B / 1/X to navigate.

CREDITS
-------
This port was made possible by the following people:

dvdlib - Erant
DVDX stub - marcan
libdvdcss port - svpe
mplayer port - dhewg
12 stage TEV YUV12 GX voodoo - sepp256
menu loop animation - drmr

This port is powered by devkitPPC and libogc (http://www.devkitpro.org/).
Thanks go out to the HBC beta team for testing!

HOW TO BUILD
------------

3 subversion repositories are required to build this port, the revisions used
for this binary are:

libdvdread r1120
libdvdnav r1120
mplayer r27458

- get the repositories via:
  - svn co svn://svn.mplayerhq.hu/dvdnav/trunk/libdvdread libdvdread-trunk
  - svn co svn://svn.mplayerhq.hu/dvdnav/trunk/libdvdnav libdvdnav-trunk
  - svn co svn://svn.mplayerhq.hu/mplayer/trunk mplayer-trunk
- apply the patches
- edit libdvdread's and libdvdnav's config.mak and adjust SRC_PATH and
  SRC_PATH_BARE
- build libdvdread with `make`, then `make install`
- build libdvdnav with `make`, then `make install`
- build mplayer with `make`, test your build using `make upload`

Enjoy,
Team Twiizers

