Pymps v0.12.1
=============
Pymps (server side) has been tested on the following Operating Systems:
    * Gentoo 1.2, 1.4
    * Mandrake 8.1, 8.2
    * Redhat 7.1, 7.2


Requirements
============
* Python >= 1.5.2 (pymps is now developed on 2.2)
* PostgreSQL >= 7.0.2
And, either of:
* GnuMP3D >= 0.9.9.4
  (GNU Open Source Streaming Server - http://gnump3d.sourceforge.net/) **Highly Recommended**
* Icecast >= 1.3.7 

Optional
========
pyOgg and pyVorbis (for ogg support) - http://www.duke.edu/~ahc4/pyogg/
Ices >= 0.2.2 (for mp3 tag streaming via icecast)


Upgrading
=========
1) If you're upgrading, make a backup copy first :-) 
2) The pymps.conf file contents have changed in v0.12.0  - If you're upgrading from
   a prior version please you'll need to replace your old pymps.conf file with pymps.conf.dist
3) If the old version is <= 0.10.0 it'll probablt be easier to start from scratch.  Sorry ;o)


Installation Notes
==================   
1) Installing Pymps code
Extract the tar archive into somewhere like "/var/www/".  
This should create a "/var/www/pymps-0.12.0" directory.
You may need to chown the pymps directory to the user (usually "nobody" or "apache") that 
the webserver runs under:
    chown -R apache.apache /var/www/pymps-0.12.1


2) Pymps Database

2.1) add a user (you will need to do this as root):
       adduser pymps

2.2) cd into the pymps directory and create the pymps database user in postgres:
       createuser -P pymps 
     You will want to switch to a user that can create postgres databases.
     Enter a password for user pymps when prompted.

2.3) You may need to configure your pg_hba.conf file.  
     Sample entry:
       host    pymps    192.168.1.0    255.255.255.0    password

2.4) Now, create the pymps database itself:
       su pymps
       createdb pymps
       psql -U pymps -W -e pymps < pymps-db-schema.sql


*note* if you don't use "pymps" as a username then you may need to edit the
       pymps-db-schema.sql file.


3) Configuring Music Streaming Server
* GnuMP3D
Edit the /etc/mp3d.conf file and set the "root" entry to the
location of your music files, eg.
    root = /mnt/cdrom
or

* Icecast
Edit the /etc/icecast/icecast.conf file and set the staticdir entry to the
location of your mp3 files, eg.
    staticdir /mnt/mp3


4) Edit the pymps.conf file.
First rename the pymps.conf.dist file to pymps.conf:
    mv pymps.conf.dist pymps.conf


5) Configuring apache. In the httpd.conf file (/etc/httpd/conf/httpd.conf) ...
Apache needs to be able to execute .py scripts as cgi files, to do this I use the following CgiHandler directive: 

To use .py files as CGI scripts:
    AddHandler cgi-script .cgi .py

Also, add "index.py" to the DirectoryIndex setting: 
    DirectoryIndex index.html index.php index.htm index.shtml index.cgi Default.htm default.htm index.php3 index.py

Add an alias for the pymps directory:
    Alias /pymps /var/www/pymps-0.12.1
    <Directory /var/www/pymps-0.12.1>
      Options ExecCGI FollowSymLinks
      Order Deny,Allow
      Deny from All
      Allow from localhost, 127.0.0.1   
    </Directory>


6) Configuring Netscape / Mozilla / Galeon / Internet Explorer / Opera
Pymps uses the "audio/x-mpegurl" mime content-type to launch a suitable mp3 player (eg. xmms, winamp, etc).
For netscape use something like "/usr/bin/xmms %s".  Mozilla / Galeon are a bit awkward, and sometimes work,
sometimes don't depending on the build.

In Galeon, make sure the "process url" checkbox is not checked and all should be well.

Restart httpd and try http://localhost/pymps and (hopefully) Bob's your uncle. 


==============================================
Pymps is Copyright (c) 2001-2002 Andy Balcombe
==============================================