5 unstable releases
0.3.0 | Oct 26, 2024 |
---|---|
0.2.0 | Feb 2, 2024 |
0.1.3 | Mar 12, 2023 |
0.1.1 | Jul 23, 2022 |
#63 in Audio
2,115 downloads per month
Used in 4 crates
(via czkawka_core)
110KB
3K
SLoC
rusty-chromaprint
This is an in-progress port of 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 identification, duplicate audio file detection and long audio stream monitoring.
Usage
To calculate a fingerprint for an audio stream simply create a new Fingerprinter
and give it all the audio samples:
use rusty_chromaprint::{Configuration, Fingerprinter};
fn main() {
// Use a preset configuration. This must be always the same for the audio fingerprints
// that are going to be compared against each other.
let mut printer = Fingerprinter::new(&Configuration::preset_test2());
// Sampling rate is set to 44100 and stream has 2 audio channels. It is expected that samples
// are interleaved: in this case left channel samples are placed at even indices
// and right channel - at odd ones.
printer.start(44100, 2).unwrap();
// Process a few samples...
printer.consume(&[-100, -100, -50, -50, 1000, 1000]);
// ... and add some more...
printer.consume(&more_samples);
// Make sure that all the sample are processed.
printer.finish();
// Get the fingerprint.
let fingerprint = printer.fingerprint();
println!("fingerprint = {:08x?}", &fingerprint);
}
For a complete example check out compare
from this repository
which is using Symphonia to decode various audio formats. It compares two files and prints out their common segments
cargo run --release --bin compare -- audio1.mp3 audio2.wav
# | File 1 | File 2 | Duration | Score
-----+--------------------------+--------------------------+------------+---------
1 | 0:00:04.83 -- 0:00:19.44 | 0:00:00.00 -- 0:00:14.61 | 0:00:14.61 | 0.69
For more details on comparing audio fingerprints reach out to the documentation.
Dependencies
~3.5MB
~62K SLoC