PyMusicD 0.1 by Zach White <zwhite@darkstar.frop.org>.

PyMusicD is yet another jukebox daemon written in python. It was born out of my
frustration with the current mp3 jukeboxes, mostly the lack of features that
I want. I've also been playing with python quite a lot lately, and this is my 
first attempt at a large project in python.

The player is being written to satisfy my own requirements for a car mp3
player, although there's no reason you couldn't use this for a home mp3
player, or work mp3 player. It assumes that your network users are (mostly)
benign, and doesn't take a lot of precautions against malicious users
who want to screw with your mp3s. Take appropriate measures to only allow
trusted users to play with it, at least until I secure it a bit better.

Its primary purpose is to run in the background, and play mp3s whenever they
are in the playlist. 

Bugs:

There are lots of known bugs. See TODO for details.

Usage:

Unpack this to its own directory. Edit server.py and set the variables
at the top to match your own needs. Run 'python server.py', then use
telnet or netcat to connect to the port specified (2323 by default.)
Run 'help' or see protocol.txt for details on how to use it.

The client doesn't work, currently. I redid the protocol in a slight
yet signifigant way, and haven't fixed the client to use the new style.
Feel free to write your own client, it shouldn't be too hard.

This software is currently in development. It is not ready for end users
yet. You should have familiarity with scripting in python before you
set about to use this software. That being said, if you find bugs that
aren't listed in TODO, and/or have problems with the software that
aren't listed in TODO, email me (zwhite@darkstar.frop.org) and I'll
see what I can do to help you. Code patches/suggestions are always
welcome.

Platforms:

This is known to work on my Slackware 9.0 machine using the Python
2.2.2 package that came with it. I have also tested it on my Mac
OSX 10.2.8 machine with Python 2.2. I have no reason to believe that
it won't work on any machine with a Python 2.x interpreter and
either mpg123 or mpg321. Your mileage may vary.
