Home

Awesome

Color Fix functions for Vapoursynth

For example for transfering colors from one source to another, or fixing color shift from AI upscaling/restoration models. Also knows as Color Transfer or Color Matching sometimes.
Example fixing colors after upscaling a DVD: https://imgsli.com/MjM5NzM5/0/2

Requirements

Setup

Put the vs_colorfix.py file into your vapoursynth scripts folder.
Or install via pip: pip install git+https://github.com/pifroggi/vs_colorfix.git

<br />

Average Color Fix

Correct for color shift by matching the average color of a clip to that of a reference clip. This is a very fast way to transfer the colors from one clip to another that has the same or close to the same content, but different colors. Idea from chaiNNer.

import vs_colorfix
clip = vs_colorfix.average(clip, ref, radius=10, planes=[0, 1, 2], fast=False)

clip
Clip where the color fix will be applied to.
Any format, but recommended is a bit depth higher than 8 to avoid banding.

ref
Reference clip where the colors are taken from.
Any format, but recommended is a bit depth higher than 8 to avoid banding.

radius
Higher means a more global color match and wider bloom/bleed.
Lower means a more local color match and smaller bloom/bleed. Too low and the reference clip will become visible.
Test values 5 and 30 and this will become more clear.

planes (optional)
Which planes to color fix. Any unmentioned planes will simply be copied.
If nothing is set, all planes will be color fixed.

fast (optional)
To optimize your script for maximum speed. Will produce blocky artifacts with a low radius.
I found it useful for radius > 30 where artifacts are no longer noticable, or to fix something like a prefilter.

Wavelet Color Fix

Correct for color shift by first separating a clip into different frequencies (wavelets), then matching the average color to that of a reference clip. This works similarly to the Average Color Fix, but produces better results at the cost of more computation. Both clips must have close to the same content. The Wavelet Color Fix functions are from sd-webui-stablesr.

import vs_colorfix
clip = vs_colorfix.wavelet(clip, ref, wavelets=5, planes=[0, 1, 2], device="cpu")

clip
Clip where the color fix will be applied to.
Must be in YUV444PS, YUV444PH, RGBS, RGBH, GRAYS, or GRAYH format.

ref
Reference clip where the colors are taken from.
Must be in YUV444PS, YUV444PH, RGBS, RGBH, GRAYS, or GRAYH format.

wavelets
Number of wavelets, 5 seems to work best in most cases.
Higher means a more global color match and wider bloom/bleed.
Lower means a more local color match and smaller bloom/bleed. Too low and the reference clip will become visible.
Test values 3 and 10 and this will become more clear.

planes (optional)
Which planes to color fix. Any unmentioned planes will simply be copied.
If nothing is set, all planes will be color fixed.

device (optional)
"cpu" to use the CPU, or "cuda" to use an Nvidia GPU.
YUV444PH, RGBH, or GRAYH format will additionally double speed if the GPU supports fp16.

<br />

Tips & Troubleshooting

If your clips are not sufficiently aligned, try this: https://github.com/pifroggi/vs_align