Contact sheet
contact_sheetGenerates a grid image of evenly spaced video frames with timestamps and an optional title bar, so you can review an entire clip at a glance and save it as a JPG.
Instructions
One grid image of evenly spaced frames with timestamp labels and a title bar — the quickest way to see a whole video at a glance (review an edit, log b-roll, find a moment, describe a clip). Optionally saved as a JPG.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "contact_sheet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Only look up to this time. | |
| cols | No | ||
| path | Yes | Absolute path to a local video file. ~ is expanded. | |
| rows | No | ||
| start | No | Only look from this time on. | |
| title | No | Add a title bar with file name, duration and resolution. | |
| labels | No | Draw the timestamp on each tile. | |
| font_file | No | Font for labels (.ttf/.otf). Defaults to a system font. | |
| overwrite | No | ||
| save_path | No | Also save the sheet as a JPG. | |
| background | No | Background color (ffmpeg color name or 0xRRGGBB). | 0x111111 |
| tile_width | No | Width of each thumbnail in pixels. |