Getting Started

libsonare is a C++17 audio analysis library for music information retrieval (MIR).

Features

• BPM Detection - Accurate tempo estimation using tempogram and autocorrelation
• Key Detection - Musical key detection using Krumhansl-Schmuckler algorithm
• Beat Tracking - Dynamic programming-based beat extraction
• Chord Recognition - Template matching with 108 chord types
• Section Detection - Structural segmentation (Intro, Verse, Chorus, etc.)
• Melody / Pitch Tracking - YIN and pYIN algorithms for F0 detection
• Audio Characteristics - Timbre, dynamics, rhythm analysis
• Spectral Features - Mel spectrogram, MFCC, chroma, CQT/VQT, spectral centroid/flatness
• Audio Effects - HPSS, time stretch, pitch shift, normalize, trim
• Streaming Analysis - Real-time chunk-by-chunk processing with progressive BPM/key/chord estimation

Quick Start

Browser (WebAssembly)

import { init, analyze } from '@libraz/libsonare';

// Initialize the WASM module
await init();

// Analyze audio samples
const result = analyze(samples, sampleRate);

console.log('BPM:', result.bpm);
console.log('Key:', result.key.name);
console.log('Chords:', result.chords);

Python

pip install libsonare

from libsonare import Audio

audio = Audio.from_file("music.mp3")
result = audio.analyze()

print(f"BPM: {result.bpm}")
print(f"Key: {result.key}")
print(f"Beats: {len(result.beat_times)}")

See Native Bindings for the full Python and Node.js API reference.

CLI

The sonare command is included when you install via pip:

pip install libsonare
sonare analyze music.mp3
sonare bpm music.mp3
sonare key music.mp3

See CLI Reference for all available commands.

Try It Now

Visit the Demo to try libsonare in your browser. Simply drag and drop an audio file to see the analysis results.