Chromaprint | AcoustID (original) (raw)

Chromaprint is the core component of the AcoustID project. It's a client-side library that implements a custom algorithm for extracting fingerprints from any audio source. Overview of the fingerprint extraction process can be found in the blog post "How does Chromaprint work?".

Download

Latest release — 1.5.1 (2021-12-23)

Most Linux distributions also have their own packages for Chromaprint.

You can find downloads for older releases on GitHub.

Usage

The library exposes a simple C API. The documentation for the C API can be found in chromaprint.h.

Note that the library only calculates audio fingerprints from the provided raw uncompressed audio data. It does not deal with audio file formats in any way. Your application needs to find a way to decode audio files (MP3, MP4, FLAC, etc.) and feed the uncompressed data to Chromaprint.

You can use pyacoustid to interact with the library from Python. It provides a direct wrapper around the library, but also higher-level functions for generating fingerprints from audio files.

You can also use the fpcalc utility programatically. It can produce JSON output, which should be easy to parse in any language. This is the recommended way to use Chromaprint if all you need is generate fingerprints for AcoustID.

Development

You can dowload the development version of the source code from GitHub. Either you can use Git to clone the repository or download a zip/tar.gz file with the latest version.

You will need a C++ compiler and CMake to build the library. FFmpeg is required to build the fpcalc tool.

$ git clone https://github.com/acoustid/chromaprint.git
$ cd chromaprint
$ cmake .
$ make

See the README file for more details on building the library.