Basic Installation
==================

To compile this package, here is what you should do, from the current
directory :

  1. type `./configure' to configure the package for your system.

     (Default files are installed in $prefix/coverviewer/, where $prefix is
     by default "/usr/local/share". You can change this  by using
     `./configure --prefix=/usr` by example. The default is the same as
     `./configure --prefix=/usr/local`)

  2. Type `make' to compile the package.

  3. If you are logged as root:
     Type `make install' to install the programs and any data files and
     documentation.

     If you are not root, you can install the file manually like this
     'cp src/.libs/*.so ~/.xmms/Plugins' and do a `make install` (Be sure you
     have run`./configure --prefix=$HOME` on step 1! There will be an error
     message but don't panic, it's normal, everything should work fine)

  4. Launch XMMS, go in the "Preference Menu" (Ctrl+P), click on the
     "Effect/General Plugin" tab and select CoverViewer plugin. Then click
     on "Enable Plugin"

  5. Click on the Configure button if you want to change some parameters...

Internet Retrieve option
========================

You just need to go in then Configure Menu (point 4 and 5 above), and be sure
"Auto Internet Search" is clicked...

If it is not, you can still use "on demand retrieve" by clicking on coverviewer
window with the right button (hold) and select "Search cover on Internet" if available
(it is available only if artist-name and album-name are filled!)