MBSync Plugin
=============

The ``mbsync`` lets you fetch metadata from MusicBrainz for albums and
singletons that already have MusicBrainz IDs. This is useful for updating tags
as they are fixed in the MusicBrainz database, or when you change your mind
about some config options that change how tags are written to files. If you have
a music library that is already nicely tagged by a program that also uses
MusicBrainz like Picard, this can speed up the initial import if you just import
“as-is” and then use ``mbsync`` to get up-to-date tags that are written to the
files according to your beets configuration.


Usage
-----

Enable the plugin and then run ``beet mbsync QUERY`` to fetch updated metadata
for a part of your collection. Since the MusicBrainZ API allows for more
efficient queries for full albums this will by run separately for all albums and
all singletons(tracks that are not part of an album) so it will use the given
query to search for both albums and singletons.

To only preview the changes that would be made, use the ``-p`` (``--pretend``)
flag. By default all the new metadata will be written to the files and the files
will be moved according to their new metadata. This behaviour can be changed
with the ``-W`` (``--nowrite``) and ``-M`` (``--nomove``) command line options.