songsee

songsee

Generate spectrograms and multi-panel audio feature visualizations from audio files.

Prerequisites

Requires Go:

go install github.com/steipete/songsee/cmd/songsee@latest

Optional:

ffmpeg

Quick Start

# Basic spectrogram
songsee track.mp3

# Save to specific file
songsee track.mp3 -o spectrogram.png

# Multi-panel visualization grid
songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux

# Time slice (start at 12.5s, 8s duration)
songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg

# From stdin
cat track.mp3 | songsee - --format png -o out.png

Visualization Types

Use

--viz

spectrogram

mel

chroma

hpss

selfsim

loudness

tempogram

mfcc

flux

Multiple

--viz

Common Flags

--viz

--style

classic

magma

inferno

viridis

gray

--width

--height

--window

--hop

--min-freq

--max-freq

--start

--duration

--format

jpg

png

-o

Notes

• WAV and MP3 are decoded natively; other formats require

  ffmpeg

• Output images can be inspected with

  vision_analyze

  for automated audio analysis
• Useful for comparing audio outputs, debugging synthesis, or documenting audio processing pipelines