Command · 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).
- v1
- Capability EditSequence
- Tool
color_match
Request
{
"command": "color.match",
"params": {
"clips": [
44,
45
],
"reference": {
"clip": 43
}
}
}Parameters
clipinteger | object (1..)- The clip to change. A clip id, or {"track", "time"} for the clip there.
clips(integer | object (1..))[], min 1- Clips to change (or "clip" for one).
effectinteger (1..)- The grade's effect instance id when the clip has several (clip.details lists them). Default: its first grade.
referenceobject | integer | stringRequired- {"clip": ..., "time": ...} or a sequence time.
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
Makes clips look like a reference frame: "reference" is {"clip", "time"} (that clip as it looks, alone) or a sequence time (the whole picture). Fits the grade's exposure, contrast, temperature, tint and saturation so the clip's colour statistics (Oklab mean and spread) move to the reference's, by "strength"; "skinPriority" weighs skin tones more. Editable parameters, one undo step.
Run it with wabcut-cli cmd <project> --json, from an MCP client as color_match, 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.matchScene
Match Scene. 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.