songsee

Generate spectrograms and multi-panel audio feature visualizations from audio files via CLI.

Updated May 4, 2026
One-click install
npx skills add https://github.com/Junkfooooood/hermes-governance --skill songsee-junkfooooood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: songsee
Source: https://github.com/Junkfooooood/hermes-governance/tree/main/skills/media/songsee
Command: npx skills add https://github.com/Junkfooooood/hermes-governance --skill songsee-junkfooooood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Audio analysis often requires visual inspection of frequency content, tempo, and structure, but setting up spectrogram tooling in Python or DAW plugins is slow. This Skill wraps the songsee CLI to produce spectrograms and multi-panel audio feature images directly from audio files. ## Core Features & Use Cases - Spectrogram Generation: Render standard, mel-scaled, and styled spectrograms from WAV or MP3 files with configurable FFT window, hop size, and frequency range. - Multi-Panel Feature Grids: Combine chroma, HPSS, self-similarity, loudness, tempogram, MFCC, and spectral flux visualizations into a single image. - Time Slicing and Format Control: Extract specific time ranges with --start and --duration, and output PNG or JPG at custom dimensions. - Use Case: Compare two synthesized audio outputs by generating side-by-side mel spectrograms, then inspect the images with vision analysis to verify frequency content and detect artifacts. ## Quick Start Ask the assistant to generate a mel spectrogram of your audio file, for example: create a spectrogram of track.mp3 and save it as spectrogram.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 argument, for example songsee track.mp3, optionally adding -o output.png to set the output path. WAV and MP3 are decoded natively without extra tools.

What audio visualization types does songsee support?

songsee supports spectrogram, mel, chroma, hpss, selfsim, loudness, tempogram, mfcc, and flux visualizations. Pass multiple types as comma-separated values to --viz to render them 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 such as FLAC or AAC, you need ffmpeg installed so the audio can be converted before visualization.

How do I visualize only part of an audio file?

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

Can songsee read audio from stdin?

Yes, pipe audio into songsee using a dash as the input, such as cat track.mp3 | songsee - --format png -o out.png. This is useful for chaining with other command-line audio tools.