跳到主要内容

Songsee

通过 CLI 生成音频频谱图/特征(mel、chroma、MFCC)。

Skill 元数据

来源内置(默认安装)
路径skills/media/songsee
版本1.0.0
作者community
许可证MIT
平台linux, macos, windows
标签Audio, Visualization, Spectrogram, Music, Analysis

参考:完整 SKILL.md

信息

以下是 AigenLabs 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 agent 所看到的指令内容。

songsee

从音频文件生成频谱图(spectrogram)及多面板音频特征可视化图。

前置条件

需要安装 Go

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

可选:安装 ffmpeg 以支持 WAV/MP3 以外的格式。

快速开始

# 基本频谱图
songsee track.mp3

# 保存到指定文件
songsee track.mp3 -o spectrogram.png

# 多面板可视化网格
songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux

# 时间切片(从 12.5s 开始,持续 8s)
songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg

# 从 stdin 读取
cat track.mp3 | songsee - --format png -o out.png

可视化类型

使用 --viz 并以逗号分隔多个值:

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

多个 --viz 类型将以网格形式渲染为单张图像。

常用标志

标志描述
--viz可视化类型(逗号分隔)
--style色彩调色板:classicmagmainfernoviridisgray
--width / --height输出图像尺寸
--window / --hopFFT 窗口和跳跃大小
--min-freq / --max-freq频率范围过滤
--start / --duration音频时间切片
--format输出格式:jpgpng
-o输出文件路径

注意事项

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