muwed - music web database v0.12
--------------------------------

Copyright (C) 2001 by Andreas S. Krebs (andreas.krebs@web.de)


--------------- GNU General Public License Disclamer ---------------
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
--------------------------------------------------------------------


Features:
---------
-postgres based MP3 database
-perl script to add files to database
-PHP web frontend to access and manage the database
-web frontend has integrated support to control irmp3 player
-MP3 ID3v2 tag support (can display APIC frame)


Notes:
------
1. This version of muwed requires a patched version of irmp3 v0.4.3-pre6
   to work correct. For details on how to install the patch see the
   install instructions below.
2. If you're upgrading from a previous version make sure to install the
   MP3::Tag perl module.
3. The new database management functions of muwed don't perform any kind
   of access control. If you want access control, use apache's access
   control functions to restrict access to muwed/manage folder.


Requirements: 
-------------
The following components are required and have to be installed in order
to use muwed. For information about how to obtain and install the
components see the provided links.
-PostgreSQL database [http://www.postgresql.org/]
-perl [http://www.perl.org/]
 + Pg PostgreSQL module [http://www.cpan.org/]
 + MP3::Info module [http://sourceforge.net/projects/mp3-info/]
 + MP3::Tag module [http://tagged.sourceforge.net]
-PHP4 [http://www.php.net/] (PHP3 may work, but never tested it)
 + Postgres modules
-apache web server [http://www.apache.org/]
 + configured to run php scripts
-IRMP3 v0.4.3-pre6 with provided patch applied [http://www.dpotter.com/irmp3/]
 + with mod_netctl buildin


My configuration:
-----------------
on my redhat 7.1 system I use the following rpms and tarballs:
-postgresql-7.0.3-8.i386.rpm
-postgresql-server-7.0.3-8.i386.rpm
-perl-5.6.0-9.i386.rpm
-postgresql-perl-7.0.3-8.i386.rpm
-http://prdownloads.sourceforge.net/mp3-info/MP3-Info-0.91.tar.gz
-http://download.sourceforge.net/tagged/tagged-0.30.tar.gz
-php-4.0.4pl1-9.i386.rpm
-php-pgsql-4.0.4pl1-9.i386.rpm
-apache-1.3.19-5.i386.rpm
-http://www.dpotter.com/irmp3/files/irmp3-0.4.3-pre6.tar.gz


Quick Installation:
-------------------
1. create the muwed database by running the create_muwed.sh script
   (change dbname or dbuser if needed)
2. copy the muwed folder into the root directory of your apache
   web server
3. copy the files from the cgi-bin folder to the /cgi-bin folder of
   your web server and make sure you can execute perl scripts
4. edit the muwed/config.inc file so that they represent your configuration
5. build irmp3 v0.4.3-pre6 with patch applied:
   -extract irmp3 v0.4.3-pre6 tarball
   -go to the irmp3 folder and apply the patch with
    'zcat irmp0.4.3-pre6_query.patch.gz | patch -p 1'
   -build and install the patched version of irmp3 v0.4.3-pre6
7. add a song to your database using the add2muwed.pl script
8. access the database via http://<your server>/muwed and enjoy


Upgrade from version v0.1:
--------------------------
1. backup your database running "pg_dump muwed >muwed_backup" as postgres
   user ("man pg_dump" for more information)
2. run upgrade_0.1-0.12.sh script (WARNING: only run it once)
3. follow steps 2-6 from the quick installation above


Todo:
-----
-documentation
-playlist support (web frontend, irmp3)
-setting id3 tags in mp3 files from database
-...

