mcpField
F
ffmpeg-audio-processing

ffmpeg-audio-processing

github.com/josiahsiegel创意与媒体59150 次安装19 周前更新
代码仓库

关于 ffmpeg-audio-processing

面向音频创作者与后期人员的 FFmpeg 音频处理指南,提供编码、响度标准化、滤镜及声道操作示例。也涵盖剪切、拼接、速度与音高调整。

主要功能

  1. 01音频格式与编码转换
  2. 02响度标准化与音量调整
  3. 03均衡、降噪与压缩滤镜
  4. 04声道及采样率处理
  5. 05剪切、拼接与交叉淡化

适用场景

  1. 01提取视频音轨并转换格式
  2. 02统一播客或流媒体音量
  3. 03清理录音中的噪声或静音
  4. 04剪辑、拼接或淡化音频片段

安装

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

$npx skills add https://github.com/josiahsiegel/claude-plugin-marketplace --skill ffmpeg-audio-processing

安装后在 Claude Code 中输入/ffmpeg-audio-processing确认已加载。

附带文件references/audio-analysis-measurement.mdreferences/workflows-and-troubleshooting.md

详细介绍

关键指南

Windows 文件路径要求

必须:在 Windows 上始终使用反斜杠表示文件路径

在 Windows 上使用 Edit 或 Write 工具时,文件路径必须使用反斜杠(\),不得使用正斜杠(/)。


快速参考

任务命令
提取音频ffmpeg -i video.mp4 -vn -c:a copy audio.m4a
转换为 MP3ffmpeg -i input.flac -c:a libmp3lame -q:a 2 output.mp3
响度标准化(EBU R128)-af loudnorm=I=-23:LRA=7:TP=-2
播客标准-af loudnorm=I=-16:TP=-1.5
调整音量-af "volume=1.5" 或 -af "volume=6dB"
单声道转立体声-ac 2
编码格式推荐比特率用途
AAC128-192k(音乐)、64k(语音)流媒体、移动设备
MP3192-320k(音乐)、128k(语音)通用兼容
Opus96-128k(音乐)、48k(语音)WebM、VoIP、现代应用

何时使用此技能

适用于以音频为重点的操作:

  • 从视频文件中提取音频
  • 按广播/流媒体规范进行响度标准化
  • 播客和有声读物处理
  • 音频格式转换
  • 音频效果(均衡、压缩、降噪)

FFmpeg 音频处理(2025)

使用 FFmpeg 进行音频编码、标准化和专业音频工作流的完整指南。

音频编码格式参考

编码格式对比
编码格式编码器比特率范围音质兼容性用途
AACaac, libfdk_aac64-320 kbps出色通用流媒体、移动设备
MP3libmp3lame96-320 kbps良好通用传统应用、播客
Opuslibopus32-256 kbps最佳现代应用VoIP、WebM
FLACflac~900 kbps无损广泛归档
ALACalac~900 kbps无损AppleApple 生态系统
Vorbislibvorbis64-500 kbps很好广泛WebM、游戏
AC3ac3192-640 kbps良好通用DVD、Blu-ray
EAC3eac3192-768 kbps很好广泛流媒体
xHE-AAC-(仅解码)12-64 kbps出色新兴超低比特率
推荐比特率
用途AACMP3Opus
播客/语音64-96k96-128k48-64k
音乐(标准)128-192k192-256k96-128k
音乐(高音质)256-320k320k160-256k
透明音质256k+320k192k+

基本音频操作

提取音频
# Extract to original format (no re-encode)
ffmpeg -i video.mp4 -vn -c:a copy audio.m4a

# Extract to MP3
ffmpeg -i video.mp4 -vn -c:a libmp3lame -b:a 320k audio.mp3

# Extract to AAC
ffmpeg -i video.mp4 -vn -c:a aac -b:a 256k audio.m4a

# Extract to FLAC (lossless)
ffmpeg -i video.mp4 -vn -c:a flac audio.flac

# Extract to WAV (uncompressed)
ffmpeg -i video.mp4 -vn -c:a pcm_s16le audio.wav
转换音频格式
# MP3 to AAC
ffmpeg -i input.mp3 -c:a aac -b:a 256k output.m4a

# WAV to MP3
ffmpeg -i input.wav -c:a libmp3lame -b:a 320k output.mp3

# FLAC to MP3
ffmpeg -i input.flac -c:a libmp3lame -b:a 320k output.mp3

# Multiple files (batch)
for f in *.flac; do
  ffmpeg -i "$f" -c:a libmp3lame -b:a 320k "${f%.flac}.mp3"
done
质量设置
# AAC VBR quality (1-5, higher = better)
ffmpeg -i input.wav -c:a aac -q:a 2 output.m4a

# MP3 VBR quality (0-9, lower = better)
ffmpeg -i input.wav -c:a libmp3lame -q:a 0 output.mp3

# Opus with target bitrate
ffmpeg -i input.wav -c:a libopus -b:a 128k output.opus

音频标准化

响度标准
标准目标值TP(真峰值)用途
EBU R128-23 LUFS-1 dBTP欧洲广播
ATSC A/85-24 LKFS-2 dBTP美国广播
Spotify-14 LUFS-1 dBTP流媒体
YouTube-14 LUFS-1 dBTP视频平台
Apple Music-16 LUFS-1 dBTP音乐流媒体
播客-16 至 -19 LUFS-1 dBTP播客
EBU R128 标准化(loudnorm)
单遍处理(实时)
# Quick normalization (less accurate)
ffmpeg -i input.mp3 \
  -af loudnorm=I=-16:TP=-1.5:LRA=11 \
  output.mp3
两遍处理(推荐)
# Pass 1: Analyze
ffmpeg -i input.mp3 \
  -af loudnorm=I=-16:TP=-1.5:LRA=11:print_format=json \
  -f null -

# Output will include:
# "input_i": "-25.23"
# "input_tp": "-0.50"
# "input_lra": "8.32"
# "input_thresh": "-35.87"
# "target_offset": "1.23"

# Pass 2: Normalize with measured values
ffmpeg -i input.mp3 \
  -af loudnorm=I=-16:TP=-1.5:LRA=11:measured_I=-25.23:measured_TP=-0.50:measured_LRA=8.32:measured_thresh=-35.87:offset=1.23:linear=true \
  -ar 48000 \
  output.mp3
两遍处理脚本
#!/bin/bash
# loudnorm-2pass.sh

INPUT="$1"
OUTPUT="$2"
TARGET_I="${3:--16}"
TARGET_TP="${4:--1.5}"
TARGET_LRA="${5:-11}"

# Pass 1: Analyze
stats=$(ffmpeg -i "$INPUT" \
  -af loudnorm=I=${TARGET_I}:TP=${TARGET_TP}:LRA=${TARGET_LRA}:print_format=json \
  -f null - 2>&1 | grep -A 12 "Parsed_loudnorm")

# Extract values
input_i=$(echo "$stats" | grep input_i | tr -d '", ' | cut -d':' -f2)
input_tp=$(echo "$stats" | grep input_tp | tr -d '", ' | cut -d':' -f2)
input_lra=$(echo "$stats" | grep input_lra | tr -d '", ' | cut -d':' -f2)
input_thresh=$(echo "$stats" | grep input_thresh | tr -d '", ' | cut -d':' -f2)
offset=$(echo "$stats" | grep target_offset | tr -d '", ' | cut -d':' -f2)

# Pass 2: Normalize
ffmpeg -i "$INPUT" \
  -af "loudnorm=I=${TARGET_I}:TP=${TARGET_TP}:LRA=${TARGET_LRA}:measured_I=${input_i}:measured_TP=${input_tp}:measured_LRA=${input_lra}:measured_thresh=${input_thresh}:offset=${offset}:linear=true" \
  -ar 48000 \
  "$OUTPUT"
峰值标准化
# Normalize to peak level
ffmpeg -i input.mp3 \
  -af "volume=0dB:eval=once:precision=fixed" \
  -af "loudnorm=I=-16:TP=-1:LRA=11" \
  output.mp3

# Simple peak normalization
ffmpeg -i input.mp3 \
  -filter:a "volume=replaygain=peak" \
  output.mp3
RMS 标准化
# Normalize to specific RMS level
ffmpeg -i input.mp3 \
  -af "loudnorm=I=-23:LRA=7:TP=-2" \
  output.mp3
ffmpeg-normalize 工具

ffmpeg-normalize Python 实用程序提供了更便捷的接口:

# Install
pip install ffmpeg-normalize

# Basic usage
ffmpeg-normalize input.mp3 -o output.mp3

# Custom target
ffmpeg-normalize input.mp3 -o output.mp3 -t -14

# Batch normalize (album mode - preserves relative loudness)
ffmpeg-normalize *.mp3 --batch -o normalized/

# Use built-in presets (v1.36.0+)
ffmpeg-normalize input.mp3 --preset podcast -o output.mp3
ffmpeg-normalize *.mp3 --preset music --batch -o normalized/

音频滤镜

音量控制
# Increase volume by 50%
ffmpeg -i input.mp3 -af "volume=1.5" output.mp3

# Increase by 6dB
ffmpeg -i input.mp3 -af "volume=6dB" output.mp3

# Decrease by 3dB
ffmpeg -i input.mp3 -af "volume=-3dB" output.mp3
淡入/淡出
# Fade in 3 seconds, fade out last 3 seconds
ffmpeg -i input.mp3 \
  -af "afade=t=in:ss=0:d=3,afade=t=out:st=57:d=3" \
  output.mp3

# Calculate fade out start automatically
duration=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 input.mp3)
fadeout_start=$(echo "$duration - 3" | bc)
ffmpeg -i input.mp3 \
  -af "afade=t=in:ss=0:d=3,afade=t=out:st=${fadeout_start}:d=3" \
  output.mp3
均衡
# Bass boost
ffmpeg -i input.mp3 \
  -af "equalizer=f=100:width_type=o:width=2:g=5" \
  output.mp3

# Treble reduction
ffmpeg -i input.mp3 \
  -af "equalizer=f=8000:width_type=o:width=2:g=-3" \
  output.mp3

# Multi-band EQ
ffmpeg -i input.mp3 \
  -af "equalizer=f=100:width_type=o:width=2:g=3,equalizer=f=1000:width_type=o:width=2:g=-2,equalizer=f=8000:width_type=o:width=2:g=2" \
  output.mp3
高通/低通滤镜
# High-pass filter (remove below 80Hz)
ffmpeg -i input.mp3 -af "highpass=f=80" output.mp3

# Low-pass filter (remove above 8kHz)
ffmpeg -i input.mp3 -af "lowpass=f=8000" output.mp3

# Band-pass filter
ffmpeg -i input.mp3 -af "highpass=f=80,lowpass=f=12000" output.mp3
降噪
# FFT-based noise reduction
ffmpeg -i input.mp3 \
  -af "afftdn=nf=-25" \
  output.mp3

# With noise floor adjustment
ffmpeg -i input.mp3 \
  -af "afftdn=nf=-20:tn=1" \
  output.mp3
压缩器/限制器
# Dynamic range compression
ffmpeg -i input.mp3 \
  -af "acompressor=threshold=-20dB:ratio=4:attack=5:release=50" \
  output.mp3

# Limiter
ffmpeg -i input.mp3 \
  -af "alimiter=limit=0.9:attack=5:release=50" \
  output.mp3

# De-esser
ffmpeg -i input.mp3 \
  -af "deesser=i=0.4:f=4000:w=0.5" \
  output.mp3
静音检测/移除
# Detect silence
ffmpeg -i input.mp3 \
  -af silencedetect=noise=-30dB:d=0.5 \
  -f null -

# Remove silence
ffmpeg -i input.mp3 \
  -af "silenceremove=start_periods=1:start_silence=0.5:start_threshold=-50dB:stop_periods=1:stop_silence=0.5:stop_threshold=-50dB" \
  output.mp3

声道操作

立体声转单声道
# Average both channels
ffmpeg -i stereo.mp3 \
  -af "pan=mono|c0=0.5*c0+0.5*c1" \
  mono.mp3

# Use only left channel
ffmpeg -i stereo.mp3 -af "pan=mono|c0=c0" mono.mp3

# Downmix stereo to mono
ffmpeg -i stereo.mp3 -ac 1 mono.mp3
单声道转立体声
# Duplicate mono to both channels
ffmpeg -i mono.mp3 -af "pan=stereo|c0=c0|c1=c0" stereo.mp3

# Simple conversion
ffmpeg -i mono.mp3 -ac 2 stereo.mp3
提取特定声道
# Extract left channel
ffmpeg -i stereo.mp3 \
  -filter_complex "[0:a]channelsplit=channel_layout=stereo:channels=FL[left]" \
  -map "[left]" left.mp3

# Extract right channel
ffmpeg -i stereo.mp3 \
  -filter_complex "[0:a]channelsplit=channel_layout=stereo:channels=FR[right]" \
  -map "[right]" right.mp3
5.1 环绕声操作
# Downmix 5.1 to stereo
ffmpeg -i surround.ac3 \
  -af "pan=stereo|FL=0.5*FC+0.707*FL+0.707*BL+0.5*LFE|FR=0.5*FC+0.707*FR+0.707*BR+0.5*LFE" \
  stereo.mp3

# Extract center channel
ffmpeg -i surround.ac3 \
  -filter_complex "[0:a]channelsplit=channel_layout=5.1:channels=FC[center]" \
  -map "[center]" center.mp3

采样率和位深

采样率转换
# Convert to 44.1kHz
ffmpeg -i input.wav -ar 44100 output.wav

# Convert to 48kHz
ffmpeg -i input.wav -ar 48000 output.wav

# High-quality resampling
ffmpeg -i input.wav \
  -af "aresample=resampler=soxr:precision=33:cheby=1" \
  -ar 44100 output.wav
位深转换
# Convert to 16-bit
ffmpeg -i input.wav -c:a pcm_s16le output.wav

# Convert to 24-bit
ffmpeg -i input.wav -c:a pcm_s24le output.wav

# Convert to 32-bit float
ffmpeg -i input.wav -c:a pcm_f32le output.wav

速度和音高

改变速度(影响音高)
# 2x speed (chipmunk effect)
ffmpeg -i input.mp3 -af "atempo=2.0" output.mp3

# 0.5x speed (slow motion)
ffmpeg -i input.mp3 -af "atempo=0.5" output.mp3

# For >2x, chain filters
ffmpeg -i input.mp3 -af "atempo=2.0,atempo=2.0" output.mp3  # 4x
改变音高(保持速度)
# Pitch shift using rubberband
ffmpeg -i input.mp3 \
  -af "rubberband=pitch=1.5" \
  output.mp3

# Pitch shift semitones
ffmpeg -i input.mp3 \
  -af "asetrate=44100*2^(2/12),aresample=44100" \
  output.mp3  # +2 semitones

修剪与拼接

修剪音频
# Extract 30 seconds starting at 1 minute
ffmpeg -ss 00:01:00 -i input.mp3 -t 00:00:30 -c copy output.mp3

# Extract from 1:00 to 2:30
ffmpeg -ss 00:01:00 -to 00:02:30 -i input.mp3 -c copy output.mp3
拼接音频
# Create file list
echo "file 'part1.mp3'" > list.txt
echo "file 'part2.mp3'" >> list.txt

# Concatenate (same format)
ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp3

# Concatenate with re-encode
ffmpeg -f concat -safe 0 -i list.txt -c:a aac -b:a 256k output.m4a
交叉淡化
# Crossfade two files (3 second overlap)
ffmpeg -i part1.mp3 -i part2.mp3 \
  -filter_complex "acrossfade=d=3:c1=tri:c2=tri" \
  output.mp3

专业工作流与故障排查

有关完整处理链(播客、音乐母带制作、广播 EBU R128)以及常见后期处理问题(loudnorm 重采样伪影、音视频同步、重新编码导致的质量损失)的修复方法,请参阅 references/workflows-and-troubleshooting.md。

音频分析与测量

有关详细的音频分析和测量滤镜,请参阅 references/audio-analysis-measurement.md。内容包括:

  • astats — RMS、峰值、峰均比、直流偏移、位深、动态范围
  • ebur128 — EBU R128 / ITU-R BS.1770 综合响度、LRA、真峰值,并可选择输出视频电平表
  • speechnorm — 针对语音 / 播客调校的自适应标准化器
  • dialoguenhance(FFmpeg 8.0+)— 为较差的录音增强语音频段
  • sofalizer — 基于 SOFA 文件的 HRTF / 双耳处理
  • volumedetect — 平均音量和峰值音量检测
  • aweighting — 用于感知响度的 A 加权曲线
  • chromaprint — 音频指纹识别(原始格式和 base64)
  • 完整分析工作流 — audio-analysis.sh 汇总 astats + ebur128 + volumedetect + silencedetect

本指南介绍 FFmpeg 音频处理。有关视频操作,请参阅基础技能。有关降噪详情,请参阅 ffmpeg-noise-reduction。

评论

支持 Markdown