ffmpeg-compose-mask

What problem does it solve?

Advanced ffmpeg-based masking and compositing that enables pixel-precise control of video through masks, alpha channels, and per-plane operations.

Core Features & Use Cases

• Masked compositing through maskedmerge for three inputs: two sources plus a grayscale mask
• Alpha plumbing with alphamerge and alphaextract to attach or extract alpha channels
• Plane-level operations with extractplanes, mergeplanes, and shuffleplanes
• Per-channel effects such as rgbashift for chromatic aberration and selective channel manipulation
• Spatial blending and overlay capabilities using the blend filter across two inputs
• Procedural and region-based edits with displace, floodfill, and hysteresis
• A lightweight script wrapper (scripts/compose.py) to build and run the appropriate ffmpeg filter graphs
• Reference docs available at references/filters.md for deeper technical guidance

Quick Start

Provide the input videos and a grayscale mask, then run the desired operation with the compose.py script (for example mask-merge or alphamerge) to generate the output.