Resource icon

OBS Lua RGB Adjustment Tool filter 1.2

Unzip the LUA file into your scripts folder and load the filter-rgbtool.lua script.
rgb00.jpg


Add the "RGB Adjustment Tool" filter to your source.
rgb01.jpg


Click the "Show Tools" box and using the "Move Graph" slider, position the graph out of the way.
new-rgb02.jpg


Using the "Center X" and "Center Y" sliders, position the cross-hair on an area of white or gray, or a commercial gray card or color checker card.
rgb03.jpg


Adjust the "R", "G", and "B" sliders so all the bars turn gray and the black background turns white. The image has now been white balanced. For best results, only adjust the Red and Blue sliders to match the Green channel.
rgb04.jpg


Camera Matching:
If you want to match another camera shooting the same scene from a different angle, move the meter level so it matches the levels of the rgb and luma level (the background will turn yellow when the meter level matches the rgb and luma levels). Copy the meter level value. Add the RGB Adjustment Tool to the other camera source. Check the "Show Tools" box, and paste the meter level value into the "Meter Level" control. Position the cross-hair at the same white or gray spot as the other camera source, and adjust the RGB levels to match the meter line.

Auto White Balance:
If your cross-hair is positioned at a white or gray spot in the image that will not be blocked or moved during your OBS session, you can use the "Auto Lock" checkbox to automatically white balance the source. When the checkbox below the "Auto Lock" box is un-checked, the rgb levels will automatically be adjusted to the luma level.
rgb05.jpg

If the box is checked, the rgb levels will automatically be adjusted to the level of the meter line.
rgb06.jpg


Once everything is adjusted to your satisfaction, un-check the "Show Tools" box.
rgb07.jpg


Additional Parameters:
The "Bypass RGB/Exposure/Gamma Adjustment" box is for comparing the unadjusted and adjusted source.

The "Show Gradient" checkbox fills the image with a gradient of the image color under the cross-hair. The "Normalize Gradient" checkbox boosts the gradient to the color's highest level.

Note:
For better noise rejection, the color picked at the cross-hair is an average of 25 pixels around the center of the cross-hair.
  • Like
Reactions: FittingGlove
Author
khaver
Downloads
4,210
Views
8,850
First release
Last update
Rating
4.80 star(s) 5 ratings

More resources from khaver

Latest updates

  1. v1.2 Alpha Channel Fix

    The tool is now alpha channel aware. If used after a Chroma Key filter or on a graphic with...
  2. New Version

    Changes to the auto white balance algorithm. UI changes.

Latest reviews

5 stars! ⭐⭐⭐⭐⭐

This tool is an absolute must-have for color correction in OBS—awesome controls!

The design is incredibly intuitive, making color correction a breeze. The three RGB vertical bars are a genius feature. When they turn gray, you know the color balance is perfect—such a simple yet effective way to achieve white balance.

However, the option to lock white balance is a bit aggressive, as it changes based on the pixel selected. Maybe an option for an area would be nicer and give smoother results since light and color are not referenced to one pixel but rather a zone.

Plus, you can also adjust exposure and gamma! I haven't seen any other filter capable of doing that. The results are mind-blowing, giving a perfect-looking image every time with this tool.
khaver
khaver
The filter uses an average of about 20 pixels around the crosshair. If the color bars are jumping a lot before turning on the WB lock, it means your image is fairly noisy, and after the lock is engaged, the whole image may "flicker" as it adjusts the RGB values to keep the pixels (average of 20) under the crosshair white.
Perfect tool. Top Support. Easy to use. Now i do not need StreamFX anymore :)
Amazing!!
Excellent tool, this gives you real control over the video image. An essential tool for color correcting, thank you for making this!
Top