Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
nousresearch avatar

Songsee

  • 204 installs
  • 226k repo stars
  • Updated August 5, 2026
  • nousresearch/hermes-agent

Analyze audio files and render spectrogram-style visualizations to inspect songs, podcasts, or sound assets during media tooling workflows.

About

songsee in nousresearch/hermes-agent integrates audio spectrogram visualization so agents can analyze songs or recordings, render frequency views, and support media inspection in CLI, content, and agent build workflows.

  • Audio spectrogram visualization
  • Song and podcast inspection
  • CLI-friendly media analysis
  • Agent-driven sound tooling

Songsee by the numbers

  • 204 all-time installs (skills.sh)
  • +17 installs in the week ending Jul 17, 2026 (Skillselion tracking)
  • Ranked #615 of 1,335 Generative Media skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/nousresearch/hermes-agent --skill songsee

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs204
repo stars226k
Last updatedAugust 5, 2026
Repositorynousresearch/hermes-agent

What it does

Analyze audio files and render spectrogram-style visualizations to inspect songs, podcasts, or sound assets during media tooling workflows.

Files

SKILL.mdMarkdownGitHub ↗

songsee

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

Prerequisites

Requires Go:

go install github.com/steipete/songsee/cmd/songsee@latest

Optional: ffmpeg for formats beyond WAV/MP3.

Quick Start

# Basic spectrogram
songsee track.mp3

# Save to specific file
songsee track.mp3 -o spectrogram.png

# Multi-panel visualization grid
songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux

# Time slice (start at 12.5s, 8s duration)
songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg

# From stdin
cat track.mp3 | songsee - --format png -o out.png

Visualization Types

Use --viz with comma-separated values:

TypeDescription
spectrogramStandard frequency spectrogram
melMel-scaled spectrogram
chromaPitch class distribution
hpssHarmonic/percussive separation
selfsimSelf-similarity matrix
loudnessLoudness over time
tempogramTempo estimation
mfccMel-frequency cepstral coefficients
fluxSpectral flux (onset detection)

Multiple --viz types render as a grid in a single image.

Common Flags

FlagDescription
--vizVisualization types (comma-separated)
--styleColor palette: classic, magma, inferno, viridis, gray
--width / --heightOutput image dimensions
--window / --hopFFT window and hop size
--min-freq / --max-freqFrequency range filter
--start / --durationTime slice of the audio
--formatOutput format: jpg or png
-oOutput file path

Notes

  • WAV and MP3 are decoded natively; other formats require ffmpeg
  • Output images can be inspected with vision_analyze for automated audio analysis
  • Useful for comparing audio outputs, debugging synthesis, or documenting audio processing pipelines

Related skills

Generative Mediaanalyticspipelines

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.