Skill: Contact Sheet

Builds a contact sheet from a slice of a video clip: 16 evenly spaced frames laid out in a 4x4 grid, each annotated with its hh:mm:ss timestamp.

Prerequisite: ffmpeg with drawtext

This skill burns timestamps onto frames with ffmpeg's drawtext filter. ButterCut resolves ffmpeg from the repo's dependencies/ directory first, then PATH, and raises a clear error when it's in neither place. If a run fails with that missing-ffmpeg error, or with No such filter: 'drawtext' (some PATH builds, notably the stock Homebrew formula, omit drawtext), run the setup skill to install a suitable ffmpeg, then retry the contact sheet.

Run

When the clip belongs to a library, always pass --library so the output lands in the standard place:

# Whole clip
ruby lib/buttercut/contact_sheet.rb <video-path> --library libraries/<lib>

# From <start> to the end of the clip
ruby lib/buttercut/contact_sheet.rb <video-path> <start> --library libraries/<lib>