Communitygithub.com

视频胶片条生成器

使用 FFmpeg 和 Python 标准库从视频文件中提取帧,生成 4K 四列胶片条网格、平均色条形码图像和平均 RGB CSV 文件。

视频胶片条生成器 是什么?

视频胶片条生成器(video-filmstrip)是一个 AI 代理技能,旨在从任意视频文件自动生成多种视觉摘要和元数据。它基于 FFmpeg 和 Python 标准库(无需额外安装第三方包),无需复杂依赖即可运行。该技能在 Linux、macOS 和 Windows 系统上均可使用,支持通过命令行参数进行精细控制,例如:抽取帧率、网格宽度、每帧条形码宽度、输出目录和文件名前缀等。其工作流程包括:首先解析输入视频路径并询问用户是否在网格瓦片上添加帧编号(Frame Badges),然后运行 `generate_filmstrip.py` 脚本完成所有处理。输出产物包括:原始分辨率的帧缩略图(JPG 格式)、4 列 4K 胶片条网格(自动在 FFmpeg 65500 像素高度限制下拆分)、代表每帧平均颜色的条形码图像,以及包含帧序号、时间戳和 RGB 平均值的 CSV 文件。这一技能特别适用于视频内容分析、影视预览、媒体资产管理和快速视频概览场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ajtopper/filmstrip-skill/tree/HEAD/skills/video-filmstrip

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

视频胶片条生成器 是做什么的?

使用 FFmpeg 和 Python 标准库(无需第三方包),从任意视频文件生成提取帧归档、四列 4K 胶片条网格、平均色条形码图像和平均 RGB CSV 文件。

前置条件

运行前确保 ffmpeg、ffprobe 和 python 在 PATH 中可用:

ffmpeg -version; ffprobe -version; python --version

步骤

  1. 解析输入视频路径,并询问用户是否希望胶片条网格瓦片上带有帧编号徽标(Frame Badges)或不带编号(除非用户已在请求中明确指定),此外还可提供可选覆盖参数(帧率、输出目录、前缀、起止时间裁剪或自定义尺寸)。
  2. 运行 generate_filmstrip.py 脚本,传入输入视频路径:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"

仅在需要覆盖默认值时传递可选标志:

  • --no-frame-numbers:在网格图上省略左下角 16px 帧编号徽标(当用户选择不带编号瓦片时使用)
  • --output-dir <dir>:目标目录(默认:在输入视频旁创建 <前缀>_filmstrip 文件夹)
  • --prefix <name>:输出文件名前缀(默认:输入视频的文件名主干)
  • --fps <rate>:每秒提取的帧数(默认:1.0)
  • --cols <count>:网格列数(默认:4)
  • --grid-width <px>:网格总宽度(像素,默认:3840)
  • --barcode-height <px>:平均色条形码高度(像素,默认:715)
  • --barcode-stripe-width <px>:每帧的条形码宽度(像素,默认:1)
  • --quality <2-31>:FFmpeg MJPEG 质量,数值越低质量越高(默认:2)
  • --start <sec>:起始偏移秒数(-ss)
  • --duration <sec>:剪辑持续时间秒数(-t)
  1. 检查输出文件夹内生成的内容:
    • frames/<prefix>-001.jpeg ... (保持原始视频分辨率、无徽标的提取帧)
    • <prefix>_grid.jpeg 或编号的 <prefix>_grid-001.jpeg ...(四列胶片条网格图,左下角带有 16px 帧编号徽标,除非传递了 --no-frame-numbers,当高度超过 FFmpeg 65500px JPEG 上限时自动拆分)
    • <prefix>_averagesRGB.jpeg(平均色条形码)
    • <prefix>_averagesRGB.csv(frame,timestamp_sec,r,g,b 行,行数与提取帧数一致)
  2. 报告输出目录,并提供生成的网格图、条形码、CSV 和帧文件夹的可点击链接。

相关技能