How jobicari/hmm-chordtracker works
Chordtracker is an experimental audio chord-recognition system with both offline evaluation and a live listening prototype. The offline workflow prepares annotated songs and audio features, trains acoustic models, decodes frame scores with temporal priors, and evaluates chord labels. The live branch processes incoming audio and presents delayed chord decisions. The README documents multiple model generations and dataset/vocabulary extensions; several are represented by their concrete modules or enclosing directories. Edges are limited to README statements and indexed imports; unsampled runtime wiring is not asserted.
Main entry points: run_v5.py Experiment runner · train_v7_2.py CRNN training · play_along.py Play-along analysis · data_v5.py RWC / GuitarSet data
Components 21
Data and features
- Chord annotations
src/chordtracker/data/data.py - RWC / GuitarSet data
src/chordtracker/data_v5.py - ChoCo data
src/chordtracker/data_choco.py - V6 data
src/chordtracker/data_v6.py - Causal CQT features
src/chordtracker/features_v7_1.py - V7.2 excerpts
src/chordtracker/data_v7_2.py - V8 vocabulary
src/chordtracker/data_v8.py
Models and training
- Experiment runner
scripts/run_v5.py - CNN acoustic model
src/chordtracker/model_v5.py - CRNN acoustic model
src/chordtracker/model_v6.py - V14 model
src/chordtracker/model_v14.py - CRNN training
src/chordtracker/train_v7_2.py
Decoding and evaluation
- Acoustic HMM
src/chordtracker/acoustic_hmm.py - Chord transitions
src/chordtracker/transitions.py - Extended transitions
src/chordtracker/transitions_v8.py - Chord evaluation
src/chordtracker/evaluate.py
Live experience
- Streaming features
src/chordtracker/streaming_features.py - Play-along analysis
src/chordtracker/play_along.py - Live workers
src/chordtracker/live_workers.py - Live demo server
scripts/demo_server.py
Other components
- Musician / audio
Connections 22
- Experiment runner → RWC / GuitarSet data: loads songs
scripts/run_v5.py - RWC / GuitarSet data → Chord annotations: uses annotations
src/chordtracker/data_v5.py - RWC / GuitarSet data → Causal CQT features: uses features
- ChoCo data → RWC / GuitarSet data: reuses data
src/chordtracker/data_choco.py - V7.2 excerpts → V6 data: uses targets
src/chordtracker/data_v7_2.py - V7.2 excerpts → Causal CQT features: computes CQT
src/chordtracker/data_v7_2.py - CRNN training → V7.2 excerpts: builds batches
src/chordtracker/train_v7_2.py - CRNN training → CNN acoustic model: uses model
src/chordtracker/train_v7_2.py - CRNN training → CRNN acoustic model: uses model
src/chordtracker/train_v7_2.py - V8 vocabulary → Chord annotations: maps labels
src/chordtracker/data_v8.py - Experiment runner → CRNN training: trains model
scripts/run_v5.py - Experiment runner → Acoustic HMM: decodes scores
scripts/run_v5.py - Acoustic HMM → Chord transitions: uses transitions
- Extended transitions → V8 vocabulary: uses vocabulary
src/chordtracker/transitions_v8.py - Experiment runner → Chord evaluation: scores results
scripts/run_v5.py - Play-along analysis → Streaming features: processes audio
src/chordtracker/play_along.py - Play-along analysis → V8 vocabulary: maps chords
src/chordtracker/play_along.py - Musician / audio → Live demo server: submits audio
- Live demo server → Live workers: starts workers
scripts/demo_server.py - Live demo server → Play-along analysis: uses analysis
scripts/demo_server.py - Play-along analysis → Musician / audio: presents chords
- V14 model → CRNN acoustic model: extends model
src/chordtracker/model_v14.py