Command · Detect Shots
analysis.detectShots
Finds the cuts (hard cuts, fades through black, dissolves; flashes are not cuts) in a clip's video and, for a clip, marks them with sequence markers ("markers": false to only list them).
- v1
- Capability EditSequence
- Tool
analysis_detectShots
Request
{
"command": "analysis.detectShots",
"params": {
"clip": {
"time": "00:00:10:00",
"track": "V1"
}
}
}Parameters
clipinteger | object (1..)- The clip. A clip id, or {"track", "time"} for the clip there.
detector`combined` | `content` | `adaptive` | `threshold`- Detector: combined (hard cuts, fades, dissolves; flashes ignored; default), content, adaptive or threshold (fades through black).
markersboolean- Add a marker at each cut in the clip. Default true.
mediainteger | string (1..)- Or a media item. A media id or exact name.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
thresholdnumber (1.0..255.0)- Content threshold (default 27; lower finds more cuts).
Discussion
Finds the cuts (hard cuts, fades through black, dissolves; flashes are not cuts) in a clip's video and, for a clip, marks them with sequence markers ("markers": false to only list them). For a media item the cuts are listed in media time. Results are cached per source file.
Run it with wabcut-cli cmd <project> --json, from an MCP client as analysis_detectShots, or from an extension. See Edit commands for requests, references and results.
See also
analysis.*
- analysis.detectBeats
Detect Beats. Finds the tempo and beats of a clip's music: beat markers labelled 1-2-3-4 (downbeats red) and the sequence's beat grid (snapping, edit.snapToBeats and edit.cutToBeats use it).
- analysis.speakers
Who Speaks When. Active-speaker detection for a multicam source, on this computer: who speaks when (with crosstalk, silence and laughter) and which angle shows whom (close-up or wide), from the transcripts with their speakers, each angle's microphone level and each camera's faces and lip motion.
- analysis.subjects
Find Subjects. Finds the faces, people and salient regions of a media item over time, shot by shot (5-10 samples a second, denser while the picture moves; faces and people tracked within each shot).