File Hashes Miss Audio Identity
The same recording changes bytes when it is transcoded, retagged, renamed, or wrapped in a new container. Cryptographic hashes then treat one song as unrelated files.
audiocatalog invokes the proven fpcalc binary, stores duration and raw Chromaprint fingerprints in SQLite, gates implausible duration pairs, and ranks likely acoustic duplicates.
Keep The Library Local
Directory indexing and matching run without uploading music or requiring an API key. The CLI handles real files while the API and workbench expose the comparison contract for inspection.
The Demo
Four catalog entries produce six pair comparisons. Exactly one pair crosses the threshold: differently named WAV and MP3 exports of the same recording at 98.65% similarity.
Chromaprint is optimized for near-identical audio, not general cover-song, remix, or sample detection. Every candidate remains a review decision.
Implementation Basis
The project builds on the open-source Chromaprint acoustic fingerprinting algorithm and its fpcalc command-line implementation.
Read the Chromaprint.