songsee

Generate spectrograms and audio feature visualizations from audio files via CLI.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill songsee-episvr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: songsee
Source: https://github.com/episvr/USTB-2026-SummerInternship/tree/main/hermes-config/skills/media/songsee
Command: npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill songsee-episvr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Analyzing audio content visually requires specialized tooling; this Skill turns audio files into spectrograms and multi-panel feature visualizations (mel, chroma, MFCC, and more) with a single command, making audio structure, tempo, and timbre inspectable as images. ## Core Features & Use Cases - Spectrogram Generation: Render standard or mel-scaled spectrograms from WAV and MP3 files, with optional ffmpeg support for other formats. - Multi-Panel Feature Grids: Combine up to nine visualization types (chroma, HPSS, self-similarity, loudness, tempogram, MFCC, spectral flux) into a single image. - Flexible Output Control: Slice audio by time range, choose color palettes, set image dimensions, and output PNG or JPG. - Use Case: Compare two synthesized audio outputs by generating side-by-side mel spectrograms, then inspect the images with a vision model to verify the synthesis pipeline. ## Quick Start Use the songsee skill to generate a mel spectrogram and chroma visualization from my track.mp3 file and save it as a PNG image.

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 path, for example songsee track.mp3, and it renders a spectrogram image. Use the -o flag to set the output file and --format to choose png or jpg.

What audio visualization types does songsee support?▼

songsee supports nine visualization types: spectrogram, mel, chroma, hpss, selfsim, loudness, tempogram, mfcc, and flux. Pass them as comma-separated values to the --viz flag to render multiple panels as a grid in one image.

Does songsee support audio formats other than WAV and MP3?▼

WAV and MP3 are decoded natively by songsee. For other formats, you need ffmpeg installed, which extends decoding support to additional audio codecs.

How do I visualize only part of an audio file?▼

Use the --start and --duration flags to slice the audio, for example songsee track.mp3 --start 12.5 --duration 8 to render an 8-second segment beginning at 12.5 seconds.

Can songsee read audio from stdin?▼

Yes, pipe audio data with a dash as the input, such as cat track.mp3 | songsee - --format png -o out.png. This is useful when chaining songsee into shell-based audio processing pipelines.