Nodes/was-node-suite-comfyui/Image Rotate Hue
ComfyUI Node Runs on cloud

Image Rotate Hue

Shift every color in an image around the color wheel

By WASasquatch·Created 3 years ago·Updated about a year ago· 1,812
Image Rotate Hue

      WAS's README is unusually precise about this one, and it's worth quoting directly because the math is the whole story: "Rotate the hue of a image. A hue_shift of 0.0 would represent no change, and 1.0 would represent a full circle of the hue, and also exhibit no change." The hue wheel wraps - spin it all the way around and you're back where you started, which is exactly why both ends of the range do nothing.

      How it works

      Colors have three components you can separate: hue (which color), saturation (how vivid), and value/brightness (how light or dark). This node rotates only the hue component around the color wheel and leaves saturation and brightness alone, which means the image's overall contrast and vibrancy stay put while every color shifts uniformly - reds slide toward oranges then yellows then greens as you increase the shift, and so on around the wheel.

      The one gotcha in the README's own math

      Because 0.0 and 1.0 both mean "no change" (a full circle brings you back to start), the point of maximum difference from the original isn't at the top of the range - it's in the middle, around 0.5, where you're exactly opposite on the color wheel. If you're expecting "bigger number, bigger effect" the way most sliders work, this one will surprise you: push it toward 1.0 and the effect actually fades back out again rather than intensifying.

      The inputs and outputs that matter

      An image in, a hue_shift value (0.0 to 1.0, wrapping), and a recolored image out. That shift is the only real decision to make here - there's no separate saturation or brightness control on this node, by design, since those are exactly what it's built to leave untouched.

      Why you'd reach for it

      A fast, uniform recolor pass without touching contrast or exposure - turning a red dress blue while keeping the lighting exactly as generated, or building a rainbow-shifted variant set from one base image for stylized/psychedelic work. It's a blunt instrument in the sense that it shifts everything uniformly, including skin tones - great for stylized output, the wrong tool if you need to recolor one element while keeping people natural (that needs a mask plus a more targeted color tool).

      How to install it

      Bundled with the full WAS Node Suite:

      • ComfyUI Manager - search "WAS Node Suite", install, restart.
      • Manual - cd ComfyUI/custom_nodes && git clone https://github.com/WASasquatch/was-node-suite-comfyui, install requirements.txt (portable: python_embeded\python.exe -s -m pip install -r requirements.txt), restart.

      No model download - pure color-space math.

      Common issues & troubleshooting

      "Nothing happened" at a high shift value. Almost always the wraparound described above - you're near 1.0, which is functionally the same as 0.0. Aim for the middle of the range for a visible, strong shift.

      Skin tones went green/purple/whatever. Expected behavior, not a bug - the rotation is uniform across the whole image, faces included. If you need to protect skin tones while shifting something else, isolate the region with a mask first.

      Standard pack caveat: WAS Node Suite has been unmaintained since December 2023, and the recurring issue is the whole suite failing to import after a ComfyUI update. Reinstall requirements.txt against the right Python environment if that hits you.

      Categoryx

      Inputs (0)

      No inputs

      Outputs (0)

      No outputs