mirror of
https://github.com/beetbox/beets.git
synced 2025-12-07 17:16:07 +01:00
aa31fea037
*All* URLs were checked manually, but only once per domain! I mostly concerned myself with URLs in documentation rather than source code because the latter may or may not have impactful changes, while the former should be straight forward. Changes in addition to simply adding an s: - changed pip and pypi references as their location has changed - MPoD (iOS app) url redirects to Regelian, so I replaced those - updated homebrew references Notable observations: - beets.io does have HTTPS set up properly (via gh-pages) - beatport.py uses the old HTTP url for beatport - as does lyrics.py for lyrics.wikia.com - https://tomahawk-player.org/ expired long ago, but the http page redirects to https regardless - none of the sourceforge subdomains have https (in 2019!)
42 lines
1.4 KiB
ReStructuredText
42 lines
1.4 KiB
ReStructuredText
MusicBrainz Collection Plugin
|
|
=============================
|
|
|
|
The ``mbcollection`` plugin lets you submit your catalog to MusicBrainz to
|
|
maintain your `music collection`_ list there.
|
|
|
|
.. _music collection: https://musicbrainz.org/doc/Collections
|
|
|
|
To begin, just enable the ``mbcollection`` plugin in your
|
|
configuration (see :ref:`using-plugins`).
|
|
Then, add your MusicBrainz username and password to your
|
|
:doc:`configuration file </reference/config>` under a ``musicbrainz`` section::
|
|
|
|
musicbrainz:
|
|
user: you
|
|
pass: seekrit
|
|
|
|
Then, use the ``beet mbupdate`` command to send your albums to MusicBrainz. The
|
|
command automatically adds all of your albums to the first collection it finds.
|
|
If you don't have a MusicBrainz collection yet, you may need to add one to your
|
|
profile first.
|
|
|
|
The command has one command-line option:
|
|
|
|
* To remove albums from the collection which are no longer present in
|
|
the beets database, use the ``-r`` (``--remove``) flag.
|
|
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
To configure the plugin, make a ``mbcollection:`` section in your
|
|
configuration file. There is one option available:
|
|
|
|
- **auto**: Automatically amend your MusicBrainz collection whenever you
|
|
import a new album.
|
|
Default: ``no``.
|
|
- **collection**: Which MusicBrainz collection to update.
|
|
Default: ``None``.
|
|
- **remove**: Remove albums from collections which are no longer
|
|
present in the beets database.
|
|
Default: ``None``.
|