Extract Frames

Arguments

Parse the user's request for:

• video path (required): path to the video file
• --last: extract last frame of each shot instead of first
• --first --last or --all: extract both first and last frames
• --shots N,N,N: only process specific shot numbers (1-indexed)
• --threshold X: override auto-detected threshold (skip user confirmation)

Default: extract first frame of every shot.

Workflow

Phase 0: Setup

1. Validate the video file exists.
2. Get video metadata via ffprobe: