Audio Mix logo

Audio Mix

OrganizationPopular
ZJU-REAL
audio-mix

音频混合 / 混音：把旁白口播 + 背景音乐 + 音效混成一轨，BGM 自动循环补足并可闪避（旁白说话时自动压低 BGM 保证人声清晰）。当用户说 混音、音频混合、旁白加背景音乐、配音加BGM、人声和音乐混一起、加音效、音频叠加、BGM 压低、闪避、ducking、把配音和bgm合起来 时使用。基于 shared/scripts/audio_mix.py。与 audio-editing concat 区别：concat 是前后顺序拼接，本 SKILL 是同时叠加混音；与 video-editing bgm 区别：那个给视频配乐，本 SKILL 输出纯音频。

Overview

PublisherZJU-REAL
RepositoryEasel
Skill nameaudio-mix
Stars
1.2K
Forks
175
Bundled files
Instructions only
LicenseApache-2.0
Links
Skill sourceRepositoryHomepage
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by ZJU-REAL on GitHub. Read the source before you install it.

Installation

Install the Audio Mix AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/ZJU-REAL/Easel.git /tmp/Easel
mkdir -p .claude/skills
cp -r /tmp/Easel/skills/openclaw/audio-mix .claude/skills/audio-mix
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Audio Mix in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Audio Mix on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Audio Mix is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

音频混合（旁白 + BGM + 音效）

把多条音频同时叠加混成一轨，核心能力是闪避（ducking）——旁白说话时自动压低 背景音乐，人声清晰、音乐不抢。全部走 skills/shared/scripts/audio_mix.py， 不要手拼 amix/sidechaincompress。

前后顺序拼接（一段接一段）见 audio-editing concat；给视频配乐见 video-editing bgm； 降噪见 audio-denoise。

输入

字段必填说明
旁白否口播/配音主轨（给了则输出时长跟它走，并触发闪避）
BGM否背景音乐（自动循环补足到旁白长度）
音效否一个或多个音效，可指定各自出现时间点

（三者至少给一个。最典型："旁白 + BGM"。）

输出（outputs/主题名/）

  • 混音后的单轨音频（mp3/wav/m4a，按输出后缀）
  • 报告：轨数、时长、是否闪避

执行步骤

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

bash
# 旁白 + BGM（默认自动闪避，BGM 循环补足到旁白长度）
python skills/shared/scripts/audio_mix.py mix \
  --voice narration.mp3 --bgm music.mp3 --bgm-volume 0.25 \
  -o outputs/主题名/final.mp3

# 关闭闪避（纯叠加）
python skills/shared/scripts/audio_mix.py mix --voice v.mp3 --bgm m.mp3 --no-duck -o out.mp3

# 旁白 + 定时音效（第 3.5s 一个叮，第 8s 一个 whoosh）
python skills/shared/scripts/audio_mix.py mix --voice v.mp3 \
  --sfx ding.wav --sfx-at 3.5 --sfx whoosh.wav --sfx-at 8 -o out.mp3

调参

  • 人声被音乐盖住：调低 --bgm-volume（默认 0.25）或确认闪避已开（默认开）。
  • 闪避太猛/音乐一顿一顿：--no-duck 后手动压低 --bgm-volume。
  • BGM 比旁白短：默认自动循环；不想循环用 --bgm-loop-off。
  • 音效太响/太轻：--sfx-volume（默认 0.9）。

规则

  1. 有旁白时输出时长 = 旁白长度，BGM 自动循环/裁切对齐并在末尾淡出。
  2. 旁白 + BGM 默认开启闪避（人声优先）；不需要时显式 --no-duck。
  3. --sfx 与 --sfx-at 数量一致（或不给 --sfx-at 全部默认 0s）。
  4. 混音不做响度归一（保留相对音量）；需统一响度先用 audio-editing normalize。
  5. 产物统一进 outputs/主题名/。

参考来源

闪避用 ffmpeg sidechaincompress（以人声为控制信号压缩 BGM），是播客/口播视频保证人声清晰的 标准做法；多轨叠加用 amix。把 sidechain 接线与循环对齐封装成确定性脚本。

Frequently asked questions

What does the Audio Mix AI skill do?

音频混合 / 混音：把旁白口播 + 背景音乐 + 音效混成一轨，BGM 自动循环补足并可闪避（旁白说话时自动压低 BGM 保证人声清晰）。当用户说 混音、音频混合、旁白加背景音乐、配音加BGM、人声和音乐混一起、加音效、音频叠加、BGM 压低、闪避、ducking、把配音和bgm合起来 时使用。基于 shared/scripts/audio_mix.py。与 audio-editing concat 区别：concat 是前后顺序拼接，本 SKILL 是同时叠加混音；与 video-editing bgm 区别：那个给视频配乐，本 SKILL 输出纯音频。

Why use Audio Mix on TypingMind?

Because you install it once and use it with any model. Audio Mix is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Audio Mix in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/ZJU-REAL/Easel/tree/main/skills/openclaw/audio-mix. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Audio Mix?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Audio Mix?

As many as you like. As long as a model supports skills, you can use Audio Mix with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Audio Mix AI skill free?

Yes. It is published on GitHub by ZJU-REAL under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

Related AI Skills

View all
HKUDS logo

Cli Hub Matrix Game Development

HKUDS
OrganizationPopular

Capability-based multi-tool matrix for game development: engine, 3D/2D/audio assets, AI-generated assets, agent playtesting, packaging, store publishing, and telemetry.

4.6K
49.5K
Instructions
View
HKUDS logo

Cli Hub Matrix Video Creation

HKUDS
OrganizationPopular

Capability-based multi-tool matrix for video production. Agents pick providers (CLI-Anything harnesses, public CLIs, Python libs, native binaries, cloud APIs) per capability rather than marching…

4.6K
49.5K
8 files
View
HKUDS logo

Cli Hub Meta Skill

HKUDS
OrganizationPopular

Discover agent-native CLIs for professional software. Access the live catalog to find tools for creative workflows, productivity, AI, and more.

4.6K
49.5K
Instructions
View
HKUDS logo

Cli Anything Minimax

HKUDS
OrganizationPopular

Command-line interface for MiniMax AI — chat (MiniMax-M3, MiniMax-M2.7) and speech-2.x TTS via the MiniMax API.

4.6K
49.5K
Instructions
View

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇