Chromaprint AcoustID

acoustid audio audio-analysis audio-fingerprinting audio-processing chromaprint

Use this command to install Chromaprint:

winget install --id=AcoustID.Chromaprint -e

C library for generating audio fingerprints used by AcoustID

Chromaprint is a C library designed to generate audio fingerprints, enabling precise identification of audio content. It serves as a core component for systems like AcoustID, which rely on robust audio recognition capabilities.

Key Features:

High-performance audio fingerprint generation optimized for accuracy and efficiency.
Cross-platform compatibility, supporting various operating systems and use cases.
Integration with other tools and services, making it versatile for music identification, multimedia applications, and more.

Audience & Benefit:
Ideal for developers and researchers working on audio recognition solutions, Chromaprint provides a reliable foundation for building accurate and scalable fingerprinting systems without reinventing the wheel. Its efficient implementation allows for quick integration into existing projects while maintaining high performance standards.

Chromaprint can be installed via winget, ensuring seamless setup across supported environments.

Chromaprint

Chromaprint is an audio fingerprint library developed for the AcoustID project. It's designed to identify near-identical audio and the fingerprints it generates are as compact as possible to achieve that. It's not a general purpose audio fingerprinting solution. It trades precision and robustness for search performance. The target use cases are full audio file identifcation, duplicate audio file detection and long audio stream monitoring.

Building

The most common way to build Chromaprint is like this:

$ cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_TOOLS=ON .
$ make
$ sudo make install

This will build Chromaprint as a shared library and also include the fpcalc utility (which is used by MusicBrainz Picard, for example). For this to work, you will need to have the FFmpeg libraries installed.

See below for other options.

FFT Library

Chromaprint can use multiple FFT libraries -- FFmpeg, FFTW3, KissFFT or vDSP (macOS).

FFmpeg is preferred on all systems except for macOS, where you should use the standard vDSP framework. These are the fastest options.

FFTW3 can be also used, but this library is released under the GPL license, which makes also the resulting Chromaprint binary GPL licensed.

KissFFT is the slowest option, but it's distributed with a permissive license and it's very easy to build on platforms that do not have packaged versions of FFmpeg or FFTW3. We ship a copy of KissFFT, so if the build system is unable to find another FFT library it will use that as a fallback.

You can explicitly set which library to use with the FFT_LIB option. For example:

$ cmake -DFFT_LIB=kissfft .

FFmpeg

FFmpeg is as a FFT library and also for audio decoding and resampling in fpcalc. If you have FFmpeg installed in a non-standard location, you can use the FFMPEG_ROOT option to specify where:

$ cmake -DFFMPEG_ROOT=/path/to/local/ffmpeg/install .

While we try to make sure things work also with libav, FFmpeg is preferred.

API Documentation

You can use Doxygen to generate a HTML version of the API documentation:

$ make docs
$ $BROWSER docs/html/index.html

Unit Tests

The test suite can be built and run using the following commands: