songsee

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

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill songsee-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: songsee
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/media/songsee
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill songsee-avatar-arts

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 visual representations—spectrograms, mel scales, chroma, MFCC, and more—using a single CLI command, making audio structure inspectable at a glance. ## Core Features & Use Cases - Spectrogram Generation: Render standard or mel-scaled spectrograms from WAV and MP3 files, with ffmpeg support for other formats. - Multi-Panel Visualization Grids: Combine up to nine visualization types (chroma, HPSS, self-similarity, loudness, tempogram, MFCC, flux) into a single image. - Time Slicing and Styling: Extract specific time ranges with --start/--duration and customize palettes, dimensions, and FFT parameters. - Use Case: Compare two audio synthesis outputs by generating side-by-side mel spectrograms, then feed the images to a vision model for automated analysis. ## Quick Start Ask the assistant to generate a mel spectrogram of your audio 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 -o to set the output file and --format to choose png or jpg.

What audio visualization types does songsee support?

Songsee supports nine types: spectrogram, mel, chroma, hpss, selfsim, loudness, tempogram, mfcc, and flux. Pass them comma-separated via --viz 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. Other formats require ffmpeg to be installed on the system for decoding 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 starting 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 works well in shell pipelines and scripted workflows.