mirror of
https://github.com/beetbox/beets.git
synced 2026-03-19 11:54:47 +01:00
docs: Document match.distance_weights in autotagger config (#6398)
Add documentation for the `match.distance_weights` configuration option in the autotagger matching section of the reference docs. The section includes: - Description of what distance weights control - Complete list of all available fields with their default values - Example showing how to customize a specific weight - Note that only overridden fields need to be specified Closes #6081
This commit is contained in:
commit
53119fc581
1 changed files with 49 additions and 0 deletions
|
|
@ -913,6 +913,55 @@ and the next-best match is above the *gap* threshold, the importer will suggest
|
|||
that match but not automatically confirm it. Otherwise, you'll see a list of
|
||||
options to choose from.
|
||||
|
||||
.. _distance-weights:
|
||||
|
||||
distance_weights
|
||||
~~~~~~~~~~~~~~~~
|
||||
|
||||
The ``distance_weights`` option allows you to customize how much each field
|
||||
contributes to the overall distance score when matching albums and tracks.
|
||||
Higher weights mean that differences in that field are penalized more heavily,
|
||||
making them more important in the matching decision.
|
||||
|
||||
The defaults are:
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
match:
|
||||
distance_weights:
|
||||
data_source: 2.0
|
||||
artist: 3.0
|
||||
album: 3.0
|
||||
media: 1.0
|
||||
mediums: 1.0
|
||||
year: 1.0
|
||||
country: 0.5
|
||||
label: 0.5
|
||||
catalognum: 0.5
|
||||
albumdisambig: 0.5
|
||||
album_id: 5.0
|
||||
tracks: 2.0
|
||||
missing_tracks: 0.9
|
||||
unmatched_tracks: 0.6
|
||||
track_title: 3.0
|
||||
track_artist: 2.0
|
||||
track_index: 1.0
|
||||
track_length: 2.0
|
||||
track_id: 5.0
|
||||
medium: 1.0
|
||||
|
||||
For example, if you don't care as much about matching the exact release year,
|
||||
you can reduce its weight:
|
||||
|
||||
.. code-block:: yaml
|
||||
|
||||
match:
|
||||
distance_weights:
|
||||
year: 0.1
|
||||
|
||||
You only need to specify the fields you want to override; unspecified fields
|
||||
keep their default weights.
|
||||
|
||||
.. _max_rec:
|
||||
|
||||
max_rec
|
||||
|
|
|
|||
Loading…
Reference in a new issue