Skip to main content
Hue Correct

Hue Correct · screenshot coming soon

What this node does

Hue Correct is a hue-vs-X grading tool, like the Hue Correct nodes in compositing apps (Nuke, Fusion). Instead of moving one global slider, you draw a curve along the hue wheel: for each hue (reds, yellows, greens…) you decide how much to change saturation, luminance, a specific color channel, or the hue itself. Great for surgical fixes — desaturate just the reds, cool only the greens — while leaving everything else alone. It takes COMFYTV_VIDEO in and out and renders on a torch backend (hue_correct), so it has a ▶ Run with a live preview on the card. All the curves live in one JSON object; if no curve has at least two points, the clip passes through unchanged. To interoperate with native ComfyUI nodes, add a Bridge (see the Bridge guide).

When to use it

  • Desaturate only one problem color (e.g. an over-red skin tone)
  • Shift the hue of a specific range without a global rotation
  • Boost or cut luminance for one band of colors
  • Suppress a single channel within a hue range (the *_sup curves)

Parameters

curves

A JSON object of hue-driven curves. Each key maps to a list of [x, y] points over hue (x = position on the hue wheel, 0…1). Recognized keys:
  • sat — saturation vs hue
  • lum — luminance vs hue
  • red, green, blue — each color channel vs hue
  • r_sup, g_sup, b_sup — per-channel suppression vs hue
  • hue — hue shift vs hue
A curve only takes effect if it has at least two points. Leave the whole object empty (or with only single-point curves) and the node is a pass-through.

sat_thrsh

Saturation threshold, default 0.0, range 0.0…1.0. Gates the correction by how saturated a pixel already is, so nearly-gray pixels are affected less — this keeps hue tweaks from smearing into neutral areas.

luminance_mix

Default 0.0, range 0.0…1.0. Blends in a luminance-weighted response so the correction respects brightness, softening its effect on very dark or very bright pixels.

Outputs

Tips

  • Every curve needs two or more points to register; a lone point does nothing.
  • Raise sat_thrsh when a hue tweak is bleeding into gray/neutral regions.
  • This is for targeted hue work — for a global hue/saturation move, use Video Color instead.
  • Selective Color — nudge fixed color families (reds, cyans, neutrals…) with sliders
  • Video Color — global hue and saturation in one step
  • Video Curves — per-channel tone curves rather than hue-driven curves