Nodes/ComfyUI-Apt_Preset/color_adjust_HSL
ComfyUI Node

color_adjust_HSL

The one-node basic photo pass

By cardenluo·Created 2 years ago·Updated 18 days ago· 309
color_adjust_HSL
  • image
  • IMAGE
hue0.00
brightness0.00
contrast1.00
saturation1.00
sharpness1.00
blur0
gaussian_blur0.0
edge_enhance0.00
detail_enhance

This is the node you reach for when you want "brighten this a touch, punch the saturation a bit, sharpen slightly" without chaining four separate core ComfyUI nodes. color_adjust_HSL bundles hue/brightness/contrast/saturation with sharpening, two different blur mechanisms, edge enhancement, and a detail-enhance toggle into a single pass. It's under Apt_Preset/image/color_adjust, the pack's general post-processing bucket.

It won't replace color_ImageCurve or color_balance_adv for precision grading - but for a fast global adjustment, it's the first node I'd wire in.

How it works

Standard image-adjustment math per field, applied globally across the frame. blur and gaussian_blur are two separate blur mechanisms - a small-range one (0-16, likely a simple box/pixel blur) and a much wider-range one (0-1024, a proper gaussian radius) - so you can stack a subtle softening with a heavier one if you actually want both.

The inputs and outputs that matter

  • hue (-0.5 to 0.5, default 0) - this is a rotation fraction, not a 0-360 degree value; 0.5 is roughly a half-turn around the color wheel.
  • brightness (-1 to 1, default 0) and contrast (-1 to 2, default 1).
  • saturation (0-5, default 1) - much wider headroom than usual, so values people instinctively type (like 1.5 "for a bit more pop") barely move the needle here; you may need bigger numbers than intuition suggests.
  • sharpness (-5 to 5, default 1) - negative blurs, positive sharpens, same convention as the sharpen dial on this pack's chx_YC_LG_Redux.
  • blur (0-16, int) and gaussian_blur (0-1024, float) - two independent blur controls.
  • edge_enhance (0-1) and detail_enhance (true/false toggle).
  • image in, IMAGE out.

How to install it

Through ComfyUI Manager: search "ComfyUI-Apt_Preset", install, restart. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/cardenluo/ComfyUI-Apt_Preset.git

then run install.bat (Windows) or install requirements yourself on Linux/Mac, and restart. No model downloads - this is pure image processing.

Common issues & troubleshooting

Saturation changes feel weaker than expected. The 0-5 range means the useful zone is wider than a typical 0-2 saturation dial - push further than you'd normally think to.

Image looks softer than intended. Check both blur and gaussian_blur aren't set nonzero at the same time - they stack, and it's easy to forget one is still dialed up from an earlier test.

Sharpness looks like blur instead. Remember the sign convention: negative values blur, positive sharpen. A negative sharpness isn't a bug, it's the other half of the same dial.

Want a live preview while dialing in values? color_adjust_HSL_visual has the identical parameter set, just flagged as an output node so results render inline as you adjust.

IMPORT FAILED on the pack. ComfyUI-Apt_Preset updates often and users have reported import failures after some releases - reinstall via Manager and restart before treating it as node-specific.

CategoryApt_Preset/image/color_adjust

Inputs (10)

NameTypeDefaultDescription
imageIMAGE
hueFLOAT0.00-0.5–0.5
brightnessFLOAT0.00-1–1
contrastFLOAT1.00-1–2
saturationFLOAT1.000–5
sharpnessFLOAT1.00-5–5
blurINT00–16
gaussian_blurFLOAT0.00–1024
edge_enhanceFLOAT0.000–1
detail_enhanceCOMBO2 options: false, true

Outputs (1)

NameTypeDescription
IMAGEIMAGE