编码与格式 / 系统课时

批量处理媒体文件

批量处理媒体文件

本课实现一个可直接运行的 Bash 批处理脚本:递归扫描媒体文件,保持原目录结构生成 MP4,跳过已有结果,并记录每个文件的成功或失败状态。完成后,你可以安全地重复执行任务并快速定位异常文件。

学习目标

  • 使用空字符分隔方式安全遍历带空格的文件名
  • 为每个输入文件生成稳定且不冲突的输出路径
  • 记录处理状态,并让单个失败不阻断整批任务

明确批处理流程

批处理不只是给 FFmpeg 套一层循环,还要同时处理文件发现、扩展名过滤、目录映射、重复执行和错误收集。脚本应让每个输入文件独立完成一次“判断、转换、记录”,最后再汇总结果。

批量媒体处理流程图

使用 find -print0 输出空字符分隔的路径,再用 read -d '' 读取,可以避免空格和换行导致文件名被错误拆分。

编写批处理脚本

将下面内容保存为 batch-media.sh。脚本接收输入目录、输出目录和日志文件三个参数;未传入时使用默认值。

bash
#!/usr/bin/env bash
set -uo pipefail

input_dir="${1:-./input}"
output_dir="${2:-./output}"
log_file="${3:-./batch.log}"

mkdir -p "$output_dir"
: > "$log_file"

success=0
failed=0
skipped=0

while IFS= read -r -d '' src; do
  relative="${src#"$input_dir"/}"
  stem="${relative%.*}"
  dst="$output_dir/$stem.mp4"

  mkdir -p "$(dirname "$dst")"

  if [[ -f "$dst" ]]; then
    printf 'SKIP %s -> %s\n' "$src" "$dst" | tee -a "$log_file"
    ((skipped++))
    continue
  fi

  # 单个文件失败时继续处理后续文件,并清理可能生成的残缺输出。
  if ffmpeg -hide_banner -loglevel error -y \
      -i "$src" \
      -c:v libx264 -preset medium -crf 23 \
      -c:a aac -b:a 128k \
      -movflags +faststart \
      "$dst"; then
    printf 'OK   %s -> %s\n' "$src" "$dst" | tee -a "$log_file"
    ((success++))
  else
    rm -f "$dst"
    printf 'FAIL %s\n' "$src" | tee -a "$log_file"
    ((failed++))
  fi
done < <(
  find "$input_dir" -type f \
    \( -iname '*.mp4' -o -iname '*.mov' -o -iname '*.mkv' \) \
    -print0 | sort -z
)

printf 'SUMMARY success=%d failed=%d skipped=%d\n' \
  "$success" "$failed" "$skipped" | tee -a "$log_file"

((failed == 0))

最后一行让脚本在存在失败文件时返回非零状态,方便 CI、定时任务或上层程序判断整批任务是否完全成功。

准备样例并执行

下面的命令生成两个一秒钟的测试文件,再运行批处理脚本。生成测试文件时使用 -loglevel error,成功时不会打印 FFmpeg 进度日志。

bash
chmod +x batch-media.sh
rm -rf demo-input demo-output batch.log
mkdir -p demo-input/sub

ffmpeg -hide_banner -loglevel error -y \
  -f lavfi -i "testsrc=size=320x240:rate=25" \
  -f lavfi -i "sine=frequency=1000" \
  -t 1 -c:v libx264 -pix_fmt yuv420p -c:a aac \
  "demo-input/one.mp4"

ffmpeg -hide_banner -loglevel error -y \
  -f lavfi -i "testsrc2=size=320x240:rate=25" \
  -f lavfi -i "sine=frequency=600" \
  -t 1 -c:v libx264 -pix_fmt yuv420p -c:a aac \
  "demo-input/sub/two.mov"

./batch-media.sh demo-input demo-output batch.log

预期输出如下:

text
OK   demo-input/one.mp4 -> demo-output/one.mp4
OK   demo-input/sub/two.mov -> demo-output/sub/two.mp4
SUMMARY success=2 failed=0 skipped=0

再次执行同一命令时,两个输出文件已经存在,因此预期结果变为:

text
SKIP demo-input/one.mp4 -> demo-output/one.mp4
SKIP demo-input/sub/two.mov -> demo-output/sub/two.mp4
SUMMARY success=0 failed=0 skipped=2

验证输出与日志

使用 find 检查目录映射,再读取日志确认最终一次运行的状态。

bash
find demo-output -type f -print | sort
cat batch.log

第二次执行批处理后,预期输出为:

text
demo-output/one.mp4
demo-output/sub/two.mp4
SKIP demo-input/one.mp4 -> demo-output/one.mp4
SKIP demo-input/sub/two.mov -> demo-output/sub/two.mp4
SUMMARY success=0 failed=0 skipped=2

脚本每次启动都会用 : > "$log_file" 清空旧日志。如果需要长期审计,可改为追加模式,并在每批开始时写入任务 ID 与时间;动态时间应记录为实际值,而不是写死在脚本中。

常见失败与修复

出现 No such file or directory 时,先确认输入目录存在,并检查调用脚本时的工作目录。自动化任务通常不应依赖相对路径,生产环境建议传入绝对路径。

出现 Unknown encoder 'libx264' 时,说明当前 FFmpeg 构建未包含该编码器。可用 ffmpeg -encoders 检查能力,再按平台安装包含 libx264 的构建,或把脚本中的编码器替换为环境实际支持的实现。

出现部分文件失败时,查看日志中的 FAIL 路径,并单独运行对应 FFmpeg 命令获取完整错误信息。批处理阶段使用 -loglevel error 控制噪声,单文件排查时可改为 -loglevel info。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

批量处理媒体文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通