mirror of
https://github.com/beetbox/beets.git
synced 2025-12-24 09:33:46 +01:00
42 lines
1.6 KiB
ReStructuredText
42 lines
1.6 KiB
ReStructuredText
Zero Plugin
|
|
===========
|
|
|
|
The ``zero`` plugin allows you to null fields in files' metadata tags. Fields
|
|
can be nulled unconditionally or conditioned on a pattern match. It works in
|
|
two independent modes - blacklist and whitelist. You can only choose one option,
|
|
however blacklist is the default. For example, the plugin can strip useless
|
|
comments like "ripped by MyGreatRipper."
|
|
|
|
To use the ``zero`` plugin, enable the plugin in your configuration
|
|
(see :ref:`using-plugins`).
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
Make a ``zero:`` section in your configuration file. You can specify the
|
|
fields to nullify and the conditions for nullifying them:
|
|
|
|
* Set ``fields`` to a whitespace-separated list of fields to change. You can
|
|
get the list of all available fields by running ``beet fields``. In
|
|
addition, the ``images`` field allows you to remove any images
|
|
embedded in the media file.
|
|
* Set ``keep_fields`` respectively to list of fields that plugin should
|
|
preserve. That way ``zero`` cleans anything other than fields written in this
|
|
option.
|
|
* To conditionally filter a field, use ``field: [regexp, regexp]`` to specify
|
|
regular expressions.
|
|
* By default this plugin only affects files' tags ; the beets database is left
|
|
unchanged. To update the tags in the database, set the ``update_database`` option.
|
|
|
|
For example::
|
|
|
|
zero:
|
|
fields: month day genre comments
|
|
comments: [EAC, LAME, from.+collection, 'ripped by']
|
|
genre: [rnb, 'power metal']
|
|
update_database: true
|
|
|
|
If a custom pattern is not defined for a given field, the field will be nulled
|
|
unconditionally.
|
|
|
|
Note that the plugin currently does not zero fields when importing "as-is".
|