From a40bd7ca3c21a174b4071aa8bbd017040c02a091 Mon Sep 17 00:00:00 2001 From: edvatar <88481784+toroleapinc@users.noreply.github.com> Date: Fri, 27 Feb 2026 11:40:44 -0500 Subject: [PATCH 1/3] docs: Document match.distance_weights in autotagger docs Add documentation for the distance_weights configuration option in the autotagger matching section. This includes all available fields with their default values and an example of how to customize them. Closes #6081 Signed-off-by: edvatar <88481784+toroleapinc@users.noreply.github.com> --- docs/reference/config.rst | 45 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/docs/reference/config.rst b/docs/reference/config.rst index fc0de37a7..54a03042e 100644 --- a/docs/reference/config.rst +++ b/docs/reference/config.rst @@ -913,6 +913,51 @@ 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:: + + 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:: + + 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 From dd1bda4bd0c8e2bbe64f2dcbffc63794ad0b70ec Mon Sep 17 00:00:00 2001 From: Serene-Arc <33189705+Serene-Arc@users.noreply.github.com> Date: Sun, 1 Mar 2026 18:01:18 +1000 Subject: [PATCH 2/3] Format docs --- docs/reference/config.rst | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/reference/config.rst b/docs/reference/config.rst index 54a03042e..162b35770 100644 --- a/docs/reference/config.rst +++ b/docs/reference/config.rst @@ -919,11 +919,13 @@ 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. +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:: +The defaults are: + +:: match: distance_weights: @@ -949,7 +951,9 @@ The defaults are:: medium: 1.0 For example, if you don't care as much about matching the exact release year, -you can reduce its weight:: +you can reduce its weight: + +:: match: distance_weights: From aa8123233644c1dd0ecb28b6249f21fe4b7b533c Mon Sep 17 00:00:00 2001 From: Serene <33189705+Serene-Arc@users.noreply.github.com> Date: Sun, 1 Mar 2026 21:10:49 +1000 Subject: [PATCH 3/3] Use proper syntax highlighting for code block MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Šarūnas Nejus --- docs/reference/config.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/config.rst b/docs/reference/config.rst index 162b35770..4326a80a1 100644 --- a/docs/reference/config.rst +++ b/docs/reference/config.rst @@ -925,7 +925,7 @@ making them more important in the matching decision. The defaults are: -:: +.. code-block:: yaml match: distance_weights: @@ -953,7 +953,7 @@ The defaults are: 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: