What you Need
=============
Currently, we have a lot of dependencies, this will change
in future releases. You need:

Server / Client
---------------
    mpg123 (or other streaming cli mp3player)
      perl >= 5.002
  perl/Gtk >= 0.500
       Gtk == 1.0x
      wget
GNU locate (comes with findutils)
web server (we use apache)

Ripper
------
bladeenc
mp3info  (optional: if you want to add ID3 tags)
cda (comes with xmcd)

Where to get these
------------------
   apache: http://www.apache.org/dist/
 bladeenc: http://freshmeat.net/appindex/1998/08/14/903136605.html
      gtk: ftp://ftp.gtk.org/pub/gtk/
findutils: ftp://ftp.gnu.org/gnu/findutils/
  mp3info: http://freshmeat.net/appindex/1999/02/15/919093993.html
   mpg123: http://freshmeat.net/appindex/1998/01/11/884572134.html
     perl: http://language.perl.com/info/software.html
 perl/gtk: ftp://ftp.gtk.org/pub/gtk/perl/
     wget: http://freshmeat.net/appindex/1998/02/07/886856050.html
     xmcd: http://freshmeat.net/appindex/1998/05/26/896175773.html


What you Got
============
You should have four perl scripts: 
server.pl, client.pl, mp3_locate.pl, ripenc.pl

Most of this is configured with a file ".mpservrc" which
resides in your home directory. A sample ".mpservrc"
configuration file is included.


==============
Important Note:  Currently you must host your mp3 information
==============   in the directory /mp3 of the root web directory.
In other words, all your mp3 information must be accessible
via "http://your.web.site/mp3/". You can set-up Apache to only
accept certain IPs to a particular directory. This is highly
recommended unless you don't mind a publicly accessible mp3
website.


Instructions
============
* create the directory that your web server understands
as "http://your.web.site/mp3/"

* edit ".mpservrc" and place it in your home directory 

* run mp3_locate
perl mp3_locate.pl

This will find your mp3 files and dump them into the web
directory you specified.

* Pick who is going to be the server (the person connected to the stereo).
perl server.pl

This person will need access to /dev/dsp, so if only root can access
/dev/dsp then root needs to run the server (consquently, root will need
the ".mpservrc" file in their home directory).

* Everyone else run the client:
perl client.pl [server-host]
  
Server-host defaults to localhost if not specified.


Ripping and Encoding : Adding music to the system
====================
* Insert CD into CD-Reader
perl ripenc.pl


Please send comments and suggestions
to Jeremy Avnet and Brian Martin:

 brian@theory.org
jeremy at theory_org

Thank you!!