Mfe

From gc-linux

Jump to: navigation, search

This is a wikified version of the README file included in the mfe 1.1.

mfe file selection menu.


Contents

Introduction

The Nintendo GameCube is a powerful console. As shown in many games, it is able to play songs and videos without problems. This was also confirmed by building and running MPlayer on it, using the gc-linux port.

"mfe" is a small joypad-driven front-end for MPlayer aimed at helping you select and play your media files on your GameCube just by using a controller.

Features

These are just some of the features of "mfe":

  • Joypad-controlled user interface
  • Simple and effective single file selection dialog
  • Allows mounting and unmounting media by just pressing a button
  • Provides basic control over the MPlayer playing session (pause, forward/rewind, enable and cycle subtitles, etc.)
  • Fancy self-made 2D animations

Requirements

"mfe" requires a recent gc-linux SDL port for the Nintendo GameCube. You can safely use any version posted after 23 June 2005.

It requires also the standard SDL_ttf library.


Installing

In order to build and install "mfe", you'll need the typical GNU development environment.

  • Unpack the mfe tarball in a directory where you have permissions, and change to the distribution directory.
   # tar xjvf mfe-1.1.tar.bz2
   # cd mfe-1.1/
  • Issue the following commands in order.
   # ./configure
   # make
   # make install

That should install "mfe" on your system, using the default directory prefix, which is /usr/local.

Running

You can just run "mfe" by passing it a directory that will show up in the file selection dialog.

Additionally you can:

  • Display "mfe" usage.
   # mfe -h
   Usage: mfe [OPTIONS] [DIRNAME]
     -z, --dvd-device=DEVICE               use DEVICE dvd device file
           (default is /dev/dvd)
     -d, --dvd-mount-point=DIR             mount dvd media at DIR
           (default is /cdrom)
     -m, --mount                           try to mount media during startup
     -u, --umount                          try to unmount media during startup
     -x, --extra-mplayer-options=OPTIONS   pass OPTIONS to MPlayer
           (default is "-subfont-autoscale 1 -subpos 70")
     -h, --help                            call for help
     -v, --version                         display version
  • Start with the contents of the /media directory.
     # mfe /media
  • Use /dev/gcndvd as the dvd device file and start in the /cdrom directory.
     # mfe -z /dev/gcndvd /cdrom
  • Mount dvd media at /mnt and start at that same directory.
     # mfe -d /mnt /mnt
  • Try to mount dvd media on startup and start with the /cdrom contents.
     # mfe -m /cdrom
  • Pass MPlayer some extra options and display /media contents.
     # mfe -x '-sub-fuzziness 1' /media


Joypad Bindings

The file selection dialog in "mfe" can be controlled as follows:

  • D-pad UP arrow or Y button move the selection up
  • D-pad DOWN arrow or X button move the selection down
  • B button goes back one directory level
  • START/PAUSE or A buttons enter a directory or play a file
  • L or R buttons pressed for more than 1 second mount/dismount media
  • Z button pressed for more than 2 seconds quits

During media playback, the controller acts as follows:

  • START/PAUSE or A buttons resume/pause playback
  • B or Z buttons stop playback
  • X button cycles through available subtitles
  • Additionally, if the media file is seekable:
    • D-pad right seeks forward 5 seconds
    • D-pad left seeks backwards 5 seconds
    • R button seeks forward 30 seconds
    • L button seeks backwards 30 seconds

Credits

Special thanks go to:

  • the MPlayer Project people for their player
  • Paul Davey for letting me use his awesome "Gant" artwork
  • Aubin Paul and the other Freevo developers for granting me permission to use one of their background images.
  • all gc-linux fans


Disclaimer

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.

GameCube is a trademark or registered trademark of Nintendo Inc. in the US and/or other countries. No affiliation between the GameCube-Linux Project and Nintendo Inc. exists or is implied.

Personal tools