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

Merge pull request #3116 from RollingStar/patch-1

Browse source 
More details on self-hosting musicbrainz
This commit is contained in:
Adrian Sampson 2019-01-12 14:17:12 -08:00
commit 22e90b519c
1 changed files with 9 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
docs/reference/config.rst
View file

@ -654,8 +654,8 @@ Default: ``{}`` (empty).
MusicBrainz Options
-------------------
If you run your own `MusicBrainz`_ server, you can instruct beets to use it
instead of the main server. Use the ``host`` and ``ratelimit`` options under a
You can instruct beets to use `your own`_ MusicBrainz database instead of
the `main server`_. Use the ``host`` and ``ratelimit`` options under a
``musicbrainz:`` header, like so::
musicbrainz:
@ -663,14 +663,18 @@ instead of the main server. Use the ``host`` and ``ratelimit`` options under a
ratelimit: 100
The ``host`` key, of course, controls the Web server hostname (and port,
optionally) that will be contacted by beets (default: musicbrainz.org). The
``ratelimit`` option, an integer, controls the number of Web service requests
optionally) that will be contacted by beets (default: musicbrainz.org).
The ``host`` must have search indexes enabled -- see "Building search indexes"
in the server setup guide linked above.
The ``ratelimit`` option, an integer, controls the number of Web service requests
per second (default: 1). **Do not change the rate limit setting** if you're
using the main MusicBrainz server---on this public server, you're `limited`_
to one request per second.
.. _your own: https://musicbrainz.org/doc/MusicBrainz_Server/Setup
.. _main server: https://musicbrainz.org/
.. _limited: http://musicbrainz.org/doc/XML_Web_Service/Rate_Limiting
.. _MusicBrainz: http://musicbrainz.org/
.. _searchlimit: