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

Add musicbrainz to plugins docs

Browse source
This commit is contained in:
Šarūnas Nejus 2025-04-22 13:33:04 +01:00
parent e981fb1aea
commit 3f1d117078
No known key found for this signature in database
GPG key ID: DD28F6704DBE3435
1 changed files with 27 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
docs/plugins/index.rst
View file

@ -13,7 +13,9 @@ Using Plugins
-------------
To use one of the plugins included with beets (see the rest of this page for a
list), just use the ``plugins`` option in your :doc:`config.yaml </reference/config>` file, like so::
list), just use the ``plugins`` option in your :doc:`config.yaml </reference/config>` file:
.. code-block:: sh
plugins: inline convert web
@ -21,7 +23,9 @@ The value for ``plugins`` can be a space-separated list of plugin names or a
YAML list like ``[foo, bar]``. You can see which plugins are currently enabled
by typing ``beet version``.
Each plugin has its own set of options that can be defined in a section bearing its name::
Each plugin has its own set of options that can be defined in a section bearing its name:
.. code-block:: yaml
plugins: inline convert web
@ -30,10 +34,11 @@ Each plugin has its own set of options that can be defined in a section bearing
Some plugins have special dependencies that you'll need to install. The
documentation page for each plugin will list them in the setup instructions.
For some, you can use ``pip``'s "extras" feature to install the dependencies,
like this::
For some, you can use ``pip``'s "extras" feature to install the dependencies:
pip install beets[fetchart,lyrics,lastgenre]
.. code-block:: sh
pip install "beets[fetchart,lyrics,lastgenre]"
.. _metadata-source-plugin-configuration:
@ -48,7 +53,9 @@ plugins share the following configuration option:
Default: ``0.5``.
For example, to equally consider matches from Discogs and MusicBrainz add the
following to your configuration::
following to your configuration:
.. code-block:: yaml
plugins: discogs
@ -111,6 +118,7 @@ following to your configuration::
missing
mpdstats
mpdupdate
musicbrainz
parentwork
permissions
play
@ -142,21 +150,26 @@ Autotagger Extensions
Use acoustic fingerprinting to identify audio files with
missing or incorrect metadata.
:doc:`discogs <discogs>`
Search for releases in the `Discogs`_ database.
:doc:`spotify <spotify>`
Search for releases in the `Spotify`_ database.
:doc:`deezer <deezer>`
Search for releases in the `Deezer`_ database.
:doc:`discogs <discogs>`
Search for releases in the `Discogs`_ database.
:doc:`fromfilename <fromfilename>`
Guess metadata for untagged tracks from their filenames.
.. _Discogs: https://www.discogs.com/
:doc:`musicbrainz <musicbrainz>`
Search for releases in the `MusicBrainz`_ database.
:doc:`spotify <spotify>`
Search for releases in the `Spotify`_ database.
.. _Deezer: https://www.deezer.com
.. _Discogs: https://www.discogs.com
.. _MusicBrainz: https://www.musicbrainz.com
.. _Spotify: https://www.spotify.com
.. _Deezer: https://www.deezer.com/
Metadata
--------