Extract frames to a folder
extract_framesSave video stills to a folder at fixed intervals, by frame count, per detected scene, or at exact timestamps for b-roll, storyboards, carousels, or feeding frames to other tools.
Instructions
Save stills to a folder: every N seconds, N evenly spaced frames, one per detected scene, or at exact timestamps. Files are named with their timecode. Good for b-roll stills, storyboards, social carousels or feeding frames to other tools.
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>",
"output_folder": "<output_folder>"
},
"name": "extract_frames"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Only look up to this time. | |
| mode | No | count | |
| path | Yes | Absolute path to a local video file. ~ is expanded. | |
| count | No | mode=count: how many evenly spaced frames. | |
| start | No | Only look from this time on. | |
| times | No | mode=timestamps: exact times. | |
| width | No | Resize to this width (keeps aspect). Default: full resolution. | |
| format | No | jpg | |
| prefix | No | File name prefix; defaults to the video's name. | |
| overwrite | No | ||
| max_frames | No | ||
| output_folder | Yes | Folder to write into (created if missing). | |
| scene_threshold | No | mode=scenes: sensitivity. | |
| interval_seconds | No | mode=interval: seconds between frames. |