# Audio Visualizer

> 音频可视化视频：把纯音频（播客片段、音乐、口播金句、电台）渲染成带动态波形/频谱的视频，配封面和标题，好发到抖音/B站/视频号等只收视频的平台。当用户说 音频可视化、音频转视频、播客做成视频、音频波形视频、音乐可视化、给音频配画面、声波视频、频谱视频、把音频发到视频平台、电台切片视频 时使用。基于 shared/scripts/audio_viz.py（ffmpeg showwaves/showcqt/showspectrum）。与 audio-mix 区别：那个输出音频，本 SKILL 输出视频；与 slideshow-video 区别：那个用图片，本 SKILL 用音频驱动画面。

- **Type:** Skill
- **Install:** `agentstack add skill-zju-real-easel-audio-visualizer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ZJU-REAL](https://agentstack.voostack.com/s/zju-real)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [ZJU-REAL](https://github.com/ZJU-REAL)
- **Source:** https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/audio-visualizer
- **Website:** https://zju-real.github.io/Easel/

## Install

```sh
agentstack add skill-zju-real-easel-audio-visualizer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 音频可视化视频

> 把音频渲染成带动态波形/频谱的视频，配封面+标题，让纯音频能发到视频平台。全部走
> `skills/shared/scripts/audio_viz.py`，**不要手拼 showwaves/showcqt 滤镜**。

> 输出音频（混音）见 **audio-mix**；用图片做视频见 **slideshow-video**；
> 给已有视频加字幕见 **auto-subtitle**。

## 输入

| 字段 | 必填 | 说明 |
|------|------|------|
| 音频文件 | 是 | 播客/音乐/口播片段（没给就问） |
| 画幅 | 是 | 用户或上游任务未明确横版/竖版（或具体分辨率）时，制作前必须追问并等确认；不得按平台、Profile 或默认值静默推断，已明确则不重复问 |
| 模式 | 否 | `cqt`（默认，音乐最好看）/ `bars` / `waves` / `spectrum` |
| 封面 | 否 | 居中封面图（专辑封面/头像/主题图） |
| 标题 | 否 | 顶部标题文字 |

## 输出（`outputs/主题名/`）

- 可视化视频（`*.mp4`，音频已嵌入）
- 报告：模式、时长、画幅

## 执行步骤

脚本路径（相对项目根）：`skills/shared/scripts/audio_viz.py`（`render -h` 看参数）。

```bash
# 音乐/金句：CQT 音乐频谱（随音符跳动，最好看）
python skills/shared/scripts/audio_viz.py render -i clip.mp3 \
  -o outputs/主题名/out.mp4 --mode cqt --title "本期金句" --cover cover.jpg

# 播客口播：底部波形条 + 封面
python skills/shared/scripts/audio_viz.py render -i podcast.mp3 \
  -o outputs/主题名/out.mp4 --mode waves --cover avatar.png --size 1080x1920

# 律动柱状 / 滚动声谱
python skills/shared/scripts/audio_viz.py render -i song.mp3 -o out.mp4 --mode bars
python skills/shared/scripts/audio_viz.py render -i song.mp3 -o out.mp4 --mode spectrum
```

## 模式怎么选

| 模式 | 观感 | 适用 |
|------|------|------|
| `cqt` | 全屏音符频谱，随旋律跳动 | 音乐、有旋律的内容（默认） |
| `bars` | 底部频谱柱，律动感强 | 音乐、卡点、电台 |
| `waves` | 底部波形线，简洁干净 | 播客、口播、访谈 |
| `spectrum` | 全屏滚动声谱图，科技感 | 电子/科技类、氛围 |

`--bg-image` 换背景图，`--color` 换背景色，`--wave-color` 换波形颜色。

## Profile 感知

- 有 Profile：`platforms.md` 只用于给出画幅建议，仍须用户确认；标题/封面风格贴合账号；
  播客/口播账号默认 `waves`，音乐账号默认 `cqt`/`bars`。
- 无 Profile：先确认横版/竖版；默认 cqt 模式。

## 规则

1. 长音频先用 audio-editing/text-condenser 截出金句片段再可视化，别整集渲染。
2. 音频原声完整嵌入输出，不重采样丢质量。
3. 封面图会等比缩放居中，标题自动描边保证可读。
4. 产物统一进 `outputs/主题名/`。

## 参考来源

音频波形/频谱可视化用 ffmpeg `showwaves`/`showfreqs`/`showspectrum`/`showcqt`，是播客/音频号
上视频平台的标准做法。把各可视化滤镜与封面/标题合成封装成确定性脚本。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ZJU-REAL](https://github.com/ZJU-REAL)
- **Source:** [ZJU-REAL/Easel](https://github.com/ZJU-REAL/Easel)
- **License:** Apache-2.0
- **Homepage:** https://zju-real.github.io/Easel/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zju-real-easel-audio-visualizer
- Seller: https://agentstack.voostack.com/s/zju-real
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.