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.