Skip to main content
ClaudeWave
Skill5.2k repo starsupdated today

songsee

Songsee is a command-line tool that generates spectrograms and multi-panel audio visualizations from music files. Use it to create publication-quality visualizations of audio features including mel-spectrograms, chroma, harmonic-percussive source separation, self-similarity matrices, loudness contours, tempograms, and MFCCs, with customizable frequency ranges, time slicing, and output dimensions.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/the-open-agent/openagent /tmp/songsee && cp -r /tmp/songsee/skills/songsee ~/.claude/skills/songsee
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# songsee

Generate spectrograms + feature panels from audio.

Quick start

- Spectrogram: `songsee track.mp3`
- Multi-panel: `songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux`
- Time slice: `songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg`
- Stdin: `cat track.mp3 | songsee - --format png -o out.png`

Common flags

- `--viz` list (repeatable or comma-separated)
- `--style` palette (classic, magma, inferno, viridis, gray)
- `--width` / `--height` output size
- `--window` / `--hop` FFT settings
- `--min-freq` / `--max-freq` frequency range
- `--start` / `--duration` time slice
- `--format` jpg|png

Notes

- WAV/MP3 decode native; other formats use ffmpeg if available.
- Multiple `--viz` renders a grid.