Detect scene cuts
detect_scenesFinds hard cuts and large visual changes in local videos, listing each scene's start, end, and length; optionally exports a contact sheet and CSV for edit logs, pacing counts, or shot lists.
Instructions
Find hard cuts and big visual changes, and list every scene with start, end and length — for logging an edit, counting cuts (pacing), pulling a shot list from a reference video, or splitting a montage. Optionally returns a contact sheet of the first frame of each scene and writes CSV.
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": "detect_scenes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Only look up to this time. | |
| path | Yes | Absolute path to a local video file. ~ is expanded. | |
| start | No | Only look from this time on. | |
| max_rows | No | ||
| overwrite | No | ||
| threshold | No | Scene-change sensitivity: lower finds more cuts (0.2 catches soft cuts, 0.4 only hard ones). | |
| include_sheet | No | Return a contact sheet of each scene's first frame (up to 30). | |
| csv_output_path | No | ||
| min_scene_seconds | No | Ignore cuts closer together than this (flash frames, strobes). |