
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."

The plugin can work in one of two modes. The first mode, the default,
is a blacklist, where you choose the tags you want to remove. The
second mode is a whitelist, where you instead specify the tags you
want to keep.

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 running "beet
  fields". In addition, the "images" field allows you to remove any
  images embedded in the media file.

* Set "keep_fields" to *invert* the logic of the plugin. Only these
  fields will be kept; other fields will be removed. Remember to set
  only "fields" or "keep_fields"---not both!

* 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".
