AUDIOLINK(1)

📦
version 0.05 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble

okay bestie, listen — this is the manual page for audiolink, coming at you from the User Contributed Perl Documentation corner of the world. sit down, grab a boba, we're doing this 💅

✨ NAME ✨

audiolink — bestie, it makes your AudioLink config file, plus the databases and the tables. that's the whole job. iconic.

🌸 SYNOPSIS 🌸

audiolink [OPTION]...

🦋 DESCRIPTION 🦋

so AudioLink is this whole lil family of programs that helps you manage your music collection. it makes searching for music on your local storage media easier and faster — no more scrolling for 800 years, we're done with that era. your searches can hit a bunch of criteria at once, like male artists, female artists, band, genre, etc. etc. the way it just filters, we love her 💜

it supports music files in MP3 and Ogg Vorbis formats. periodt.

and audiolink itself? it's the one helping you out by creating a configuration file for the options you use all the time when you pass stuff to the AudioLink programs — and by creating the MySQL database and tables that the AudioLink programs alfilldb(1) and alsearch(1) use. she's the setup girlie. the main character of the pre-game ✨

ngl, one thing to clock: the options you type at the command prompt override the options in the config file. prompt wins, always. no cap.

🎀 OPTIONS 🎀

  • --help — gives you the brief usage info. the tl;dr of the tl;dr 💖
  • --host=xxx — connects to the MySQL server on the target host. the default is localhost. so if you say nothing, she's staying home, comfy 🛋️
  • --pass=xxx — password for the database 🔐
  • --user=xxx — username for the database 👤
  • --verbose — displays extra information about what's going on. she will tell you everything, she's a yapper, and honestly? we respect it 🙈

🌈 MORE INFORMATION 🌈

okay so here's the thing — the user and password fields for the database have to be specified. not optional, not "i'll do it later", they have to be there. there are three ways to do 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
  1. 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. yes, actually read it, bestie, it's giving ✨research✨

  1. 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. set it once, forget it forever. obsessed.

💜 CONFIGURATION FILE 💜

the AudioLink configuration file config resides in the .audiolink/ directory in the user's home directory — that's $HOME/.audiolink/config 🏠

the format of the current config file is pretty easy to understand, like honestly it's babygirl-simple: 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

and that's it. that's the whole vibe. 🍓

🔥 SEE ALSO 🔥

alfilldb(1), alsearch(1)

the current version of this man page is available on the AudioLink website at <http://audiolink.sourceforge.net/>. go look, it's cute 🦋

💀 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>. thank you for your service 🫡💖

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

okay that's the whole page, you're officially educated 💅 this was rendered by perl v5.30.3 and dated 2020-08-11 — so yeah, she's vintage, she's archival, she's still slaying. mwah, go make some databases bestie 🎀✨

📦 where this page comes from