Communitygithub.com

影片底片條生成器

從影片中提取畫格,並利用 FFmpeg 與 Python 標準函式庫,生成 4K 4 欄底片條網格、平均色條碼影像與平均 RGB CSV。

影片底片條生成器 是什麼?

這項技能可從任何影片檔案自動提取畫格,並生成多種輸出:原始解析度的畫格壓縮包、4K 寬度 4 欄的底片條網格(可選擇是否在每格左下角加上 16px 的幀編號標記)、平均色條碼影像,以及包含每幀時間戳與平均 RGB 值的 CSV 檔案。所有處理純粹仰賴 FFmpeg 與 Python 標準函式庫,不需安裝任何第三方套件。支援自訂幀率、輸出目錄、檔名前綴、起止時間裁剪與網格尺寸。產生的網格若超過 FFmpeg 的 JPEG 高度上限(65500px)會自動分割為多張。適用於 Claude Code、Cursor 等支援指令呼叫的 AI 編碼工具,開發者或內容創作者可用以快速預覽影片色彩分佈、產生縮圖條或建構後製素材庫。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

影片底片條生成器 是做什麼的?

從任何影片檔案產生已提取畫格的壓縮包、4 欄 4K 底片條網格、平均色條碼影像,以及平均 RGB CSV,全程使用 FFmpeg 與 Python 標準函式庫(不需任何第三方套件)。

前置需求

執行前請確認 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/<前綴>-001.jpeg ...(保留的原始解析度未標記畫格)
    • <前綴>_grid.jpeg 或編號 <前綴>_grid-001.jpeg ...(4 欄底片條網格,除非使用了 --no-frame-numbers,否則每格左下角會有 16px 幀編號標記;當超過 FFmpeg 的 65500px JPEG 高度上限時會自動分割成多張)
    • <前綴>_averagesRGB.jpeg(平均色條碼)
    • <前綴>_averagesRGB.csv(欄位:frame,timestamp_sec,r,g,b,列數與提取的畫格數一致)
  2. 回報輸出目錄,並提供產生的網格、條碼、CSV 與畫格資料夾的可點擊連結。

相關技能