songsee

Generate spectrograms and feature-panel visualizations from audio files with the songsee CLI.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill songsee-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: songsee
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/songsee
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill songsee-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning raw audio into visual representations like spectrograms normally requires writing signal-processing code. This Skill wraps the songsee CLI so you can produce spectrograms and multi-panel audio feature visualizations with a single command. ## Core Features & Use Cases - Spectrogram Generation: Render a spectrogram from any audio file with one command, with control over palette, size, FFT window, and frequency range. - Multi-Panel Feature Grids: Combine visualizations such as mel, chroma, HPSS, self-similarity, loudness, tempogram, MFCC, and flux into a single grid image. - Time Slicing and Streaming: Extract a specific time window with --start and --duration, or pipe audio via stdin and output JPG or PNG. - Use Case: A music researcher wants to compare the spectral content of a chorus across tracks. They generate mel and chroma panels for an 8-second slice of each song and place the images side by side in a report. ## Quick Start Ask the assistant to generate a spectrogram of your audio file, for example: create a spectrogram of track.mp3 using songsee and save it as a 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 audio file?

Run songsee followed by the audio file path, for example songsee track.mp3, to produce a spectrogram image. You can control the output with flags like --style for palette, --width and --height for size, and --format for jpg or png.

How to create multi-panel audio feature visualizations?

Pass a comma-separated list to the --viz flag, such as songsee track.mp3 --viz spectrogram,mel,chroma,mfcc. Available panels include spectrogram, mel, chroma, hpss, selfsim, loudness, tempogram, mfcc, and flux, rendered together as a grid.

What audio formats does songsee support?

songsee decodes WAV and MP3 files natively. Other audio formats are supported when ffmpeg is available on the system, which songsee uses as a fallback decoder.

Can I visualize only part of an audio file?

Yes, use the --start and --duration flags to select a time slice, for example songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg renders only the 8-second window starting at 12.5 seconds.

How do I install the songsee CLI?

Install songsee on macOS or Linux with Homebrew using the formula steipete/tap/songsee. After installation the songsee binary is available on your PATH for direct CLI use.