Video Filmstrip
Generate an extracted-frame archive, a 4-column 4K filmstrip grid, an average-color barcode image, and an average RGB CSV from any video file using FFmpeg and the Python standard library (zero third-party packages required).
Prerequisites
Confirm ffmpeg, ffprobe, and python are available on PATH before running:
ffmpeg -version; ffprobe -version; python --version
Steps
- Resolve the input video path and ask the user whether they want the Filmstrip Grid tiles numbered with Frame Badges or unnumbered (unless they already specified in their request), plus any optional overrides (frame rate, output directory, prefix, start/duration trim, or custom dimensions).
- Run generate_filmstrip.py with the input video path:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"
Pass optional flags only when overriding defaults:
--no-frame-numbers: Omit the bottom-left 16px Frame Badges from Grid Sheets (pass when the user chooses unnumbered tiles)--output-dir <dir>: Destination directory (default:<prefix>_filmstripnext to the input video)--prefix <name>: Output filename prefix (default: input video stem)--fps <rate>: Frames per second to extract (default:1.0)--cols <count>: Grid column count (default:4)--grid-width <px>: Total grid width in pixels (default:3840)--barcode-height <px>: Average-color barcode height in pixels (default:715)--barcode-stripe-width <px>: Barcode width per frame in pixels (default:1)--quality <2-31>: FFmpeg MJPEG quality, lower is better (default:2)--start <sec>: Start offset in seconds (-ss)--duration <sec>: Clip duration in seconds (-t)
- Verify the generated artifacts inside the output folder:
frames/<prefix>-001.jpeg... (kept Extracted Frames at original video resolution, unbadged)<prefix>_grid.jpegor numbered<prefix>_grid-001.jpeg... (4-column Filmstrip Grid sheets, with bottom-left 16px Frame Badges unless--no-frame-numberswas passed, auto-split at FFmpeg's65500pxJPEG height cap)<prefix>_averagesRGB.jpeg(Average Color Barcode)<prefix>_averagesRGB.csv(frame,timestamp_sec,r,g,brows matching the extracted frame count)
- Report the output directory and clickable links for the generated grid sheet(s), barcode, CSV, and frames folder.