songsee

Generate spectrograms and feature-panel visualizations from audio files with the songsee CLI.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill songsee-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: songsee
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/songsee
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill songsee-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning raw audio into visual representations like spectrograms and feature panels normally requires writing custom signal-processing code. This Skill wraps the songsee CLI so you can produce publication-ready audio visualizations with a single command. ## Core Features & Use Cases - Spectrogram Generation: Render spectrograms from WAV or MP3 files with configurable FFT window, hop size, and frequency range. - Multi-Panel Feature Grids: Combine mel, chroma, HPSS, self-similarity, loudness, tempogram, MFCC, and flux visualizations into one grid image. - Time Slicing & Styling: Extract specific time ranges and apply color palettes (classic, magma, inferno, viridis, gray) at custom output sizes. - Use Case: A music researcher wants to compare the spectral structure of two recordings; they generate side-by-side mel and chroma panels for each track as PNG images for a paper. ## Quick Start Ask the assistant to generate a spectrogram from your audio file, for example: create a spectrogram of track.mp3 using songsee and save it as a PNG.

Frequently Asked Questions about songsee

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a spectrogram from an MP3 file?

Run songsee with the audio file as its argument, such as songsee track.mp3, to produce a spectrogram image. Add --format png and -o out.png to control the output format and destination.

How to visualize multiple audio features in one image?

Pass a comma-separated list to the --viz flag, for example --viz spectrogram,mel,chroma,mfcc. songsee renders each selected feature as a panel in a single grid image.

What audio formats does songsee support?

songsee decodes WAV and MP3 natively. Other audio formats are supported when ffmpeg is available on the system, which songsee uses as a fallback decoder.

Can I generate a spectrogram of only part of a song?

Yes, use the --start and --duration flags to select a time slice, such as --start 12.5 --duration 8 to visualize eight seconds beginning at 12.5 seconds.

How do I install the songsee CLI?

Install songsee on macOS or Linux with Homebrew using the steipete/tap/songsee formula. After installation the songsee binary is available on your PATH.