songsee

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

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill songsee-mlt-oss
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: songsee
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/media/songsee
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill songsee-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Analyzing audio content typically requires opening a DAW or writing custom signal-processing code. This Skill turns any audio file into spectrograms and multi-panel feature visualizations (mel, chroma, MFCC, tempogram, and more) with a single CLI command, making audio analysis and debugging fast and repeatable. ## 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 Visualization Grids: Combine up to nine visualization types (spectrogram, mel, chroma, hpss, self-similarity, loudness, tempogram, MFCC, flux) into a single image. - Flexible Output Control: Adjust color palettes, image dimensions, FFT window/hop size, frequency ranges, and time slices, with PNG or JPG output. - Use Case: A music producer debugging a synthesis pipeline can generate a mel spectrogram and MFCC panel of the output, then feed the image to a vision model for automated inspection. ## Quick Start Generate a spectrogram from track.mp3 and save it as a PNG image using the songsee command.

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 followed by the audio file path, for example songsee track.mp3, to render a spectrogram. 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, self-similarity, loudness, tempogram, MFCC, and spectral flux. Pass them as comma-separated values to --viz to render multiple panels in a single grid image.

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

WAV and MP3 are decoded natively without extra tools. For other formats such as FLAC or AAC, you need ffmpeg installed so songsee can decode them.

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

Use the --start and --duration flags to select a time slice, for example --start 12.5 --duration 8 to visualize eight seconds beginning at 12.5 seconds. The output renders only that segment.

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 pipelines.