detect_scenes
Detect visual scene cuts and shot boundaries in a video with ffmpeg's scene-change filter, especially for silent footage or screen recordings, and optionally apply results as navigable chapters.
Instructions
Detect visual scene cuts / shot boundaries in the video using ffmpeg's scene-change filter. Useful for videos without dialogue or transcripts (screen recordings, silent footage, music videos). Set to_chapters: true to immediately install the detected scenes as navigable chapters on the playing file.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "detect_scenes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | No | Optional video file path; defaults to the playing file | |
| threshold | No | Scene change sensitivity threshold between 0.05 and 0.95 (default 0.3; lower detects more subtle cuts) | |
| max_scenes | No | Maximum number of scenes to return (1-100, default 20) | |
| to_chapters | No | Apply detected scenes as virtual chapters on the playing file |