Communitygithub.com

video-filmstrip

動画ファイルからフレームを抽出し、4K・4列のフィルムストリップグリッド、平均色のバーコード画像、平均RGBのCSVをFFmpegとPythonで生成します。

video-filmstrip とは?

このスキルは、任意の動画ファイルからフレームを抽出し、4K解像度(3840px幅)の4列フィルムストリップグリッド、平均色バーコード画像、および平均RGB値を記録したCSVファイルを生成するためのものです。FFmpegとPython標準ライブラリのみを使用するため、サードパーティ製パッケージは一切不要です。ユーザーはグリッド内のフレームに番号(フレームバッジ)を付けるかどうかを選択でき、フレームレート、出力ディレクトリ、ファイル名プレフィックス、トリミング開始時間・再生時間、カスタム解像度など豊富なオプションを指定可能です。出力アーティファクトは、元の動画解像度のままのフレーム画像フォルダ、4列のフィルムストリップグリッドシート(必要に応じて自動分割)、平均色バーコード画像、およびフレーム数と一致するRGBのCSVファイルです。対応プラットフォームは、FFmpegとPythonが動作するすべての環境(Windows、macOS、Linux)であり、主にClaude CodeやCodexのようなAIエージェントでの利用を想定しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ajtopper/filmstrip-skill/tree/HEAD/skills/video-filmstrip

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Video Filmstrip

FFmpegとPython標準ライブラリ(サードパーティパッケージ不要)を使用して、任意の動画ファイルから抽出フレームアーカイブ、4列の4Kフィルムストリップグリッド、平均色バーコード画像、および平均RGBのCSVを生成します。

前提条件

実行前に ffmpeg、ffprobe、python が PATH 上で利用可能であることを確認してください:

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

手順

  1. 入力動画パスを解決し、ユーザーにフィルムストリップグリッドのタイルにフレームバッジ(番号)を付けるかどうかを尋ねます(すでにリクエストで指定されていない場合)。さらに、オプションのオーバーライド(フレームレート、出力ディレクトリ、プレフィックス、開始/再生時間のトリミング、カスタム寸法)も確認します。
  2. 入力動画パスを指定して generate_filmstrip.py を実行します:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"

デフォルトを変更する場合のみ、オプションフラグを渡します:

  • --no-frame-numbers: グリッドシートから左下の16pxフレームバッジを省略(ユーザーが番号なしを選択した場合に指定)
  • --output-dir <dir>: 出力先ディレクトリ(デフォルト: 入力動画の隣に <prefix>_filmstrip)
  • --prefix <name>: 出力ファイル名のプレフィックス(デフォルト: 入力動画のベース名)
  • --fps <rate>: 抽出する1秒あたりのフレーム数(デフォルト: 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 ...(4列のフィルムストリップグリッドシート。左下に16pxのフレームバッジ付き、ただし --no-frame-numbers が指定された場合は除く。FFmpegのJPEG高さ上限 65500px で自動分割)
    • <prefix>_averagesRGB.jpeg(平均色バーコード)
    • <prefix>_averagesRGB.csv(frame,timestamp_sec,r,g,b の行。抽出フレーム数と一致)
  2. 出力ディレクトリと、生成されたグリッドシート、バーコード、CSV、フレームフォルダへのクリック可能なリンクを報告します。

関連スキル