About gmmusic:

gmmusic uses its own database model, which consists of three item classes:

song (is identified by the artist and the title of a song)
medium (contains the recording(s) of a song)
recording (instance(s) of a song, reside on one or more media)

There's also a fourth class:

artist (contains detailed artist info)

Because of this, if you start with gmmusic, you first have to create your artist(s) (this will happen on-the-fly most the time), then you have to create your media (like CDs or LPs), and only if these things all exist, you can actually enter your songs and recordings (e.g. the tracks of a CD).

This approach might look a bit uncommon at first sight, but you will get used to it very fast, and at the end, you can't imagine how you would handle your (large) collection otherwise :)

Gnome- and other issues:

If gmmusic doesn't start from the GNOME start menu, please run gmmusic from the shell and examine the error message. You most probably don't have a valid installed PostgreSQL database.

Preferences

You can set preferences in the file ~/.gmmusicrc

Please copy the file gmmusicrc from the distribution into your home directory and rename it to .gmmusicrc

A list of freedb servers can be saved in ~/.gmmusic/sites.

Copy the file sites to ~/.gmmusic/.

Requirements

Perl >= 5.005
PostgreSQL >= 7.0.3
PostgreSQL-perl
Gtk-Perl >= 0.7008 (installed per default, if you use Gnome)
perl-MailUtils >= 1.15 (available via CPAN)
perl-MIME-tools (available via CPAN)
libwww-perl >= 5.41 (available via CPAN)
Config-General >= 1.18 (available via CPAN)
Locale::gettext >= 1.01 (available via CPAN)
MP3::Tag >= 0.40 (available via CPAN)
MP3::Info >= 0.91 (available via CPAN)

If you want to install the XMMS plugin, you also need:

XMMS >= 0.9.1
Xmms-Perl (available via CPAN)

Supported platforms:

On the following platforms reading of the TOC from CD is supported:

Linux
FreeBSD, openbsd, BSD/OS (tested only for FreeBSD)
SunOS, SunOS4 (untested)

Upgrading from old database versions:

If you get an error, telling you, that your database version is too old, and you have to upgrade it, simply log in as root and become the Postgres user (on RedHat and SuSE, this is the account 'postgres') and run the script 'update-gmmusic'. This script resides in /usr/bin (or wherever else you installed gmmusic).

Your old database is automatically backed up into the directory /var/lib/gmmusic or, if this directory could not be created, /var/tmp. So, if an error occurs during the update, you can re-install the latest data of your database again.

Have fun and please report errors and suggestions.

Web : http://gmmusic.sourceforge.net
Mail: gmmusic-support@lists.sourceforge.net

$Id: README,v 1.25.4.5.2.6 2002/12/18 20:21:57 mahowi Exp $ vim: tw=78 expandtab