ffmpeg-tools/README.md

FFmpeg 视频截图与缩略图生成

功能说明

从视频中每 3 秒截取一张图片，并自动生成 8x8 的缩略图网格（每张缩略图显示 64 帧画面），所有图片存放在以视频文件名命名的子文件夹中。

完整命令

# 替换 "你的视频文件名.mp4" 为实际视频路径
INPUT="你的视频文件名.mp4" && \
BASE="${INPUT%.*}" && \
FRAME_DIR="./frames_$BASE" && \
mkdir -p "$FRAME_DIR" && \
ffmpeg -i "$INPUT" -vf "fps=1/3" "$FRAME_DIR/frame_%04d.jpg" && \
cd "$FRAME_DIR" && \
total=$(ls frame_*.jpg 2>/dev/null | wc -l) && \
batch=64 && \
for ((i=0; i<total; i+=batch)); do \
  start=$((i+1)); \
  end=$((i+batch)); \
  [ $end -gt $total ] && end=$total; \
  ls -v frame_*.jpg | sed -n "$start,$end p" | sed 's/^/file /' > filelist.txt; \
  ffmpeg -f concat -safe 0 -i filelist.txt \
    -vf "scale=200:-1,drawtext=fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf:text='%{pts\:hms}':x=10:y=10:fontsize=12:fontcolor=white:borderw=1:bordercolor=black,drawtext=fontfile=/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf:text='frame_%{n}':x=10:y=28:fontsize=10:fontcolor=white:borderw=1:bordercolor=black,tile=8x8" \
    -vsync cfr -frames:v 1 "${BASE}_thumb_$((i/batch+1)).jpg"; \
  rm -f filelist.txt; \
done && \
cd ..

使用步骤

1. 修改视频路径：将命令开头的 INPUT="你的视频文件名.mp4" 改为你的实际视频文件路径
2. 执行命令：在终端中粘贴并运行
3. 查看结果：
   • 所有截图保存在 ./frames_视频名/ 目录下
   • 缩略图文件名为 视频名_thumb_1.jpg、视频名_thumb_2.jpg...

参数说明

参数	说明
fps=1/3	每 3 秒截取 1 帧
batch=64	每 64 张图片生成一张 8x8 缩略图
scale=200:-1	缩略图中每张图片宽度 200px，高度自适应
tile=8x8	8 行 8 列网格布局
drawtext	在图片上叠加时间戳和帧编号

注意事项

• 需要提前安装 ffmpeg 和 dejavu 字体（用于显示文字水印）
• 如果系统字体路径不同，请修改 fontfile= 参数
• 视频文件路径建议使用绝对路径或相对路径，避免空格和特殊字符

常用变体

修改截图频率

# 改为每 5 秒截一张
ffmpeg -i input.mp4 -vf "fps=1/5" frames/frame_%04d.jpg

修改缩略图网格大小

# 改为 4x4 网格（每张缩略图显示 16 帧）
# 将 tile=8x8 改为 tile=4x4，同时 batch=16

不添加文字水印

# 移除所有 drawtext 相关参数
ffmpeg -f concat -safe 0 -i filelist.txt -vf "scale=200:-1,tile=8x8" -vsync cfr -frames:v 1 thumb.jpg