Command · Match Scene
color.matchScene
Shot-to-shot consistency: matches every clip of the reference clip's scene to it - "scene" (default) is the run of clips on its track cut from the same take without gaps (what clip.splitAtShots makes), "track" every clip on its track, "media" every clip of the same media item, or an explicit "clips" list.
- v1
- Capability EditSequence
- Tool
color_matchScene
Request
{
"command": "color.matchScene",
"params": {
"reference": {
"time": "00:00:12:00",
"track": "V1"
}
}
}Parameters
clips(integer | object (1..))[], min 1- Or exactly these clips.
referenceinteger | object (1..)Required- The clip the others should look like. A clip id, or {"track", "time"} for the clip there.
scope`scene` | `track` | `media`- Which clips. Default scene.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
skinPriorityboolean- Weigh skin tones 4x. Default false.
strengthnumber (0.0..1.0)- How far to go, 0..1. Default 1.
Discussion
Shot-to-shot consistency: matches every clip of the reference clip's scene to it - "scene" (default) is the run of clips on its track cut from the same take without gaps (what clip.splitAtShots makes), "track" every clip on its track, "media" every clip of the same media item, or an explicit "clips" list. One undo step; dryRun previews it.
Run it with wabcut-cli cmd <project> --json, from an MCP client as color_matchScene, or from an extension. See Edit commands for requests, references and results.
See also
color.*
- color.auto
Auto Color. Auto colour: looks at the clip (at "time", default its middle) without its grade and sets the grade's white balance (temperature, tint) and levels (exposure, whites, blacks) as ordinary, editable Basic parameters.
- color.grade.get
Get Color Grade. A clip's grade at a time (default: its middle): parameters (only those changed unless "all"), animated ones, curves, LUTs, missing LUTs and whether it does anything.
- color.grade.set
Set Color Grade. Sets a clip's colour grade (wabcut.color.grade; added at the end of the stack when the clip has none): "params" by registry key (only those given change; effect.list lists them with ranges), "stages" on or off (basic, creative, curves, wheels, hsl, vignette), "curves" as [x, y] points (master/red/green/blue x and y in 0..1; hueSat/hueHue/hueLuma x = hue in turns and lumaSat/satSat y with 0.5 = no change; [] resets), and the "inputLut" / "look" ("builtin:" or "asset:" from lut.list; "" removes).
- color.match
Color Match. Makes clips look like a reference frame: "reference" is {"clip", "time"} (that clip as it looks, alone) or a sequence time (the whole picture).