mirror of
https://github.com/beetbox/beets.git
synced 2025-12-08 01:23:09 +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!)
54 lines
2.4 KiB
ReStructuredText
54 lines
2.4 KiB
ReStructuredText
MusicBrainz Submit Plugin
|
||
=========================
|
||
|
||
The ``mbsubmit`` plugin provides an extra prompt choice during an import
|
||
session that prints the tracks of the current album in a format that is
|
||
parseable by MusicBrainz's `track parser`_.
|
||
|
||
.. _track parser: https://wiki.musicbrainz.org/History:How_To_Parse_Track_Listings
|
||
|
||
Usage
|
||
-----
|
||
|
||
Enable the ``mbsubmit`` plugin in your configuration (see :ref:`using-plugins`)
|
||
and select the ``Print tracks`` choice which is by default displayed when no
|
||
strong recommendations are found for the album::
|
||
|
||
No matching release found for 3 tracks.
|
||
For help, see: https://beets.readthedocs.org/en/latest/faq.html#nomatch
|
||
[U]se as-is, as Tracks, Group albums, Skip, Enter search, enter Id, aBort,
|
||
Print tracks? p
|
||
01. An Obscure Track - An Obscure Artist (3:37)
|
||
02. Another Obscure Track - An Obscure Artist (2:05)
|
||
03. The Third Track - Another Obscure Artist (3:02)
|
||
|
||
No matching release found for 3 tracks.
|
||
For help, see: https://beets.readthedocs.org/en/latest/faq.html#nomatch
|
||
[U]se as-is, as Tracks, Group albums, Skip, Enter search, enter Id, aBort,
|
||
Print tracks?
|
||
|
||
As MusicBrainz currently does not support submitting albums programmatically,
|
||
the recommended workflow is to copy the output of the ``Print tracks`` choice
|
||
and paste it into the parser that can be found by clicking on the
|
||
"Track Parser" button on MusicBrainz "Tracklist" tab.
|
||
|
||
Configuration
|
||
-------------
|
||
|
||
To configure the plugin, make a ``mbsubmit:`` section in your configuration
|
||
file. The following options are available:
|
||
|
||
- **format**: The format used for printing the tracks, defined using the
|
||
same template syntax as beets’ :doc:`path formats </reference/pathformat>`.
|
||
Default: ``$track. $title - $artist ($length)``.
|
||
- **threshold**: The minimum strength of the autotagger recommendation that
|
||
will cause the ``Print tracks`` choice to be displayed on the prompt.
|
||
Default: ``medium`` (causing the choice to be displayed for all albums that
|
||
have a recommendation of medium strength or lower). Valid values: ``none``,
|
||
``low``, ``medium``, ``strong``.
|
||
|
||
Please note that some values of the ``threshold`` configuration option might
|
||
require other ``beets`` command line switches to be enabled in order to work as
|
||
intended. In particular, setting a threshold of ``strong`` will only display
|
||
the prompt if ``timid`` mode is enabled. You can find more information about
|
||
how the recommendation system works at :ref:`match-config`.
|