.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "ALFILLDB 1" .TH ALFILLDB 1 "2020-08-11" "perl v5.30.3" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" alfilldb \- Add/update information of music files in the AudioLink database .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBalfilldb\fR [\fI\s-1OPTION\s0\fR]... \fI/path/to/songs/\fR... .PP \&\fBalfilldb\fR [\fI\s-1OPTION\s0\fR]... \fI\-\-file=/path/to/song\fR... .SH "DESCRIPTION" .IX Header "DESCRIPTION" You can use this script to add or update information about your music files (\s-1MP3\s0 or Ogg Vorbis) in the AudioLink database. This information will be used when you use the \fBalsearch\fR\|(1) program to search for particular music. This program is part of the \fBaudiolink\fR\|(1) package. .PP The path given for the location of individual files or directories must be an absolute path (paths with ~ are allowed). Relative paths are not allowed. See the \*(L"examples\*(R" section for more information. .PP The user and password options have to be specified to gain access to the database. See the "\fImore information\fR" section in the \&\fBaudiolink\fR\|(1) man page for the various ways in which you can specify them. .PP Options that are used repetitively during different invocations of the program (like the user, password options) may be put in the config file. See the \fBaudiolink\fR\|(1) man page for details on the config file. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-add\-only\fR" 4 .IX Item "--add-only" Only the information about new songs will be added to the database; information about existing songs will not be updated. .IP "\fB\-\-file\fR=\fIxxx\fR" 4 .IX Item "--file=xxx" Works on just a single file instead of a directory. If this argument is given, the /path/to/dirs is not considered. (You can have more than one of these). .IP "\fB\-\-help\fR" 4 .IX Item "--help" Brief usage information .IP "\fB\-\-host\fR=\fIxxx\fR" 4 .IX Item "--host=xxx" Connects to the MySQL server on the given host. Default is localhost. .IP "\fB\-\-no\-prompt\fR" 4 .IX Item "--no-prompt" Don't prompt for anything. Songs which do not have information for mandatory fields (eg., song title) will not be added to the database. .IP "\fB\-\-pass\fR=\fIxxx\fR" 4 .IX Item "--pass=xxx" Password for accessing the database .IP "\fB\-\-prompt\fR=\fIxxx\fR" 4 .IX Item "--prompt=xxx" Prompt for input if there isn't enough information in the song (\s-1ID3\s0 or Ogg Vorbis comments). .Sp The parameters that prompt accepts are: .RS 4 .IP "\fIbasic\fR" 4 .IX Item "basic" Prompts just for the album name and the artist/band name .IP "\fIlimited\fR" 4 .IX Item "limited" Prompts for album, artist/band, genre and year fields .IP "\fImost\fR" 4 .IX Item "most" Prompt for all the fields except the Male, Female Artists and the Track number .IP "\fIparanoid\fR" 4 .IX Item "paranoid" Prompt for all the fields, including Male Artist (1/2), Female Artist (1/2), Track Number. .RE .RS 4 .RE .IP "\fB\-s\fR, \fB\-\-na\fR" 4 .IX Item "-s, --na" Simulate or no-act mode: doesn't update the database. .IP "\fB\-\-upd\-only\fR" 4 .IX Item "--upd-only" Only entries in the database will be updated from the input the user gives. Make sure you don't use the \-\-no\-prompt option along with this one... else you won't get anything done! .IP "\fB\-\-upd\-song\fR" 4 .IX Item "--upd-song" Update the tags in the file, ie, \s-1ID3\s0 for \s-1MP3,\s0 comments for Ogg Vorbis. .IP "\fB\-\-user\fR=\fIxxx\fR" 4 .IX Item "--user=xxx" Username for accessing the database .IP "\fB\-\-verbose\fR" 4 .IX Item "--verbose" Displays some extra information while processing files .SH "EXAMPLES" .IX Header "EXAMPLES" .ie n .IP """alfilldb \-\-add\-only /home/user/tmp/songs/""" 4 .el .IP "\f(CWalfilldb \-\-add\-only /home/user/tmp/songs/\fR" 4 .IX Item "alfilldb --add-only /home/user/tmp/songs/" This invocation will scan the /home/user/tmp/songs directory recursively for new songs only. Songs already existing in the database will not be considered. .ie n .IP """alfilldb \-\-upd\-only \-\-prompt=most ~/tmp/songs/""" 4 .el .IP "\f(CWalfilldb \-\-upd\-only \-\-prompt=most ~/tmp/songs/\fR" 4 .IX Item "alfilldb --upd-only --prompt=most ~/tmp/songs/" This invocation will scan the $(\s-1HOME\s0)/tmp/songs directory recursively for the current user for incomplete information in the database. .ie n .IP """alfilldb ~user/tmp/songs/""" 4 .el .IP "\f(CWalfilldb ~user/tmp/songs/\fR" 4 .IX Item "alfilldb ~user/tmp/songs/" This invocation will scan the /home/user/tmp/songs folder for music files; will add new entries to the database as well as update the existing ones. .ie n .IP """alfilldb \-\-file=~/tmp/songs/somefile.ogg \-\-file=~/tmp/songs/otherfile.mp3""" 4 .el .IP "\f(CWalfilldb \-\-file=~/tmp/songs/somefile.ogg \-\-file=~/tmp/songs/otherfile.mp3\fR" 4 .IX Item "alfilldb --file=~/tmp/songs/somefile.ogg --file=~/tmp/songs/otherfile.mp3" This invocation will just add (or update) information about the files $(\s-1HOME\s0)/tmp/songs/somefile.ogg and $(\s-1HOME\s0)/tmp/songs/otherfile.mp3. .SH "CAVEATS" .IX Header "CAVEATS" If the \fB\-\-prompt\fR option is not specified, \fBalfilldb\fR will just prompt for the title of the song being processed. The title information is asked only if the \s-1ID3\s0 tag or the Vorbis comment doesn't contain the title. This behavior can be overridden by the \-\-no\-prompt option, and in this case, the entry for the file will not be made, since the song title is a mandatory field for storing song information in the datbase. .PP If neither of \fB\-\-add\-only\fR or \fB\-\-upd\-only\fR are specified, the default action is to add new entries as well as update existing ones. .PP If the \s-1ID3\s0 tags or Vorbis comments for a file were updated after entries were made in the AudioLink database, they will not be reflected in the database. If you want to maintain consistency, it is advised that you keep the database updated (by using the \fB\-\-upd\-only\fR option) and then update the \s-1ID3\s0 tag in the \s-1MP3\s0 or the comment in the Ogg Vorbis file (by running \fBalfilldb\fR with the \fB\-\-upd\-only\fR option). .SH "SEE ALSO" .IX Header "SEE ALSO" L, L The current version of this man page is available on the AudioLink website at . .SH "BUGS" .IX Header "BUGS" Report bugs related to the AudioLink software or the man pages to the audiolink-devel mailing list . .SH "AUTHOR" .IX Header "AUTHOR" This manual page is written and maintained by Amit Shah .SH "COPYRIGHT" .IX Header "COPYRIGHT" The AudioLink package is Copyright (C) 2003, Amit Shah . All the programs and the documentation that come as part of AudioLink are licensed by the \s-1GNU\s0 General Public License v2 (GPLv2).