mcpField
S
songsee

songsee

github.com/nousresearch创意与媒体258.5k371 次安装今天更新
代码仓库

关于 songsee

songsee 是一项命令行技能,可从音频文件生成频谱图及其他音频特征可视化。它支持单图或网格图输出,并可设置可视化类型、外观、尺寸、频率范围和时间片段。

主要功能

  1. 01生成标准和 Mel 频谱图
  2. 02可视化音高类别、响度和速度
  3. 03在单张图像中呈现多种可视化
  4. 04配置调色板和输出尺寸
  5. 05按频率范围和音频片段筛选

适用场景

  1. 01检查音轨的频率内容
  2. 02在一张图中比较多种音频特征
  3. 03查看响度或速度随时间的变化
  4. 04将选定音频片段保存为可视化图像

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nousresearch/hermes-agent --skill songsee

安装后在 Claude Code 中输入/songsee确认已加载。

详细介绍

songsee

从音频文件生成频谱图和多面板音频特征可视化图。

前提条件

需要安装 Go:

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

可选:处理 WAV/MP3 以外的格式需要 ffmpeg。

快速开始

# 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

可视化类型

使用 --viz 并指定以逗号分隔的值:

类型说明
spectrogram标准频率频谱图
melMel 刻度频谱图
chroma音高类别分布
hpss谐波/打击乐分离
selfsim自相似矩阵
loudness随时间变化的响度
tempogram速度估计
mfccMel 频率倒谱系数
flux频谱通量(起音检测)

多个 --viz 类型会在一张图像中以网格形式呈现。

常用标志

标志说明
--viz可视化类型(以逗号分隔)
--style调色板:classic、magma、inferno、viridis、gray
--width / --height输出图像尺寸
--window / --hopFFT 窗口和跳步大小
--min-freq / --max-freq频率范围筛选
--start / --duration音频时间片段
--format输出格式:jpg 或 png
-o输出文件路径

说明

  • WAV 和 MP3 可原生解码;其他格式需要 ffmpeg
  • 可使用 vision_analyze 检查输出图像,以进行自动音频分析
  • 适用于比较音频输出、调试合成过程或记录音频处理流水线

评论

支持 Markdown