Back to files

-:| README |:-

>> What is `médiArchiver`?
As you have maybe guessed it, médiArchiver is a media archiver :)

You can use it to catalog you stacks of Audio CDs, MP3^M^M^MOggs, CDRoms, DVDs, and also your USB key, PDA, hard-drive directories, ...

>> What does it actually do ?

• manage common medias: Audio CDs, DVDs, Hard-drives
• try to retrieve as many meta-datas as it can
• allow catalog browsing via a web interface

>> What does it require to work: see REQUIREMENTS

>> How does it work:

1. Installation
   • execute database creation scripts: first 'struct.mysql.sql' then 'values.sql' (if using MySQL)

        $> mysql -u my_user < database/struct.mysql.sql
        $> mysql -u my_user -D mediarchiver < database/values.sql
 
        or 'struct.sqlite.sql' and 'values.sql' (if using SQLite)

        $> sqlite3 my-db.sqlitedb < database/struct.sqlite.sql
        $> sqlite3 my-db.sqlitedb < database/values.sql

     - médiArchiver librairie files must be viewable by the perl executable.

        So either add the 'libraries' directory to the PERL5LIB variable:
        $> export PERL5LIB=$PERL5LIB:`pwd`/libraries
        
        Or copy the 'libraries' directory content in one 
        of the perl system directories
        (/usr/lib/perl/5.8/, /usr/share/perl/5.8/, ...)

     - copy the sample configuration file (sample.cfg) 
        either at '/etc/mediarchiver/mediarchiver.cfg'  (global level)
        or at '$HOME/.mediarchiver/mediarchiver.cfg'    (user level)

b. Medias retrieving

     use 'media.add [options]' program.
     try 'media.add --help' to see all available options

c. Medias browsing

     you first have to lauch the lightweight web server:
        $> media.server [options]

        NOTE: if you want not to launch 'media.server' as root, 
              the port must be > 1024

     then go to the following address in your browser:
        http://localhost:port/browser.html 
        (where 'port' is the defined port, 50000 by default)

     That's it: you must see the médiArchiver browsing page,
        showing the 'default' catalog content

>> I have a problem, a question, anything else?

Send me an e-mail at <guillaume.bour@free.fr> with '[MEDIARCHIVER]' in the subject

>> What about the copyright?

This program is distributed under the GNU GPL2 Licence (see the COPYING file).
You are free to use, modify and redistribute it.

$2005/01/12$