.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH lltag_config 5 "NOVEMBER 2006"



.SH NAME
config \- Configuration file for lltag



.SH DESCRIPTION
The following options may be stored in
.I /etc/lltag/config
or the user's
.IR $HOME/.lltag/config ,
or in any file passed with
.IR --config .

Such a configuration file may also be generated with
.IR --gencfg .



.SH Obtaining tags

.I format = \fI"string"
.RS
Add a user-defined format
.RB [ -R ].
Might be used multiple times.
Default is to guess if no user-defined formats and no default field values are given.
.RE
.I guess = <0/1>
.RS
Try to guess if user-defined formats do not match
.RB [ -G ].
Default is
.BR 0 " (" disabled ") when no user-defined formats and no explicit values are given."
.RE
.I tag = <TAG=value>
.RS
Add an explicit tag
.RB [ --tag ].
Might be used multiple times.
.RE


.SH Tweaking filename parsing

.I no_path = <0/1>
.RS
Do not use file path when matching filename
.RB [ -p ].
Default is
.BR 0 " (" disabled ")."
.RE
.I spaces = <0/1>
.RS
Allow no or multiple spaces
.RB [ --spaces ].
Default is
.BR 0 " (" disabled ")."
.RE


.SH Cleaning obtained tags

.I edit = <0/1>
.RS
Edit tags immediately
.RB [ --edit ].
Default is
.BR 0 " (" disabled ")."
.RE
.I maj = <0/1>
.RS
Upcase first letters of words in tags
.RB [ --maj ].
Default is
.BR 0 " (" disabled ")."
.RE
.I regexp = \fI"s/from/to/"
.RS
Replace \fIfrom\fR with \fIto\fR in all tags.
.I title,number:s/from/to/
replaces in title and number tags only.
Might be used multiple times
.RB [ --regexp ].
Default is to not apply any regexp.
.RE
.I sep = \fI"string"
.RS
Replace |-separated strings with space in tags.
Default is to not replace any separator.
.RE


.SH Configuration of tag application

.I type = <mp3|ogg|flac|none>
.RS
Force mp3, ogg of flac instead of by-extension detection
.RB [ --mp3 ", " --ogg " and " --flac ].
Default is
.BR none .
.RE
.I clear_tags = <0/1>
.RS
Clear all tags of audio files.
.BR [ --clear ].
Default is
.BR 0 " (" disabled ")."
.RE
.I append_tags = <0/1>
.RS
Append tags only instead of replacing old ones.
.RB [ --append ].
Default is
.BR 0 " (" disabled ")."
.RE
.I no_tagging = <0/1>
.RS
Do not actually tag files
.RB [ --no-tagging ].
Default is
.BR 0 " (" disabled ")."
.RE
.I preserve_time = <0/1>
.RS
Preserve file modification time during tagging
.RB [ --preserve-time ].
Default is
.BR 0 " (" disabled ")."
.RE


.SH Renaming

.I rename_format = \fI"string"
.RS
Rename file according to format
.RB [ --rename ].
Default is to not rename.
.RE
.I rename_min = <0/1>
.RS
Lowcase tags before renaming
.RB [ --rename-min ].
Default is
.BR 0 " (" disabled ")."
.RE
.I rename_regexp = \fI"s/from/to/"
.RS
Replace \fIfrom\fR with \fIto\fR in all tags before renaming.
.I title,number:s/from/to/
replaces in title and number tags only.
Might be used multiple times
.RB [ --rename-regexp ].
Default is to not apply any regexp.
.RE
.I rename_sep = \fI"string"
.RS
Replace spaces with a string in tags before renaming
.RB [ --rename-sep ].
Default is to not replace any separator.
.RE
.I rename_slash = \fI"string"
.RS
Replace slashes with a string in tags before renaming
.RB [ --rename-slash ].
Default is to replace with a dash.
.RE
.I rename_ext = <0/1>
.RS
Assume the rename format provides an extension
.RB [ --rename-ext ].
Default is
.BR 0 " (" disabled ")."
.RE


.SH Miscellaneous

.I dry_run = <0/1>
.RS
Do nothing but show what would have been done
.RB [ --dry-run ].
Default is
.BR 0 " (" disabled ")."
.RE
.I yes = <0/1>
.RS
Tag without asking for confirmation when guessing
and rename without asking for confirmation
.RB [ --yes ].
Default is
.BR 0 " (" disabled ")."
.RE
.I ask = <0/1>
.RS
Always ask for confirmation before tagging
.RB [ --ask ].
Default is
.BR 0 " (" disabled ")."
.RE
.I recursive = <0/1>
.RS
Recursively traverse all given subdirectories
.RB [ -R ].
Default is
.BR 0 " (" disabled ")."
.RE
.I verbose = <integer>
.RS
Message verbosity level
.RB [ -v " and " -q ].
Default is
.BR 0 " (" "only important messages" ")."
Other possible values are
.BR 1 " (" "show usage information when a menu is displayed for the first time" ")"
and
.BR 2 " (" "always show usage information before a menu appears" ")."
.RE


.SH CDDB configuration

.I cddb_server_name = "hostname"
.RS
Change the CDDB server name.
Default is
.BR www.freedb.org .
.RE
.I cddb_server_port = <port>
.RS
Change the CDDB server port.
Default is
.BR 80 " (" HTTP ")."
.RE



.SH SEE ALSO
.PP
.BR lltag (1)

The
.I config
template file provided within the documentation directory.



.SH AUTHOR
Brice Goglin