mirror of
https://github.com/beetbox/beets.git
synced 2025-12-19 15:13:44 +01:00
26 lines
1.3 KiB
ReStructuredText
26 lines
1.3 KiB
ReStructuredText
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.
|