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. For example,
the plugin can strip useless comments like “ripped by MyGreatRipper.”
To use the zero
plugin, enable the plugin in your configuration
(see 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 runningbeet fields
. In addition, theimages
field allows you to remove any images embedded in the media file. - 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”.