Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2025-12-14 04:23:56 +01:00
Code Issues Projects Releases Wiki Activity

mbsync: documentation

Browse source
This commit is contained in:
Jakob Schnitzer 2013-03-03 12:25:53 +01:00
parent cd7305d487
commit 78a99c23fa
2 changed files with 24 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
docs/plugins/index.rst
View file

@ -60,6 +60,7 @@ disabled by default, but you can turn them on as described above.
convert
info
smartplaylist
mbsync
Autotagger Extensions
''''''''''''''''''''''
@ -73,6 +74,7 @@ Metadata
* :doc:`lyrics`: Automatically fetch song lyrics.
* :doc:`echonest_tempo`: Automatically fetch song tempos (bpm).
* :doc:`lastgenre`: Fetch genres based on Last.fm tags.
* :doc:`mbsync`: Fetch updated metadata from MusicBrainz
* :doc:`fetchart`: Fetch album cover art from various sources.
* :doc:`embedart`: Embed album art images into files' metadata.
* :doc:`replaygain`: Calculate volume normalization for players that support it.

22
docs/plugins/mbsync.rst Normal file
View file

@ -0,0 +1,22 @@
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.
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.
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.