This is a program to print formatted music metadata. It uses libavformat to
extract the metadata, and thus will work on a large variety of files. It also
searches the steam metadata as well as the container metadata (as some
malformatted music files have their metadata in weird places)
Still in development, some features not implemented yet.
Usage:
$ muprint [OPTIONS] format_string filename
The format string is similar to printf's format string. It uses % to denote
metadata chunks from the loaded file. %% is used to denote a literal %. each
metadata chunk is composed of an optional modifier character followed by a type
character. The modifier characters change the allowed characters, causing the
illegal characters to be ignored or replaced with the character specified by
the -r option. If you need more advanced replace options, use another program
like tr.
MODIFIERS:
v - allow all printing (visible) ascii characters (as defined by isprint(3))
p - allow all characters in the POSIX.1-2008 portable filesystem character set
(that is: all alphanumeric characters plus period (.), underscore(_) and
hyphen (-). Does NOT enforce that the first character should not be hyphen
u - allow all characters that are valid characters in unix filenames (i.e. not
'\0' and '/')
c - allows a custom set of characters, specified by the -c flag
TYPES:
t - The track title
T - The track number, does not currently support padding
d - The disc number, does not currently support padding
b - The album
A - The album artist
a - The artist
e - The file's original extension
f - The original file basename (not including extension)
% - a literal %
examples:
/media/Music/%pA/%pb/%d-%T-%t.%e would be
/media/<album artist>/<album>/<artist>/<disc>-<track>-<title>.<extension>
with all characters not in the metadata that are not in the posix portable
filesystem character set to be ignored/replaced
OPTIONS:
-c <characters> specifies what the custom character whitelist should be. Just
a string of characters e.g. "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
-s <original type><subsitition string> specifies what to replace a metadata
element with if not found. Defaults to "unknown". Other metadata elements
are valid. For example, you can replace all album artists with the artist
using -s "A%a". Multiple substitutions for the same metadata type are
allowed and the last one added will take precedence. If the substition
string contains metadata types that are unknown it is ignored. This allows
chains of subsitions (e.g. replace X with Y if y exists, otherwise replace
with Z)
-r <single char> replace non-whitelisted characters with this one instead of
deleting them
BUILDING:
You need libavformat and libavutil. Other than that its straight up C11 with
POSIX.1-200809L extensions, so just running
$ make
should work. If you're debuging there's also
$ make debug
which turns on -g for you
CONTACT:
andrew.jeddeloh.HATESSPAM@gmail.com
remember, I hate spam, so just remove that part.