songsee

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

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill songsee-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: songsee
Source: https://github.com/MarbleSodas/Mavis/tree/main/skills/media/songsee
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill songsee-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

songsee removes the manual work of visually inspecting audio by generating spectrograms and common audio features so you can quickly understand what’s happening in a track.

Core Features & Use Cases

  • Spectrogram generation: Create standard frequency spectrograms and mel-scaled views for visualizing timbre and energy across time.
  • Audio feature visualizations: Render multi-panel outputs including chroma, MFCC, self-similarity, loudness, tempogram, and spectral flux for analysis and comparison.
  • Workflow-friendly CLI: Produce consistent output images from files or stdin, optionally focusing on a specific time slice for targeted debugging or documentation.

Use case: Compare two versions of a song by generating matching grids (e.g., spectrogram, mel, MFCC, flux) to spot differences in pitch content, onset activity, and timbral changes.

Quick Start

Run songsee on an MP3 file and save a multi-panel visualization grid to an image with spectrogram, mel, chroma, mfcc, and flux.

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 or WAV file?

You can generate a spectrogram by running the songsee command on an MP3 or WAV file to produce PNG or JPG image outputs. It natively processes WAV and MP3 formats, while using ffmpeg to handle other audio file types.

Can I visualize MFCC and chroma features for music analysis?

Yes, you can visualize MFCC and chroma features by using the --viz option to render multi-panel outputs. This includes spectral flux, tempogram, self-similarity, and loudness grids for comprehensive music analysis.

Does this CLI audio visualization tool require ffmpeg?

FFmpeg is only required for audio formats beyond native WAV and MP3 files. The tool processes standard WAV and MP3 inputs directly without additional dependencies, while relying on ffmpeg to decode and convert other formats.

How do I extract a spectrogram for a specific time slice of a track?

You can extract a spectrogram for a specific time slice by running the CLI command with targeted time parameters for focused debugging. This allows you to isolate and visually inspect frequency content and temporal events within a specific segment.

What is the best way to compare two versions of a song using spectrograms?

The best way to compare two versions is to generate matching multi-panel visualization grids for both tracks. You can use the CLI to output consistent images showing spectrogram, mel, MFCC, and spectral flux data to spot differences in pitch and onset activity.

Are there limitations when using this method for audio signal debugging?

A limitation of this CLI visualization method is that it outputs static PNG or JPG image artifacts rather than interactive plots. It is designed for consistent documentation and visual inspection, not for real-time signal manipulation or dynamic onset investigation.