File	Date	Author	Commit
Documentation	2003-12-05	amitshah	[ed200a] documents
code	2009-05-25	Sebastien Delafond	[bd19e9] audiolink: fix insecure tempfile creation
db	2003-09-17	amitshah	[78d8e5] added track number to schema
web	2003-12-07	amitshah	[302a30] alfilldb, alsearch documentation now point to t...
.cvsignore	2003-12-05	amitshah	[756b78] ignore debian/ and gui/
COPYING	2003-09-11	amitshah	[8261a6] Added the license
CREDITS	2003-09-22	amitshah	[926e54] mv developers.txt CREDITS
ChangeLog	2003-12-05	amitshah	[50ee20] ChangeLog update for 0.05
Changes	2003-12-05	amitshah	[c39ac8] update for 0.05
FEATURES	2003-12-06	amitshah	[3a7b3e] added all the features supported till now
INSTALL	2003-12-05	amitshah	[a6e51b] You can now use the audiolink script to create ...
Makefile	2003-12-06	amitshah	[c5bcc9] $(Q)uieten stuff that wasn't.
README	2003-12-05	amitshah	[0b8edb] better 1st para
RELEASE_NOTES	2003-12-05	amitshah	[cd54d4] release notes update for 0.05
TODO	2003-12-05	amitshah	[e3f24c] 1. We have a config file
VERSION	2003-12-06	amitshah	[b81f17] update for 0.05

Read Me

$Id$

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 :-)