REQUIREMENTS

• Linux (MP3DB has been tested under SuSE 7.0 but should run under any other version)

• MySQL (Is needed as database backend)

• Perl5

• Perl Modules:

  • Tk

  • Tk-MesgBox

  • Tk-LabFrame

  • Tk-Pane

  • DBI

  • MP3-Info

  • Msql-Mysql-modules

• To play MP3 files the MP3 player XMMS should be installed on your system. MP3-Database can easily be adapted to other MP3 players

RECOMMENDED

• UNIX/LINUX command eject (Only if you want MP3DB to automaticaly eject CDs)

• Kernel Modules for Rio500 (Only if you want to download files to a RIO500 portable MP3 player)

INSTALLATION

It is very easy to install MP3-Database. Because the program is written in PERL/TK, it has not to be compiled. Only the program files have to be copied to the right directories. This is done by the installation script included.

Here is a short step by step instruction to install MP3DB:

NOTICE:

PERL must be already installed on your system!!!

1. Install MySQL on your system. (see INSTALLING MySQL)

2. If you want to upload files to your RIO500 install the rio500 kernel modules and make sure they are running before starting MP3DB. (See INSTALLING RIO500 KERNEL MODULES)

3. Install the following Perl modules to your system: (See INSTALLING PERL MODULES)

   • Tk

   • Tk-MesgBox

   • Tk-LabFrame

   • Tk-Pane

   • DBI

   • MP3-Info

   • Msql-Mysql-modules

4. Extract all the files of the tar.gz file you have downloaded to a temporary directory.

5. Run the script install.pl with the root user (or any other user who has the right to create databases and add users to your local MySQL server and has the permissions to write to the installation directory you choose). This will install MP3DB and create the MP3 database. Install takes also care that a mysql user and a password is created to access the database with MP3DB.

6. Start MP3DB with the command: MP3DB

I'am sorry that the instruction is so short. But there is certainly one out there who could do this better. If you should like to volunteer please send me a Mail.

INSTALLATION FAILED?

PLEASE DO NOT DELETE MP3DB AND FORGET ABOUT IT! I NEED YOUR HELP TO IMPROVE MP3DB!

If you have any problems with MP3DB please do not hesitate to contact me. I need your help to make things better. If you find a bug or have any problem with the installation script, please send me a mail. That enables me to improve MP3DB.

INSTALLING PERL MODULES

You probably will have to download the modules from CPAN ( http://www.cpan.org ). I did not include the modules in the MP3DB package to reduce the download time. To install the modules simply follow these steps:

1. Unpack the downloaded module to a temporary folder

2. Change to this directory and run the following commands under root permissions:

   • perl Makefile.PL

   • make

   • make test

   • make install

3. Repeat these steps for all modules

INSTALLING MYSQL

Please read the documentation for MySQL on http://www.mysql.com/documentation/index.html

INSTALLING RIO500 KERNEL MODULES

Please read the documentation that comes with the package you have downloaded.