Installing Gmp3
---------------

Before doing anything, it is important to note that Gmp3 requires a patched
version of mpg123-0.59o to run.  As a result, your first step will be to
download and patch mpg123.  To do this, do the following:

1) Download mpg123 and untar it into a directory.
2) Copy the patchfile provided into the mpg123 source directory.
3) Patch mpg123 by executing the following command:
   
   patch -p0 < mpg123-0.59o.patch

4) Perform a 'make' and install the player.

BTW, if you are curious as to what the patchfile does to mpg123, read the
PATCHES file which came with Gmp3.

The next step to install Gmp3 is to compile and install the program itself. 
Now, you may first wish to take a look at the Makefile and make any changes
to the default installation settings.  The following may be of interest:

PLATFORM - If you're not on a Linux box, you can try selecting a different
           platform for compilation.
INSTALLDIR - This points to the root of the directory tree where Gmp3 will
             install.  This is /usr/local by default, but may be /usr or
             something else.
BINDIR - The directory, inside the INSTALLDIR, where the gmp3 binary will be
         located. 
LIBDIR - Directory in the INSTALLDIR where the Gmp3 themes will be stored, 
         as well as other global data (such as the gmp3logo.jpg image, which 
         is used by the about box).
RCFILENAME - Defines the name of Gmp3's RC file.
RCFILEDIR - The name of the directory, inside the users home directory,
            where Gmp3 will look for it's user-level configuration files.
MPG123 - This defines the filename and location for the mpg123 executable.  
ROOTNAME - The name of the root node in the Albumn tree.

BTW, if you have installed an older version of Gmp3, you'll want to remove
the existing LIBDIR/gmp3 directory.  As well, if you are upgrading from a
version < 0.07, you'll want to run the convert.sh script on your playlists
to update them to the new format.

Once you have the Makefile changed to suit your needs, you may do a:

make && make install && make cleanall

This will compile Gmp3, install it, and then clean the source directory. 
You may also do a:

make install-bin - Installs the Gmp3 binary but not the support files.
                   Useful for upgrading an existing Gmp3 installation
                   (assuming the support files haven't changed).
