/music-timbre — Timbre & Spectral Analysis

Extract timbral and spectral characteristics: MFCC coefficients, spectral centroid/bandwidth/rolloff, loudness (LUFS), dynamic range, brightness, warmth, and optionally separate audio sources.

Usage

/music-timbre <audio_file_path>

Steps

• Validate the audio file path

• Run timbre analysis:

python3 -m music_analyzer timbre "<audio_file_path>"

Add --no-separation to skip Demucs source separation.

• Present results:

• Brightness: Score 0-1 (higher = brighter timbre)

• Warmth: Score 0-1 (higher = more low-frequency energy)

• Dynamic Range: Estimated in dB

• Loudness: LUFS (if pyloudnorm available)

• MFCC Summary: 13-coefficient means

• Stems: Paths to separated vocals/drums/bass/other (if demucs ran)

Output Fields

Field Description

mfcc

MFCC means and stds

spectral

Centroid, bandwidth, rolloff, ZCR

loudness_lufs

Integrated loudness in LUFS

dynamic_range_db

Dynamic range in dB

brightness

Brightness score 0-1

warmth

Warmth score 0-1

stems

Separated stem file paths (if available)