Skip to content

Commit 2ec7b44

Browse files
committed
Add musicbrainz to plugins docs
1 parent 9f7e615 commit 2ec7b44

File tree

1 file changed

+26
-13
lines changed

1 file changed

+26
-13
lines changed

docs/plugins/index.rst

Lines changed: 26 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,19 @@ Using Plugins
1313
-------------
1414

1515
To use one of the plugins included with beets (see the rest of this page for a
16-
list), just use the ``plugins`` option in your :doc:`config.yaml </reference/config>` file, like so::
16+
list), just use the ``plugins`` option in your :doc:`config.yaml </reference/config>` file:
17+
18+
.. code-block:: sh
1719
1820
plugins: inline convert web
1921
2022
The value for ``plugins`` can be a space-separated list of plugin names or a
2123
YAML list like ``[foo, bar]``. You can see which plugins are currently enabled
2224
by typing ``beet version``.
2325

24-
Each plugin has its own set of options that can be defined in a section bearing its name::
26+
Each plugin has its own set of options that can be defined in a section bearing its name:
27+
28+
.. code-block:: yaml
2529
2630
plugins: inline convert web
2731
@@ -30,10 +34,11 @@ Each plugin has its own set of options that can be defined in a section bearing
3034
3135
Some plugins have special dependencies that you'll need to install. The
3236
documentation page for each plugin will list them in the setup instructions.
33-
For some, you can use ``pip``'s "extras" feature to install the dependencies,
34-
like this::
37+
For some, you can use ``pip``'s "extras" feature to install the dependencies:
3538

36-
pip install beets[fetchart,lyrics,lastgenre]
39+
.. code-block:: sh
40+
41+
pip install "beets[fetchart,lyrics,lastgenre]"
3742
3843
.. _metadata-source-plugin-configuration:
3944

@@ -48,7 +53,9 @@ plugins share the following configuration option:
4853
Default: ``0.5``.
4954

5055
For example, to equally consider matches from Discogs and MusicBrainz add the
51-
following to your configuration::
56+
following to your configuration:
57+
58+
.. code-block:: yaml
5259
5360
plugins: discogs
5461
@@ -111,6 +118,7 @@ following to your configuration::
111118
missing
112119
mpdstats
113120
mpdupdate
121+
musicbrainz
114122
parentwork
115123
permissions
116124
play
@@ -142,21 +150,26 @@ Autotagger Extensions
142150
Use acoustic fingerprinting to identify audio files with
143151
missing or incorrect metadata.
144152

153+
:doc:`deezer <deezer>`
154+
Search for releases in the `Deezer`_ database.
155+
145156
:doc:`discogs <discogs>`
146157
Search for releases in the `Discogs`_ database.
147158

159+
:doc:`fromfilename <fromfilename>`
160+
Guess metadata for untagged tracks from their filenames.
161+
162+
:doc:`musicbrainz <musicbrainz>`
163+
Search for releases in the `MusicBrainz`_ database.
164+
148165
:doc:`spotify <spotify>`
149166
Search for releases in the `Spotify`_ database.
150167

151-
:doc:`deezer <deezer>`
152-
Search for releases in the `Deezer`_ database.
153-
154-
:doc:`fromfilename <fromfilename>`
155-
Guess metadata for untagged tracks from their filenames.
156168

157-
.. _Discogs: https://www.discogs.com/
169+
.. _Deezer: https://www.deezer.com
170+
.. _Discogs: https://www.discogs.com
171+
.. _MusicBrainz: https://www.musicbrainz.com
158172
.. _Spotify: https://www.spotify.com
159-
.. _Deezer: https://www.deezer.com/
160173

161174
Metadata
162175
--------

0 commit comments

Comments
 (0)