Skip to content
cccskills
FreePublished on GitHub

audio-mix

Combine narration, background music, and timed sound effects into one audio file. Background music can loop to match the narration and automatically become quieter during speech, a technique called ducking, with controls for relative volume.

OriginalShow the original description

音频混合 / 混音:把旁白口播 + 背景音乐 + 音效混成一轨,BGM 自动循环补足并可闪避(旁白说话时自动压低 BGM 保证人声清晰)。当用户说 混音、音频混合、旁白加背景音乐、配音加BGM、人声和音乐混一起、加音效、音频叠加、BGM 压低、闪避、ducking、把配音和bgm合起来 时使用。基于 shared/scripts/audio_mix.py。

与 audio-editing concat 区别:concat 是前后顺序拼接,本 SKILL 是同时叠加混音;与 video-editing bgm 区别:那个给视频配乐,本 SKILL 输出纯音频。

See how to install

Good for

  • Add background music to narration
  • Automatically lower music during speech
  • Place sound effects at specific times
  • Loop short music to match narration length

Files included (1)

  • SKILL.md3.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

音频混合(旁白 + 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 看参数)。

# 旁白 + 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 接线与循环对齐封装成确定性脚本。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ai-image-gen

FreeSummary

Generate images from written descriptions, transform existing images with editing instructions, or create several variations. Choose image dimensions and quantity, then save the results using an OpenAI-compatible service or apimart with your own API key.

  • Generating an illustration from a written description
  • Changing an image's background using instructions
  • Creating several variations of an existing image
ZJU-REAL/Easel4KUpdated Oct 21, 2026

ai-music

FreeSummary

Generate background music for short videos, vlogs, and social posts from descriptions of mood, style, and instruments. Download MP3 audio, optionally include sung lyrics, and use shared scripts to trim tracks, adjust loudness, or add music to videos.

  • Generating background music for a vlog intro
  • Creating instrumental music to match a social post
  • Generating a sung track from supplied lyrics
ZJU-REAL/Easel4KUpdated Oct 21, 2026

ai-video-gen

FreeSummary

Create new videos from written scene descriptions or still images using external AI services. Set the aspect ratio and duration, animate a character image, and request generated audio when the selected model supports it.

  • Generate a short video from a scene description
  • Animate a still image
  • Create character motion from a starting image
ZJU-REAL/Easel4KUpdated Oct 21, 2026

asset-manager

FreeSummary

Organize generated images, videos, and text in outputs/ by date, platform, and type. Add tags, search filenames and content, produce asset lists and reports, and preview archive moves before applying them to make past work easier to reuse.

  • Organizing generated assets by date, platform, and type
  • Finding past content through keywords and tags
  • Listing assets for a specific account or platform
ZJU-REAL/Easel4KUpdated Oct 21, 2026

audio-denoise

FreeSummary

Reduce background noise in audio recordings or video soundtracks with three processing levels. Keep the original file, create a cleaned version, and receive a report of the settings used and file details before and after processing.

  • Reducing fan or air conditioner noise in recordings
  • Cleaning speech in podcasts and interviews
  • Reducing noise in a video's audio track
ZJU-REAL/Easel4KUpdated Oct 21, 2026

audio-editing

FreeSummary

Edit audio files by trimming sections, converting formats, matching loudness, or extracting sound from videos. You can also join recordings, add fades, and change playback speed while keeping the original pitch.

  • Trim a recording to the section you need
  • Convert audio formats and match loudness
  • Extract audio from a video
ZJU-REAL/Easel4KUpdated Oct 21, 2026

See all skills by ZJU-REAL

Report a problem with this skill