Contact Sheet

contact_sheet

Tile timestamped frames of a video into one image to see a whole recording at a glance (the cheapest first look).

watchwritesdestructivesince v0.16.0

00:00PARAMETERS

Name	Type	Description
`input` required	`string`	Path to the source video.
`count`	`integer`	Frames to tile (default 12). ≥ 1, ≤ 48
`mode`	`"even" \| "scenes"`	even (default) or scenes (strongest changes; static stretches take no tiles).
`sceneThreshold`	`number`	Mode scenes: change needed, 0-1 (default 0.1). > 0, < 1
`columns`	`integer`	Tiles per row (default: roughly square). ≥ 1, ≤ 12
`tileWidth`	`integer`	Tile width in px (default 320). ≥ 64, ≤ 1920
`poster`	`boolean`	Write one representative poster frame instead of a sheet.
`output`	`string`	Optional output .png path. Defaults under SCREENCAST_HOME/frames.
`overwrite`	`boolean`	Allow replacing an existing file at the output path (default false).
`returnImage`	`boolean`	Return the sheet inline (default true).
`maxImageWidth`	`integer`	Max inline image width (default 1280). ≥ 16, ≤ 9007199254740991

00:05A MINIMAL CALL

contact_sheet { "input": "recording.mp4" }

The required arguments only, with placeholder values. Everything else takes its default.

00:10WHAT COMES BACK

Structured content (structuredContent), alongside a text summary and any inline images:

Field	Type	Description
`outputPath` always	`string`
`inlineImages` always	`integer`	≥ -9007199254740991, ≤ 9007199254740991

00:15SEEN IN