videobeaux

Logo

The friendly multilateral video toolkit built for artists by artists.

View the Project on GitHub schwwaaa/videobeaux

blur_pix

Description

Applies a pixelated blur effect to the input video, producing a blocky, low-resolution softening reminiscent of censored footage, retro 8-bit graphics, or lo-fi compression artifacts.
This effect blends coarse pixelation with smooth blur, creating a stylized, abstracted visual aesthetic.

Purpose

blur_pix is designed for artists who want to:

Because the module has no program-specific arguments, it is simple to use and highly compatible with all Videobeaux pipelines.

How It Works

  1. Pixel Block Generation
    The input frame is reduced to coarse pixel clusters using an internal scaling or mosaic-based algorithm.
  2. Softening Pass
    A smoothing filter blends block edges to create a soft, dreamy, broken-resolution aesthetic.
  3. Unified Blur-Pixel Layer
    The combined effect emphasizes abstraction over clarity, often producing painterly motion.
  4. Encoding
    The final output is encoded using global Videobeaux codec settings (CRF, preset, pixel format, etc.).

Program Template

videobeaux -P blur_pix \
  -i input.mp4 \
  -o output.mp4

Arguments

Real World Example

videobeaux -P blur_pix \
  -i myvideo.mp4 \
  -o blur_pix_styled.mp4

Program Output

Technical Notes

Quality Tips