What Does This Addon Do?

The Shot Matcher speeds image merging workflow by analyzing an image's or video's color range, which can be automatically mapped to foreground and background elements in the compositor.  This is especially helpful for adding background images to your render, or color grading visual effects.

Color Range - A Game Changer

My biggest struggle in my early Blender days was merging my render with a background image.  For some reason, the two images didn't match, even when I matched the lighting.  But during a VFX study, I figured out why: color range.

See, every image has its own color range.  One image's black and white values won't be the same as another's.  And my render and background had different color ranges, hence why it still felt fake.

The term to match color ranges is called "Shot Matching," often used in the industry by colorists or compositors.  I found other softwares had ways to resolve this, but not Blender - at least, not natively.  So I created my own solution, and the Shot Matcher was born.

Analyze the Picture or Video in Seconds!

In the image editor, you can get the maximum and minimum RGB values of any selected image.  One button, and you're done!  This is also included in the movie clip editor—select a valid frame range and step amount, and press "Calculate."  No guess-timating or third-party software needed!

For further precision, I added a custom-built color picker in the image editor.  Now, you can directly pick the areas you know to be black and white by hovering over the area and holding down "Ctrl."  Once you've color picked to your pleasure, confirm it with a mouse click.

The color picker compares its results to the black and white values you currently have, so if you don't find a darker black or whiter white, it'll keep the values already there.  If you realize you color picked the wrong area, you can always undo.  If you'd prefer to restart fresh, the reset button has got your back.

I also updated the automatic calculation and color picker with an optional alpha threshold.  So if your layer has transparent pixels, the analyzer can disregard them.

Apply It as a Node Group

Okay, you say, but so what?  Brace yourself: more is coming.   Once you've found the white and black values of the image, press one more button.  Those values will generate an "alpha over" node group that takes the color range into account.  You can also generate a color balance node instead.

Now when you put your layers together, the color range will match!  Better yet, the node setup is based on a scene-referred color space, so your color values are preserved.  You can sleep in peace, knowing that the hues and saturations are safe and sound.

"It looks so real!"

Whether you're adding a background image for your car model or compositing visual effects, you need a guarantee that your art will look real.  The Shot Matcher enables you to do just that: make your work feel more real to your audience.  And when it feels real, they can focus on the message you're trying to convey—not on the images you're trying to merge.


"Shot Matcher does a great job in helping you quickly set your brights and darks, which is essential in visual effects compositing. A simple to use, very handy tool!"

- Sean Kennedy, VFX Artist

Version History

1.1.0 (Nov 2019) - 2.80 compatible!  I also fixed a bug with empty images and render results for good measure. A few changes to the compositor functionality for clarification.

2.0.0 - The analysis panel is in the Movie Clip Editor!!  Also a UI facelift and optimizations.

2.1.0 - renamed the add-on from "Color Matching Analyzer" to "Shot Matcher" to be more correct to the terms of the film industry.

2.3.0 - UX and UI facelift, and alpha threshold option is available - allowing you to ignore transparent pixels.

3.0.0 (Jan 2020) - selecting video and image "layers" to use as background and foreground, new UI, and improved auto calculation!

3.1.0 (Feb 2020) - the color picker has live updates, so you can see when it's picking up new colors (it's pretty mesmerizing).

3.2.0 (March 2020) - saves layer settings per image and movie clip, allowing you to reuse settings for clips.  These settings also persist when you save and load projects.  If the image or movie clip is removed from the Blender project, the layer setting will delete itself on the next load of the file

3.3.1 (June 2020) - typical click-and-drag color picker finally works (no need to use the Ctrl key), now midtones can be analyzed (experimental).  Fixed a few errors from migrating to 2.83 stable build.

3.4.1 (March 2021) - optimized the video analyzer to be a little faster, plus some performance tweaks for the core analyzer. Added some error handling for Blender not reading pixels, as well as the ability to analyze the current video frame.

3.4.2 (January 2022) - after a long time, I finally figured out a future-proof way to calculate render results as a layer!! Warning: Through an API limitation, the render result can only be accessed if the newest render is viewed at least once in the Blender image editor. If not, it'll just give a standard pink. It can also mess with the memory if you run the analysis without looking at the render result. In short, just look at your new render at least once in the image editor, then you can analyze it as a layer. I know this is a rare use case, but wanted to make sure you were aware. Once bgl is deprecated and the gpu module in Blender is fully supported, I'll figure out a way to workaround this.

If there's issues, please contact me with the errors and steps to reproduce.

Sales 300+
Customer Ratings 3
Average Rating
Dev Fund Contributor
Published over 3 years ago
Software Version 2.79, 2.83, 2.9, 2.91, 2.92, 2.93, 3.0
License GPL
Have questions before purchasing?

Contact the Creator with your questions right now.

Login to Message