Skip to main content

AddNoise

AddNoise generates film like noise or other effects (like rain) by adding random noise to a video clip. This noise may optionally be horizontally or vertically correlated to cause streaking.

Original https://github.com/HomeOfVapourSynthEvolution/VapourSynth-AddGrain ported from AviSynth plugin http://forum.doom9.org/showthread.php?t=111849

ref type=0 type=1 type=2 type=3 type=4

Installation

pip install vsnoise

Or Releases for Windows builds

Then it can be used normally

import vapoursynth as vs
vs.core.noise.Add(...)

Usage

noise.Add(vnode clip[, int type=0, float var=1.0, float uvar=0.0, float hcorr=0.0, float vcorr=0.0, float xsize = 2.0, float ysize = 2.0, int seed=-1, int constant=False, int every=1, int opt=0])
  • clip: Clip to process. Any format with either integer sample type of 8-16 bit depth or float sample type of 32 bit depth is supported.

  • type: Type of noise.

    • 0 = Gaussian
    • 1 = Perlin
    • 2 = Simplex
    • 3 = Fractional Brownian Motion over simplex
    • 4 = Poisson
      • Use var to control "sensitivity"
      • Should be used for intensity (Y for YUV) or RGB
  • var, uvar: The variance (strength) of the luma and chroma noise, 0 is disabled. uvar does nothing for GRAY and RGB formats.

  • hcorr, vcorr: Horizontal and vertical correlation, which causes a nifty streaking effect. Only for Gaussian noise. Range 0.0-1.0.

  • xsize, ysize: size of Perlin and Simplex noise. Less than 2 for Perlin may generate visible boundaries.

  • seed: Specifies a repeatable noise sequence. Set to at least 0 to use.

  • constant: Specifies a constant noise pattern on every frame.

  • every: Specify the period of frames for each noise pattern.

  • opt: Sets which cpu optimizations to use.

    • 0 = auto detect
    • 1 = use c
    • 2 = use sse2
    • 3 = use avx2
    • 4 = use avx512

The correlation factors are actually just implemented as exponential smoothing which give a weird side affect that I did not attempt to adjust. But this means that as you increase either corr factor you will have to also increase the stddev (noise amount) in order to get the same visible amount of noise, since it is being smooth out a bit.

Increase both corr factors can somewhat give clumps, or larger noise size.

And there is an interesting effect with, say, noise.Add(var=800, vcorr=0.9) or any huge amount of strongly vertical noise. It can make a scene look like it is raining.

Compilation

meson build
ninja -C build
ninja -C build install

Metadata

Release files for vsnoise 1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vsnoise 1.3
File Size Uploaded Provenance Actions
vsnoise-1.3.tar.gz 275.8 kB With provenance Details for vsnoise-1.3.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for vsnoise 1.3
File Actions
vsnoise-1.3-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for vsnoise-1.3-py3-none-win_amd64.whl
vsnoise-1.3-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for vsnoise-1.3-py3-none-musllinux_1_2_x86_64.whl
vsnoise-1.3-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for vsnoise-1.3-py3-none-musllinux_1_2_aarch64.whl
vsnoise-1.3-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for vsnoise-1.3-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
vsnoise-1.3-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64, Linux glibc 2.27+ ARM64 Details for vsnoise-1.3-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
vsnoise-1.3-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for vsnoise-1.3-py3-none-macosx_11_0_arm64.whl
vsnoise-1.3-py3-none-macosx_10_13_x86_64.whl Python 3 none macOS 10.13+ x86-64 Details for vsnoise-1.3-py3-none-macosx_10_13_x86_64.whl

Total release size: 2.8 MB

Release files / vsnoise-1.3.tar.gz

Download URL vsnoise-1.3.tar.gz
Size 275.8 kB
Tags Source
SHA-256 checksum
How to use checksums
de422d79a13b06708b1664135abf1a004d8a8462c40c7495e28a667c950ad678
BLAKE2b-256 checksum
How to use checksums
b438ba27b8d6bef87f7999a56a21e74a6781f3f0ebd556a72fdffd87e43d0605
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / vsnoise-1.3-py3-none-win_amd64.whl

Download URL vsnoise-1.3-py3-none-win_amd64.whl
Size 31.9 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
39201f4c0ed11d4d3f44e4106a039831ae1e72b57a1fa45a313a13369267d779
BLAKE2b-256 checksum
How to use checksums
e9b274caf326050f8ae03d8a6e24f810d5cca36f31f18dba5a77eb0c26a8eb02
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / vsnoise-1.3-py3-none-musllinux_1_2_x86_64.whl

Download URL vsnoise-1.3-py3-none-musllinux_1_2_x86_64.whl
Size 1.1 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
4b8da76ecc987e7435b90c3fbc9db02562de7323566fef74008ee1dd84eaeaa3
BLAKE2b-256 checksum
How to use checksums
6fab62b2135c40231b8f71c48c402c28e0569f2d11c62ef8ec366d4146819110
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / vsnoise-1.3-py3-none-musllinux_1_2_aarch64.whl

Download URL vsnoise-1.3-py3-none-musllinux_1_2_aarch64.whl
Size 1.0 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
0365225e4f6a866ec51934c4c54be93e490f9d5d2de47720af6f51ac5d85c480
BLAKE2b-256 checksum
How to use checksums
0e311cc901d16e72c69f010b7fcb2ecb2dac26e3f5c3c497d2f93df85be1647d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / vsnoise-1.3-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL vsnoise-1.3-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 198.6 kB
Tags Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
35cc606ef085cd140d62108023f30c16e9dddcea91f23c074cf798db520d66db
BLAKE2b-256 checksum
How to use checksums
e386497a531cc75061b609790542de3816cf61e8a902201aa0df909b75f583f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / vsnoise-1.3-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl

Download URL vsnoise-1.3-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Size 183.4 kB
Tags Linux glibc 2.27+ ARM64 Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
0a9c7b416ac7969937a68acdb9e1c3d02f02e55ec187117db51f727127533ac5
BLAKE2b-256 checksum
How to use checksums
5e5ed1a6016638bd4ca999b91f820a03c0f62ae04b2b57172bb038075470415d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / vsnoise-1.3-py3-none-macosx_11_0_arm64.whl

Download URL vsnoise-1.3-py3-none-macosx_11_0_arm64.whl
Size 32.2 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
a5c817376a4200428ad896e503cb3a502c59692281f7e7982eb5bd1144eda971
BLAKE2b-256 checksum
How to use checksums
2be493d3829982394444f5031c3af370eaafae10d64474b1f8ac06b2ff809e69
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Release files / vsnoise-1.3-py3-none-macosx_10_13_x86_64.whl

Download URL vsnoise-1.3-py3-none-macosx_10_13_x86_64.whl
Size 36.5 kB
Tags Python 3 macOS 10.13+ x86-64
SHA-256 checksum
How to use checksums
b511e13ffd61ea9a894a62ce0b1ae25b8b6999c82f4d831434d9b9309c2c49eb
BLAKE2b-256 checksum
How to use checksums
a3d0b9b095d7fa8650aafce540810e8de1ea86f6d2b19986993aa9d26fdc42e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

Security for vsnoise 1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 8 files in this release have been uploaded with provenance metadata.

Select from 8 files

Attestation for vsnoise-1.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page