Generates a timestamped 4x4 frame grid image from a video clip using ffmpeg.
npx skills add https://github.com/barefootford/buttercut --skill contact-sheet
Please help me install this Agent Skill. Skill: contact-sheet Source: https://github.com/barefootford/buttercut/tree/main/skills/contact-sheet Command: npx skills add https://github.com/barefootford/buttercut --skill contact-sheet
Reviewing long video clips frame by frame is slow, and scrubbing a timeline makes it hard to get a quick visual overview of a clip's content. This Skill condenses any clip or clip range into a single grid image with burned-in timestamps so you can see what happens and when at a glance.
Ask the agent to make a contact sheet of a specific clip or time range in your library, for example: create a contact sheet for libraries/main/footage/DJI_0278.mp4 from 00:30 to 01:00.
High-intent search queries and answers about installing and using this skill.
Run the contact_sheet.rb script with the video path and optionally a start and end time in seconds or HH:MM:SS format. Pass --library with your library directory so the grid image is saved to the library's contact_sheets folder.
Clips longer than 10 seconds produce 16 evenly spaced frames in a 4x4 grid. Clips of 10 seconds or less produce 4 frames in a 2x2 grid to avoid duplicate frames.
Some ffmpeg builds, notably the stock Homebrew formula, omit the drawtext filter needed to burn timestamps onto frames. Run the setup skill to install a full ffmpeg build, then retry the contact sheet.
Yes, portrait clips are auto-rotated using the source's container rotation metadata so frames and timestamps appear right-side-up. Variable-frame-rate sources like screen recordings are also detected and handled automatically.
With --library, output goes to <library>/contact_sheets/<clipname>_<descriptor>.jpg, where the descriptor is 'full' or a time range like 00-00-30_to_00-01-00. Without --library, it is saved next to the source video.
barefootfordInstall and verify ButterCut dependencies on macOS via Simple or Advanced paths.
anavvanzinCoach short-video editors through post-production workflows in CapCut Pro, Premiere Pro, DaVinci Resolve, and Final Cut Pro.
Albatross679Transcribe meeting audio with WhisperX and organize timestamped transcripts into Obsidian vault folders.
iart-aiCalculate frame-accurate cuts and speed ramps from BPM for video timelines.
