mirror of
https://github.com/beetbox/beets.git
synced 2025-12-15 21:14:19 +01:00
23 lines
No EOL
1,010 B
ReStructuredText
23 lines
No EOL
1,010 B
ReStructuredText
Substitute Plugin
|
|
==============
|
|
|
|
The ``substitute`` plugin lets you easily substitute values in your templates and
|
|
path formats. Specifically, it is intended to let you *canonicalize* names
|
|
such as artists: For example, perhaps you want albums from The Jimi Hendrix
|
|
Experience to be sorted into the same folder as solo Hendrix albums.
|
|
|
|
This plugin is intented as a replacement for the ``rewrite`` plugin. While
|
|
the ``rewrite`` plugin modifies the metadata, this plugin does not.
|
|
|
|
Enable the ``substitute`` plugin (see :ref:`using-plugins`), then make a ``substitute:`` section in your config file to contain your rules.
|
|
Each rule consists of a case-insensitive regular expression pattern, and a
|
|
replacement value. For example, you might use:
|
|
|
|
substitute:
|
|
.*jimi hendrix.*: Jimi Hendrix
|
|
|
|
|
|
To apply the substitution, you have to call the function ``%substitute{}`` in the paths section. For example:
|
|
|
|
paths:
|
|
default: %substitute{$albumartist}/$year - $album%aunique{}/$track - $title |