songsee
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
Security Assessment
About songsee
songsee is a command-line tool designed to generate spectrograms and feature-panel visualizations from audio files. It solves the problem of audio analysis and visualization by providing a fast, straightforward way to create visual representations of sound characteristics. Whether you're analyzing a single track or examining specific time slices, songsee transforms audio data into informative visual outputs that reveal frequency content, temporal patterns, and acoustic features.
The tool offers comprehensive visualization capabilities through multiple panel types including spectrograms, mel-frequency representations, chroma features, harmonic-percussive source separation (HPSS), self-similarity matrices, loudness analysis, tempograms, MFCCs, and spectral flux. Users can customize output with various color palettes (classic, magma, inferno, viridis, gray), adjust FFT parameters through window and hop length settings, control frequency ranges, and specify output dimensions. The tool supports flexible input methods including direct file input or stdin piping, with native WAV/MP3 decoding and ffmpeg integration for additional formats.
songsee is ideal for audio engineers, music producers, researchers, and developers who need to analyze audio characteristics visually. Common use cases include quality assurance for audio processing pipelines, music information retrieval research, educational demonstrations of audio signal processing concepts, and debugging audio-related issues in applications. The ability to generate multi-panel grids makes it particularly valuable for comparative analysis and comprehensive feature extraction workflows.
FAQ
What audio formats does songsee support?
songsee has native support for WAV and MP3 files. If ffmpeg is installed on your system, it can handle additional audio formats through ffmpeg's decoding capabilities.
How do I generate multiple visualization panels at once?
Use the --viz flag with comma-separated values or repeat the flag multiple times. For example: `songsee track.mp3 --viz spectrogram,mel,chroma` will create a grid with all specified visualizations.
Can I analyze only a specific portion of an audio file?
Yes, use the --start flag to specify the starting time in seconds and --duration to set how many seconds to analyze. For example: `songsee track.mp3 --start 12.5 --duration 8` analyzes 8 seconds starting at 12.5 seconds.
How do I pipe audio data into songsee?
Use a hyphen (-) as the input filename to read from stdin. For example: `cat track.mp3 | songsee - --format png -o out.png`. This is useful for processing audio from streams or other command outputs.
What visualization types are available?
songsee supports nine visualization types: spectrogram, mel-frequency spectrogram, chroma features, harmonic-percussive source separation (hpss), self-similarity matrix (selfsim), loudness analysis, tempogram, mel-frequency cepstral coefficients (mfcc), and spectral flux.
Install songsee
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
steipete/clawdis