{“content”:”---\nname: songsee\ndescription: Generate spectrograms and audio feature visualizations (mel, chroma, MFCC, tempogram, etc.) from audio files via CLI. Useful for audio analysis, music production debugging, and visual documentation.\nversion: 1.0.0\nauthor: community\nlicense: MIT\nmetadata:\n hermes:\n tags: [Audio, Visualization, Spectrogram, Music, Analysis]\n homepage: https://github.com/steipete/songsee\nprerequisites:\n commands: [songsee]\n---\n\n# songsee\n\nGenerate spectrograms and multi-panel audio feature visualizations from audio files.\n\n## Prerequisites\n\nRequires Go:\nbash\ngo install github.com/steipete/songsee/cmd/songsee@latest\n\n\nOptional: ffmpeg for formats beyond WAV/MP3.\n\n## Quick Start\n\nbash\n# Basic spectrogram\nsongsee track.mp3\n\n# Save to specific file\nsongsee track.mp3 -o spectrogram.png\n\n# Multi-panel visualization grid\nsongsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux\n\n# Time slice (start at 12.5s, 8s duration)\nsongsee track.mp3 --start 12.5 --duration 8 -o slice.jpg\n\n# From stdin\ncat track.mp3 | songsee - --format png -o out.png\n\n\n## Visualization Types\n\nUse --viz with comma-separated values:\n\n| Type | Description |\n|------|-------------|\n| spectrogram | Standard frequency spectrogram |\n| mel | Mel-scaled spectrogram |\n| chroma | Pitch class distribution |\n| hpss | Harmonic/percussive separation |\n| selfsim | Self-similarity matrix |\n| loudness | Loudness over time |\n| tempogram | Tempo estimation |\n| mfcc | Mel-frequency cepstral coefficients |\n| flux | Spectral flux (onset detection) |\n\nMultiple --viz types render as a grid in a single image.\n\n## Common Flags\n\n| Flag | Description |\n|------|-------------|\n| --viz | Visualization types (comma-separated) |\n| --style | Color palette: classic, magma, inferno, viridis, gray |\n| --width / --height | Output image dimensions |\n| --window / --hop | FFT window and hop size |\n| --min-freq / --max-freq | Frequency range filter |\n| --start / --duration | Time slice of the audio |\n| --format | Output format: jpg or png |\n| -o | Output file path |\n\n## Notes\n\n- WAV and MP3 are decoded natively; other formats require ffmpeg\n- Output images can be inspected with vision_analyze for automated audio analysis\n- Useful for comparing audio outputs, debugging synthesis, or documenting audio processing pipelines\n”}