scribbu rename ¶scribbu rename will walk each file and/or directory specified
(recursively, in the case of directories) and rename each ID3-tagged
file found according to its tag(s). By default, each ID3-tagged file
will be renamed to “<artist> - <title>.<extension>” (where
<artist> & <title> are derived from the file’s ID3
tags), but this can be heavily customized by specifying a naming
“template” made up of a mixture of text and replacement parameters
(such as artist, title, album &c).
Replacement parameters begin with a % character (percent
characters that do not begin a replacement parameter may be
escaped with a backslash). Each replacement parameter has a
one-character “short” form as well as a “long-form” name. For
example, the artist replacement can be represented as either
%A or as %(artist).
When the long form is used, the action of replacement may optionally
be modified by giving options after a colon. The options take the form
opt0&opt1&opt2&... where opti is of the form
name=value, or just name. So to continue the above
example, if we wanted the artist name to instead be derived from the
ID3v1 tag, and that field was encoded as ISO-8859-1, we would say:
%(artist:v1-only&v1-encoding=iso-8859-1)
See See Tag-Based Replacements. for a complete list of replacement parameters & their options.