Command · Set Color Grade
color.grade.set
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).
- v1
- Capability EditSequence
- Tool
color_grade_set
Request
{
"command": "color.grade.set",
"params": {
"clip": {
"time": "00:00:05:00",
"track": "V1"
},
"params": {
"basic.contrast": 15,
"basic.exposure": 0.4
}
}
}Parameters
clipinteger | object (1..)- The clip. A clip id, or {"track", "time"} for the clip there.
clips(integer | object (1..))[], min 1- Clips to change (or "clip" for one).
curvesobject- Curve name -> [[x, y], ...].
effectinteger (1..)- The grade's effect instance id when the clip has several (clip.details lists them). Default: its first grade.
enabledboolean- Turn the whole grade on or off.
inputLutstring- Input LUT reference (Basic), or "" for none.
lookstring- Look LUT reference (Creative), or "" for none.
paramsobject- Parameter key -> number, e.g. {"basic.exposure": 0.5, "basic.saturation": 120}.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
stagesobject- Stage -> true/false, e.g. {"hsl": false}.
Discussion
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:
Run it with wabcut-cli cmd <project> --json, from an MCP client as color_grade_set, 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.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).
- 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.