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 >= (GNU Open Source Streaming Server - **Highly Recommended** * Icecast >= 1.3.7 Optional ======== pyOgg and pyVorbis (for ogg support) - 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 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 "" to the DirectoryIndex setting: DirectoryIndex index.html index.php index.htm index.shtml index.cgi Default.htm default.htm index.php3 Add an alias for the pymps directory: Alias /pymps /var/www/pymps-0.12.1 Options ExecCGI FollowSymLinks Order Deny,Allow Deny from All Allow from localhost, 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 ==============================================