From b42ce3e0ca0c8d1668f934a96ac7c9ce1d78440a Mon Sep 17 00:00:00 2001
From: nick2000713 <nick2000713@users.noreply.github.com>
Date: Tue, 23 Jun 2026 12:57:00 +0200
Subject: [PATCH] docs(acoustid): strengthen require_verified warning about
 false-quarantine risk
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

AcoustID 'could not confirm' (SKIP) is common for legitimate tracks not in its
fingerprint DB (new/obscure releases, classical, remixes, live, remasters,
non-Latin-script titles). Make the require_verified help text explicit that
turning it on quarantines all of those, so users expect manual review/approval
rather than discovering a flooded quarantine folder. Reinforces that the safer
default (off → import with the unverified badge) loses nothing and blocks nothing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 webui/index.html | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/webui/index.html b/webui/index.html
index 9023a52e..e22748f2 100644
--- a/webui/index.html
+++ b/webui/index.html
@@ -5126,12 +5126,21 @@
                                         Only import AcoustID-verified tracks (reject "could not confirm")
                                     </label>
                                     <div class="help-text" style="margin-top:4px">
-                                        When <strong>on</strong>, a download that AcoustID runs but <em>cannot confirm</em>
+                                        When <strong>on</strong>, a track that AcoustID runs but <em>cannot confirm</em>
                                         (no fingerprint match / cross-script metadata — the ⚠ "unverified" case) is
-                                        <strong>quarantined and the next candidate is tried</strong>, instead of being
-                                        imported as unverified. Only a clean AcoustID <strong>pass</strong> is kept.
-                                        Transient lookup errors (rate-limit / outage) still import, so an AcoustID outage
-                                        never stalls your downloads. Requires AcoustID to be enabled.
+                                        <strong>quarantined</strong> instead of imported. Downloads then try the next
+                                        candidate; imports just quarantine (no candidate to retry). Only a clean AcoustID
+                                        <strong>pass</strong> is kept.
+                                        <br><br>
+                                        ⚠️ <strong>Use with care.</strong> AcoustID "could not confirm" is <em>common</em>
+                                        for perfectly good tracks — anything not in its fingerprint database: new/obscure
+                                        releases, classical, remixes, live cuts, remasters, non-Latin-script titles. With
+                                        this on, <strong>all of those get quarantined</strong>, so you may end up with many
+                                        legitimate files to review and approve by hand. Nothing is lost (quarantined files
+                                        can be approved), but expect manual cleanup. Leave this <strong>off</strong> to keep
+                                        the safer default: unconfirmed tracks import with the ⚠ "unverified" badge so you can
+                                        review them without anything being blocked. Transient lookup errors (rate-limit /
+                                        outage) always import, so an AcoustID outage never stalls you. Requires AcoustID enabled.
                                     </div>
                                 </div>