Command · Get Color Grade
color.grade.get
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.
- v1
- Capability Read
- Tool
color_grade_get
Request
{
"command": "color.grade.get",
"params": {
"clip": 42
}
}Parameters
allboolean- List every parameter, not only those changed. Default false.
clipinteger | object (1..)Required- The clip. A clip id, or {"track", "time"} for the clip there.
effectinteger (1..)- The grade's effect instance id when the clip has several (clip.details lists them). Default: its first grade.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
timeinteger | string- When (inside the clip). Timecode in the sequence's rate ("00:01:02:03") or ticks.
Discussion
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. "grade": null when the clip has none.
Run it with wabcut-cli cmd <project> --json, from an MCP client as color_grade_get, 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.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).
- 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.