songsee

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

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill songsee-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: songsee
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/media/songsee
Command: npx skills add https://github.com/perasyudha/Nyxora --skill songsee-perasyudha

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 CLI command, making audio characteristics 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, flux) into a single image. - Flexible Output Control: Slice audio by time range, adjust FFT window/hop, frequency range, color palettes, dimensions, and PNG/JPG output. - Use Case: Compare two synthesized audio outputs by generating side-by-side mel spectrograms, then inspect the images with a vision model to verify frequency content differences. ## Quick Start Generate a mel spectrogram 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 as input, for example songsee track.mp3 -o spectrogram.png. WAV and MP3 are decoded natively, and the output can be saved as 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 in a single grid 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 songsee uses to decode additional audio formats.

How do I visualize only a portion of an audio file?

Use the --start and --duration flags to slice the audio by time, for example songsee track.mp3 --start 12.5 --duration 8 to render an 8-second segment starting 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 for chaining songsee into shell-based audio processing pipelines.