Vapoursynth AddGrain
AddGrain adds random noise to luma and optionally chroma, to mask banding, keep some texture after strong denoising or give a film look. An optional adaptive mode puts the grain mainly into dark areas.
Filtering → Vapoursynth → Add Grain

What it does
A new noise pattern is added to every frame (unless Constant is set). Correlation makes neighbor noise values similar, which gives coarser, streaky grain but also lowers its visible strength. With the vs-noise implementation other noise types than Gaussian are available.
Requirements
- vs-noise (all platforms) or the AddGrain plugin (Linux/macOS); adaptivegrain for Adaptive.
Settings
| Control | Parameter | Range / values | Hybrid default | Meaning |
|---|---|---|---|---|
| Strength (V/U) | var / uvar | 0 – 1000 | 1.0 / 0 | Luma / chroma noise strength as a variance on the 8-bit scale; 0 = off. Chroma strength has no effect on gray and RGB clips. |
| Correlation (H/V) | hcorr / vcorr | 0 – 1 | 0 / 0 | Horizontal / vertical similarity of neighbor noise values. |
| Seed | seed | −1 – 1000 | −1 | 0 or higher selects a repeatable grain sequence. |
| Constant | constant | on/off | off | Same grain pattern on every frame. |
| Type | type | Gaussian, Perlin, Simplex, fBm, Poisson | Gaussian | vs-noise only: noise type (fBm = fractal Brownian motion). |
| Size (x/y) | xsize / ysize | 1 – 100 | 2.0 / 2.0 | vs-noise with Perlin, Simplex or fBm only: size of the noise pattern in pixels. Whole numbers sample Perlin noise on its grid points, where it is zero. |
| Adaptive | – | on/off | off | Weights the grain by brightness: more in dark areas, where banding shows, less in bright ones. |
| Luma scaling | luma_scaling | 0 – 100 | 12 | With Adaptive: higher values restrict the grain more to the shadows. |
| Tools: grain | – | noise, grain (Linux/macOS) | noise | Implementation; grain only makes Gaussian noise, so Type and Size are disabled with it. |
Example
Default settings on a 10-bit YUV 4:2:0 source (640x356):
# adding Grain using noise clip = core.noise.Add(clip)
How Hybrid calls it
- Works on integer and 32-bit float YUV, RGB and gray clips; with Adaptive only on integer YUV.
- The strength is given on the 8-bit scale; the plugin scales it to the bit depth itself.
- All options are only written when they differ from the defaults; Luma scaling is always written with Adaptive.
- With Adaptive, the grained clip is merged into the original through the adaptivegrain mask.
- In the default filter order AddGrain comes after the anti-aliasing and GLSL filters and before GrainFactory3 and FilmGrain (GLSL).
- AddGrain also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).
Background
vs-noise and AddGrain
vs-noise is the successor of the archived VapourSynth AddGrain plugin and adds Perlin, Simplex, fBm and Poisson noise. Its README notes that the correlation is implemented as exponential smoothing, so a higher correlation needs a higher strength for the same visible amount of grain; strong vertical correlation can look like rain.
adaptivegrain
adaptivegrain builds a gray mask from the luma of each frame (it needs the frame's average brightness, which Hybrid measures first). The mask is bright in dark areas, so grain goes there; Luma scaling shapes the curve.
Sources
- vs-noise
- VapourSynth-AddGrain
- adaptivegrain
- Hybrid's tooltips