NAME
audiolink - Create AudioLink config file, databases and tables
--- when everything is integrated
SYNOPSIS
audiolink [OPTION]...
DESCRIPTION
AudioLink is a set of programs which help you manage your music
collection. It makes searching for music on your local storage media
easier and faster. Your searches can include a variety of criteria,
like male artists, female artists, band, genre, etc.
It supports music files of MP3 and Ogg Vorbis formats.
audiolink assists you in creating a configuration file for oft-used
options passed to the AudioLink programs and creating the MySQL
database and tables which the AudioLink programs, alfilldb(1) and
alsearch(1) use.
The options specified on the command prompt override the options
specified in the config file.
OPTIONS
--help
Brief usage information
--host=xxx
Connects to the MySQL server on the target host. Default is
localhost.
--pass=xxx
Password for the database
--user=xxx
Username for the database
--verbose
Display extra information about what’s going on
MORE INFORMATION
The user and password fields for the database have to be specified.
There are three ways of doing this:
1. Command-line arguments
By specifying them via the --user and --pass command-line arguments
to the programs:
"alfilldb --user=mysql_username --pass=mysql_password
--prompt=basic /songs/"
"alsearch --user=mysql_username --pass=mysql_password
--artist=kishore --td=/songs/kishore"
2. Environment variables
Setting the DBI_USER and DBI_PASS environment variables:
If you are using bash, ksh, zsh or sh do this:
"export DBI_USER=mysql_username"
"export DBI_PASS=mysql_password"
If you are using csh or tcsh, do this:
"setenv DBI_USER mysql_username"
"setenv DBI_USER mysql_password"
Consult the man page of the respective shell interpreter that you
use for help on environment variables.
3. Config file
Specifying them in the config file (the most convenient). The
config file is stored in each user’s home directory in the
~/.audiolink/config location.
CONFIGURATION FILE
The AudioLink configuration file config resides in the .audiolink/
directory in the user’s home directory ($HOME/.audiolink/config).
The format of the current config file is pretty easy to understand:
Just put in "a = b" on separate lines for all the options you want the
AudioLink scripts to use by default. Here, a is the option name, like
user, password, host, etc., and b is the value you wish to associate
the option with. For example, to set the username for accessing the
database to ’root’, you would put this in the config file:
"user = root"
SEE ALSO
L<alfilldb(1)>, L<alsearch(1)> The current version of this man page is
available on the AudioLink website at
<http://audiolink.sourceforge.net/>.
BUGS
Report bugs related to the AudioLink software or the man pages to the
audiolink-devel mailing list <audiolink-devel@lists.sourceforge.net>.
AUTHOR
This manual page is written and maintained by Amit Shah
<amitshah@gmx.net>
COPYRIGHT
The AudioLink package is Copyright (C) 2003, Amit Shah
<amitshah@gmx.net>. All the programs and the documentation that come as
part of AudioLink are licensed by the GNU General Public License v2
(GPLv2).
POD ERRORS
Hey! The above document had some coding errors, which are explained
below:
Around line 225:
’=begin’ only takes one parameter, not several as in ’=begin later
audiolink - Music collection manager’
Around line 230:
=end later without matching =begin. (Stack: [empty])