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.