[GSoC] CMRT 03: Preferences: Add Fingerprint Analysis preferences page and clear actions

CMakeLists.txt

@@ -1174,6 +1174,7 @@ add_library(
   STATIC
   EXCLUDE_FROM_ALL
   src/analyzer/analyzerbeats.cpp
+  src/analyzer/analyzerchromaprint.cpp
   src/analyzer/analyzerebur128.cpp
   src/analyzer/analyzergain.cpp
   src/analyzer/analyzerkey.cpp
@@ -1414,6 +1415,7 @@ add_library(
   src/library/dao/settingsdao.cpp
   src/library/dao/trackdao.cpp
   src/library/dao/trackschema.cpp
+  src/library/dao/trackfingerprintdao.cpp
   src/library/tabledelegates/defaultdelegate.cpp
   src/library/dlgcoverartfullsize.cpp
   src/library/dlgcoverartfullsize.ui
@@ -1548,6 +1550,8 @@ add_library(
   src/preferences/dialog/dlgpreferencepage.cpp
   src/preferences/dialog/dlgpreferences.cpp
   src/preferences/dialog/dlgpreferencesdlg.ui
+  src/preferences/dialog/dlgpreffingerprint.cpp
+  src/preferences/dialog/dlgpreffingerprint.ui
   src/preferences/dialog/dlgprefinterface.cpp
   src/preferences/dialog/dlgprefinterfacedlg.ui
   src/preferences/dialog/dlgprefkey.cpp

res/schema.xml

@@ -593,4 +593,175 @@ reapplying those migrations.
       ALTER TABLE library ADD COLUMN tuning_frequency_hz FLOAT DEFAULT 0.0;
     </sql>
   </revision>
+  <revision version="41" min_compatible="3">
+    <description>
+      Add MusicBrainz and AcoustID metadata columns to the library table
+      to support Chromaprint-based audio fingerprinting and AcoustID lookup.
+    </description>
+    <sql>
+      ALTER TABLE library ADD COLUMN musicbrainz_recording_id varchar(64);
+      ALTER TABLE library ADD COLUMN musicbrainz_release_id varchar(64);
+      ALTER TABLE library ADD COLUMN musicbrainz_track_id varchar(64);
+      ALTER TABLE library ADD COLUMN musicbrainz_artist_id varchar(64);
+      ALTER TABLE library ADD COLUMN acoustid_id varchar(64);
+      ALTER TABLE library ADD COLUMN acoustid_lookup_at INTEGER;
+      <!-- acoustid_lookup_status values: 'pending' | 'completed' | 'failed' -->
+      ALTER TABLE library ADD COLUMN acoustid_lookup_status varchar(16);
+
+      CREATE INDEX IF NOT EXISTS idx_library_mbid ON library (
+          musicbrainz_recording_id
+      );
+      CREATE INDEX IF NOT EXISTS idx_library_acoustid ON library (
+          acoustid_id
+      );
+      CREATE INDEX IF NOT EXISTS idx_library_mbid_artist ON library (
+          musicbrainz_artist_id
+      );
+    </sql>
+  </revision>
+  <revision version="42" min_compatible="3">
+    <description>
+      Add data_text column to track_analysis table for small text payloads
+      such as audio quality metrics and Chromaprint version metadata.
+      Raw fingerprint arrays are never stored in the database.
+    </description>
+    <sql>
+      ALTER TABLE track_analysis ADD COLUMN data_text TEXT;
+
+      CREATE INDEX IF NOT EXISTS idx_track_analysis_lookup ON track_analysis (
+          track_id,
+          type
+      );
+    </sql>
+  </revision>
+  <revision version="43" min_compatible="3">
+    <description>
+      Add Chromaprint fingerprint tables: fingerprint_metadata stores the
+      32-bit SimHash pre-filter and CMRT group linkage per track; cmrt_groups
+      holds one record per unique audio recording; cmrt_members is the
+      track-to-group bridge table; acoustid_queue manages background AcoustID
+      API submissions; acoustid_cache avoids redundant API round-trips.
+      Raw fingerprint data is stored as separate .chroma files on disk,
+      never as BLOBs in the database.
+    </description>
+    <sql>
+      <!-- fingerprint_hash is a 32-bit SimHash used as a non-unique pre-filter.
+           Full binary XOR/popcount comparison of .chroma files is required
+           before assigning a track to a CMRT group. See design notes. -->
+      CREATE TABLE IF NOT EXISTS fingerprint_metadata (
+        track_id INTEGER NOT NULL,
+        <!-- 32-bit SimHash — non-unique, multiple tracks share the same value -->
+        fingerprint_hash INTEGER NOT NULL,
+        <!-- SHA-256 hex of .chroma file — non-unique here; exact copies share it -->
+        chroma_sha256 varchar(64) NOT NULL,
+        fingerprint_duration REAL,
+        fingerprint_version INTEGER,
+        cmrt_group_id INTEGER,
+        cmrt_offset_seconds REAL DEFAULT 0,
+        is_canonical INTEGER DEFAULT 0,
+        fingerprint_valid INTEGER DEFAULT 1,
+        fingerprint_needs_regen INTEGER DEFAULT 0,
+        computed_at INTEGER NOT NULL,
+        PRIMARY KEY (track_id));
+
+      <!-- chroma_sha256 is UNIQUE here: each group has exactly one canonical
+           audio identity. Two groups cannot share the same SHA-256. -->
+      CREATE TABLE IF NOT EXISTS cmrt_groups (
+        group_id INTEGER NOT NULL,
+        fingerprint_hash INTEGER NOT NULL,
+        chroma_sha256 varchar(64) NOT NULL,
+        canonical_track_id INTEGER NOT NULL,
+        track_count INTEGER DEFAULT 1,
+        created_at INTEGER NOT NULL,
+        last_updated INTEGER,
+        musicbrainz_cmrt_mbid varchar(64),
+        musicbrainz_synced INTEGER DEFAULT 0,
+        musicbrainz_last_sync INTEGER,
+        musicbrainz_community_score REAL,
+        musicbrainz_submitted INTEGER DEFAULT 0,
+        musicbrainz_submission_mbid varchar(64),
+        local_preferred INTEGER DEFAULT 1,
+        conflict_resolved_at INTEGER,
+        <!-- conflict_resolution values: 'local_won' | 'remote_won' -->
+        conflict_resolution varchar(16),
+        PRIMARY KEY (group_id));
+
+      <!-- UNIQUE (track_id) enforces each track belongs to exactly one group -->
+      CREATE TABLE IF NOT EXISTS cmrt_members (
+        member_id INTEGER NOT NULL,
+        group_id INTEGER NOT NULL,
+        track_id INTEGER NOT NULL,
+        offset_from_canonical REAL DEFAULT 0,
+        quality_score REAL,
+        match_score REAL,
+        is_fake_lossless INTEGER DEFAULT 0,
+        added_at INTEGER NOT NULL,
+        user_quality_rating INTEGER,
+        PRIMARY KEY (member_id),
+        UNIQUE (track_id));
+
+      <!-- status values: 'queued' | 'processing' | 'completed' | 'failed' -->
+      CREATE TABLE IF NOT EXISTS acoustid_queue (
+        queue_id INTEGER NOT NULL,
+        track_id INTEGER NOT NULL,
+        priority INTEGER DEFAULT 5,
+        status varchar(16) DEFAULT 'queued',
+        attempts INTEGER DEFAULT 0,
+        max_attempts INTEGER DEFAULT 3,
+        last_attempt INTEGER,
+        error_message TEXT,
+        queued_at INTEGER NOT NULL,
+        PRIMARY KEY (queue_id),
+        UNIQUE (track_id));
+
+      <!-- keyed on chroma_sha256 (SHA-256), not fingerprint_hash (SimHash),
+           to avoid Birthday Paradox false cache hits -->
+      CREATE TABLE IF NOT EXISTS acoustid_cache (
+        chroma_sha256 varchar(64) NOT NULL,
+        acoustid_id varchar(64) NOT NULL,
+        musicbrainz_recording_id varchar(64),
+        musicbrainz_release_id varchar(64),
+        musicbrainz_metadata TEXT,
+        confidence REAL,
+        lookup_timestamp INTEGER NOT NULL,
+        expires_at INTEGER,
+        PRIMARY KEY (chroma_sha256));
+
+      CREATE INDEX IF NOT EXISTS idx_fm_hash ON fingerprint_metadata (
+          fingerprint_hash
+      );
+      CREATE INDEX IF NOT EXISTS idx_fm_sha ON fingerprint_metadata (
+          chroma_sha256
+      );
+      CREATE INDEX IF NOT EXISTS idx_fm_group ON fingerprint_metadata (
+          cmrt_group_id
+      );
+      CREATE INDEX IF NOT EXISTS idx_fm_canonical ON fingerprint_metadata (
+          is_canonical
+      );
+      CREATE INDEX IF NOT EXISTS idx_cg_hash ON cmrt_groups (
+          fingerprint_hash
+      );
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_cg_sha ON cmrt_groups (
+          chroma_sha256
+      );
+      CREATE INDEX IF NOT EXISTS idx_cg_mbid ON cmrt_groups (
+          musicbrainz_cmrt_mbid
+      );
+      CREATE INDEX IF NOT EXISTS idx_cm_group ON cmrt_members (
+          group_id
+      );
+      CREATE INDEX IF NOT EXISTS idx_cm_track ON cmrt_members (
+          track_id
+      );
+      CREATE INDEX IF NOT EXISTS idx_aq_status ON acoustid_queue (
+          status,
+          priority,
+          queued_at
+      );
+      CREATE INDEX IF NOT EXISTS idx_ac_mbid ON acoustid_cache (
+          musicbrainz_recording_id
+      );
+    </sql>
+  </revision>
 </schema>