Provided by: btag_1.4.1-0.1_amd64 
NAME
btag - A command line based multimedia tagger
SYNOPSIS
btag [options] path1 [path2] [path3] ...
DESCRIPTION
btag is a TagLib-based command line multimedia tag editor that attempts to automate the process of
tagging a lot of files at once. It uses the tags found in the supplied files as well as interactive user
input to determine new values for the tags. It can also optionally rename files and directories based on
those new values.
You can supply paths to files or directories to btag. Directories are recursively traversed and all files
found are tagged. Directories are also handled differently in the sense that btag will attempt to keep
information about the previously tagged files to provide sane defaults for all other files in the same
parent directory. Only files with file extensions supported by TagLib are considered.
Multiple cue sheets can be specified. btag will then search for track information in all cue sheets in
the order they have been specified. Track numbers are automatically adjusted assuming that all cue sheets
have track numbers starting from 1. This is particularly useful for tagging albums that span multiple
CDs. Note that a single encoding is assumed for all cue sheets specified.
OPTIONS
--always-ask-track Always ask for confirmation for the track number
-C/--cue-sheet file Read any existing metadata from the cue sheet file
--cue-sheet-encoding enc Assume encoding enc for the cue sheet (often UTF-8 or ISO-8859-1)
-D/--dry-run Don't do anything, just show what would have been done (dry run mode)
-d/--dir-rename-format format Use format to rename the directories where the multimedia files were
found
-i/--input-filter filter Use filter as the input filter
-f/--filter filter Use filter as both the input and the output filter
-h/--help Display usage information and exit
-n/--renaming-filter filter Use filter as the renaming filter
-o/--output-filter filter Use filter as the input filter
-r/--file-rename-format format Use format to rename the multimedia files
-t/--title-locale locale Use locale for proper (although lax) locale-specific title casing
INPUT AND OUTPUT FILTERS
btag supports input and output filters that are applied to the text fields (artist, album and song
title). Those filters can protect against basic mistakes such as duplicate whitespace. Input filters are
used on the tags as they are loaded from the multimedia files. This filtered information is used to
provide suggestions to the user when the interactive tagger requests information for those text fields.
If an output filter is configured, the user input is then filtered, and if the filtered text does not
match the user input, the user is asked for confirmation.
In most cases, the input filter should match the output filter (which is why the -f option is handy). You
may choose to specify only an input filter, in which case the user input is not filtered. If you don't
specify an input filter, though, the default input filter will be used.
The currently available filters are:
basic Provides basic filtering by removing duplicate or trailing whitespace, is the default input
filter and the base for all other filters
first_upper The first character in the field is uppercased, while all others are lowercased
lower All characters are lowercased
title The first character of each word is uppercased (with exceptions), while all others are
lowercased
upper All characters are uppercased
The title capitalization algorithm will follow locale-specific context-insensitive rules depending on the
value of the -t parameter. Note that strict title capitalization rules often depend on the context in
which the words are used, the precise analysis of which is much beyond the scope of btag. The currently
supported title locale specifications are:
en English (default)
es Spanish
RENAMING FORMATS
If a format is specified with the -r option, the tagged multimedia files are renamed accordingly.
Likewise, if the -d option is used, the directory in which multimedia files were tagged is renamed
according to the specified format.
The specified format is converted to a file or directory name using the following substitutions:
%artist Artist name
%album Album name
%year Year of release
%track Track number (only replaced by the -r option)
%title Song title (only replaced by the -r option)
Renaming happens after the tags are written, and it's relative to btag's working directory.
For directory renaming, the last known artist, album and year information is used. Only directories that
contain files that were tagged by btag are renamed.
btag does not prevent you from overwriting existing files using the formats described here.
RENAMING FILTERS
Renaming filters are used to ensure that the file and directory names generated using the renaming
formats (if specified) are valid (safe) in the context of the current file system. The following renaming
filters are currently available:
conservative Conservative character replacements are performed, recommended for FAT32 file systems
unix Generates file and directory names that should be valid in an Unix environment (default)
NOTES
You can specify any encoding supported by iconv_open(3).
BUGS
There is no standard encoding for cue sheets, so btag assumes ISO-8859-1 if no encoding is specified.
Although you can specify any encoding for cue sheets, the body of the cue sheet will be read using the
system's locale. Only the text fields in the cue sheet are converted from the specified encoding. To
prevent trouble, use an ASCII-compatible system-wide charset (preferably UTF-8) and stick to ASCII-
compatible encodings for cue sheets (preferably ISO-8859-1).
EXAMPLE
Using title casing with English rules and sensible renaming formats generating FAT32-safe file and
directory names:
$ btag --file-rename-format '%track. %title' \
--dir-rename-format '%album (%year)' \
--filter title --title-locale en \
--renaming-format conservative /path/to/myalbum
Using an input filter only:
$ btag --input-filter lower /path/to/myalbum
btag 2012-17-06 BTAG(1)