$Id: README,v 1.4 2003/12/05 09:22:18 amitshah Exp $

AudioLink

What is this tool supposed to do?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Let's say I have a lot of songs, sorted by the albums they feature
in. Now, if I want to listen to songs, all sung by a particular
artist, I'll have to remember each of the artist's albums, or rummage
through the entire collection. Both of these options (and any others,
on similar lines) are not viable.

So, wouldn't it be nice if I could just give a search for the artist,
and I get a "view" in which I can access all of the artist's songs? On
traditional UNIX systems, a very simplistic version of this view would
be creating a directory with the name of the artist, and creating
symbolic links to all the songs of that artist in this new
directory. In this way, you have all his songs in one place. This is
just what AudioLink does... all you do is add all of these files in a
playlist and enjoy! :-)


Currently, it's called AudioLink, 'cos the first milestone would just
handle audio files.


Running the AudioLink scripts:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You can directly run the perl scripts which are located in the code/
directory. For instance, if you want to search for particular songs in
your collection, run code/alsearch. For adding entries into the
database, run code/alfilldb.

You can also run 'make install' to install these scripts system-wide,
so that all the users on the local machine have access to them.


Getting help:
~~~~~~~~~~~~
Extensive documentation on how to use the scripts and other
information is given in the manpages alsearch(1), alfilldb(1) and
audiolink(1). The manuals are also available as HTML files in the
Documentation directory.

In case you have any problems, post your queries to the
audiolink-users@lists.sourceforge.net mailing list.

If there are bugs, you can report them to the
audiolink-devel@lists.sourceforge.net mailing list.


More information:
~~~~~~~~~~~~~~~~
Read the RELEASE_NOTES and INSTALL files before running the scripts.

Read the Documentation/motivation.txt file for the motivation for
writing AudioLink

Send feedback to audiolink-users@lists.sourceforge.net

Have fun :-)
