Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2026-01-08 17:08:12 +01:00
Code Issues Projects Releases Wiki Activity

mbsync: update docs

Browse source
This commit is contained in:
Jakob Schnitzer 2013-03-03 14:21:34 +01:00
parent 3a9c9d53da
commit 49d3ca4f02
1 changed files with 13 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
docs/plugins/mbsync.rst
View file

@ -1,21 +1,25 @@
MBSync Plugin
=============
The ``mbsync`` lets you fetch metadata from MusicBrainz for albums 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.
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. This only work for album queries at the moment.
for a part of your collection. By default this will use the given query to
search for albums and singletons. You can use the ``-a`` (``--album``) and
``-s`` (``--singleton``) command line flags to only search for albums or
singletons respectively.
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