视频编辑

通过直接运行 ffmpeg/ffprobe 在本地编辑视频。无需包装脚本。

先决条件

安装 ffmpeg（包含 ffprobe）：

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt update && sudo apt install -y ffmpeg

# 验证安装
ffmpeg -version && ffprobe -version

快速参考

获取视频信息

ffprobe -v quiet -print_format json -show_format -show_streams video.mp4

裁剪

ffmpeg -y -ss 00:00:30 -to 00:01:45 -i video.mp4 -c copy trimmed.mp4

拼接片段

# 1. 创建文件列表
printf "file '%s'\n" clip1.mp4 clip2.mp4 clip3.mp4 > list.txt

# 2. 使用流复制拼接
ffmpeg -y -f concat -safe 0 -i list.txt -c copy joined.mp4

为特定平台调整尺寸

ffmpeg -y -i video.mp4 \
  -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:black" \
  -c:a copy tiktok.mp4

改变播放速度

# 2 倍速
ffmpeg -y -i video.mp4 -filter:v "setpts=0.5*PTS" -filter:a "atempo=2.0" fast.mp4

# 0.5 倍速（慢动作）
ffmpeg -y -i video.mp4 -filter:v "setpts=2.0*PTS" -filter:a "atempo=0.5" slow.mp4

提取音频

ffmpeg -y -i video.mp4 -vn -acodec libmp3lame audio.mp3

替换音频

ffmpeg -y -i video.mp4 -i audio.mp3 -c:v copy -map 0:v:0 -map 1:a:0 -shortest output.mp4

压缩

ffmpeg -y -i video.mp4 -crf 23 -preset medium -c:a copy compressed.mp4

转换格式

ffmpeg -y -i video.mov output.mp4

添加图像叠加层

# 将 Logo 放置在右上角
ffmpeg -y -i video.mp4 -i logo.png \
  -filter_complex "overlay=W-w-10:10" -c:a copy watermarked.mp4

平台预设

使用以下命令应用滤镜：ffmpeg -y -i input.mp4 -vf "<filter>" -c:a copy output.mp4

提示

• 始终使用 -y 覆盖输出文件，无需提示。
• 当只需要剪切/拼接时，使用 -c copy（无需重新编码，速度极快）。
• CRF 值越低，质量越高，文件越大。典型范围 18-28；23 是默认值。
• 有关详细的配方和标志说明，请参阅 references/operations.md。