视频编辑器 (ffmpeg)

用于剪切、合并、转换和处理视频文件的视频编辑操作。

前提条件

需要安装 ffmpeg 和 ffprobe：

bash
brew install ffmpeg

快速开始

剪切/裁剪视频

从视频中提取片段：

bash
{baseDir}/scripts/cut.sh /path/to/input.mp4 --start 00:00:10 --end 00:00:30 --out /path/to/output.mp4

或使用时长代替结束时间：

bash
{baseDir}/scripts/cut.sh /path/to/input.mp4 --start 00:01:00 --duration 30 --out /path/to/output.mp4

合并视频

拼接多个视频（必须具有相同的编解码器/分辨率）：

bash
{baseDir}/scripts/merge.sh video1.mp4 video2.mp4 video3.mp4 --out merged.mp4

格式转换

在视频格式之间转换：

bash
{baseDir}/scripts/convert.sh input.mov --format mp4 --out output.mp4

提取音频

从视频中提取音轨：

bash
{baseDir}/scripts/extract-audio.sh input.mp4 --out audio.mp3

添加字幕

将字幕嵌入视频：

bash
{baseDir}/scripts/add-subtitles.sh input.mp4 subtitles.srt --out output.mp4

调整视频尺寸

更改视频分辨率：

bash
{baseDir}/scripts/resize.sh input.mp4 --width 1920 --height 1080 --out output.mp4

或按比例缩放：

bash
{baseDir}/scripts/resize.sh input.mp4 --scale 720 --out output.mp4

调整速度

加速或减速视频：

bash
{baseDir}/scripts/speed.sh input.mp4 --rate 2.0 --out output.mp4 # 2倍速
{baseDir}/scripts/speed.sh input.mp4 --rate 0.5 --out output.mp4 # 0.5倍速

裁剪视频

裁剪到特定区域：

bash
{baseDir}/scripts/crop.sh input.mp4 --x 100 --y 100 --width 800 --height 600 --out output.mp4

常见工作流程

社交媒体片段

剪切片段并调整尺寸以适应Instagram/TikTok：

bash

首先剪切片段

{baseDir}/scripts/cut.sh input.mp4 --start 00:00:15 --duration 15 --out clip.mp4

然后调整为竖屏格式

{baseDir}/scripts/resize.sh clip.mp4 --width 1080 --height 1920 --out tiktok.mp4

提取精彩片段

剪切多个片段并合并：

bash
{baseDir}/scripts/cut.sh input.mp4 --start 00:00:10 --duration 5 --out highlight1.mp4
{baseDir}/scripts/cut.sh input.mp4 --start 00:01:30 --duration 5 --out highlight2.mp4
{baseDir}/scripts/merge.sh highlight1.mp4 highlight2.mp4 --out highlights.mp4

添加背景音乐

替换或混合音频：

bash

替换音频

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

混合音频（视频音频70%，音乐30%）

ffmpeg -i video.mp4 -i music.mp3 -filter_complex [0:a]volume=0.7[a0];[1:a]volume=0.3[a1];[a0][a1]amix=inputs=2:duration=first -c:v copy -shortest output.mp4

提示

• - 质量：使用 -crf 18 获得高质量，-crf 28 获得更小文件（默认值为23）
• 预设：使用 -preset slow 获得更好的压缩，-preset fast 获得更快的编码
• 硬件加速：在Apple Silicon上，添加 -c:v h264_videotoolbox 以获得更快的编码
• 复制模式：使用 -c copy 避免重新编码（速度更快，但编辑功能有限）

故障排除

合并失败并显示编解码器不匹配

视频必须具有相同的编解码器、分辨率和帧率。首先重新编码它们：

bash
ffmpeg -i input1.mp4 -c:v libx264 -c:a aac -vf scale=1920:1080 -r 30 temp1.mp4
ffmpeg -i input2.mp4 -c:v libx264 -c:a aac -vf scale=1920:1080 -r 30 temp2.mp4
{baseDir}/scripts/merge.sh temp1.mp4 temp2.mp4 --out merged.mp4

字幕不显示

确保字幕文件格式与扩展名匹配（.srt、.ass、.vtt）。检查编码：

bash
file -I subtitles.srt # 应显示 charset=utf-8

如果需要，进行转换：

bash
iconv -f GBK -t UTF-8 subtitles.srt > subtitles_utf8.srt