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 for formats beyond WAV/MP3.
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 with comma-separated values:
| Type |
Description |
spectrogram |
Standard frequency spectrogram |
mel |
Mel-scaled spectrogram |
chroma |
Pitch class distribution |
hpss |
Harmonic/percussive separation |
selfsim |
Self-similarity matrix |
loudness |
Loudness over time |
tempogram |
Tempo estimation |
mfcc |
Mel-frequency cepstral coefficients |
flux |
Spectral flux (onset detection) |
Multiple --viz types render as a grid in a single image.
Common Flags
| Flag |
Description |
--viz |
Visualization types (comma-separated) |
--style |
Color palette: classic, magma, inferno, viridis, gray |
--width / --height |
Output image dimensions |
--window / --hop |
FFT window and hop size |
--min-freq / --max-freq |
Frequency range filter |
--start / --duration |
Time slice of the audio |
--format |
Output format: jpg or png |
-o |
Output file path |
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
1---2name: songsee3description: "Audio spectrograms/features (mel, chroma, MFCC) via CLI."4version: 1.0.05author: community6license: MIT7platforms: [linux, macos, windows]8metadata:9 source: https://skillmd.com/skills/loopyluci/songsee10 hermes:11 tags: [Audio, Visualization, Spectrogram, Music, Analysis]12 homepage: https://github.com/steipete/songsee13prerequisites:14 commands: [songsee]15---1617# songsee1819Generate spectrograms and multi-panel audio feature visualizations from audio files.2021## Prerequisites2223Requires [Go](https://go.dev/doc/install):24```bash25go install github.com/steipete/songsee/cmd/songsee@latest26```2728Optional: `ffmpeg` for formats beyond WAV/MP3.2930## Quick Start3132```bash33# Basic spectrogram34songsee track.mp33536# Save to specific file37songsee track.mp3 -o spectrogram.png3839# Multi-panel visualization grid40songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux4142# Time slice (start at 12.5s, 8s duration)43songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg4445# From stdin46cat track.mp3 | songsee - --format png -o out.png47```4849## Visualization Types5051Use `--viz` with comma-separated values:5253| Type | Description |54|------|-------------|55| `spectrogram` | Standard frequency spectrogram |56| `mel` | Mel-scaled spectrogram |57| `chroma` | Pitch class distribution |58| `hpss` | Harmonic/percussive separation |59| `selfsim` | Self-similarity matrix |60| `loudness` | Loudness over time |61| `tempogram` | Tempo estimation |62| `mfcc` | Mel-frequency cepstral coefficients |63| `flux` | Spectral flux (onset detection) |6465Multiple `--viz` types render as a grid in a single image.6667## Common Flags6869| Flag | Description |70|------|-------------|71| `--viz` | Visualization types (comma-separated) |72| `--style` | Color palette: `classic`, `magma`, `inferno`, `viridis`, `gray` |73| `--width` / `--height` | Output image dimensions |74| `--window` / `--hop` | FFT window and hop size |75| `--min-freq` / `--max-freq` | Frequency range filter |76| `--start` / `--duration` | Time slice of the audio |77| `--format` | Output format: `jpg` or `png` |78| `-o` | Output file path |7980## Notes8182- WAV and MP3 are decoded natively; other formats require `ffmpeg`83- Output images can be inspected with `vision_analyze` for automated audio analysis84- Useful for comparing audio outputs, debugging synthesis, or documenting audio processing pipelines