10/02/01

phpxmms v1.0
------------

Requirements
============

Apache
PHP 4 +
XMMS 1.2.4 (with xmms-shell)
XMMS-Liveice
Icecast
rsh-server


Installation
============

1.	untar the contents of phpxmms-1.x.tar.gz into a directory under your web
server.

2.	Change the following variables in config.php:

$predir --> This is your mp3 directory
$tuser --> This is the user XMMS runs as
$thost --> This is box running XMMS
$ntheme --> Theme name (default is chaos)

3.	In order for phpxmms to function, the web user must be able to execute the
commands, so add a '.rhosts' file to the direcory of the user XMMS runs as (ie:
/home/user/.rhost).  A sample '.rhosts' file is in the archive as '.rhosts.samp'.  The format is 'host	user-apache-runs-as'.

4.	Go to http://localhost/phpxmms-1.x/ and click on 'Launch'

5.	You can strip the info out of phpxmms-1.x/index.html , and insert it into
your own page, if you like.  I'd also recommend adding a .htaccess file, so not
everyone can switch songs, or delete your playlist :)


TODO
====

- add ability to upload to server
- find an alternate to rsh (If anyone knows of one, let us know)
- improve performance on long playlists
- add ability to change themes from window

BUG LIST
========

- crashes when clearing playlist while playing.  Stop the player first.

CONTACT
======

Questions?  support@warpedsystems.sk.ca

