Repository navigation
LocalBG v1.1.0
Added
Edge Despill (Pro)
- New Despill slider (0–100%) that removes residual background color bleeding into fine detail (hair, fur, translucent fabric, motion-blurred edges) after the cutout has been generated.
- Works in two stages:
- Foreground reconstruction via pymatting's multi-level foreground estimator. Recovers the true foreground colors from the source image and alpha matte, replacing the cutout's RGB.
- Spill projection detects the dominant background color from low-alpha pixels and actively pushes the foreground colors away from that direction in RGB space. This is what gives 100% a noticeably stronger bite than matting alone.
- The effect tapers off in the solid interior of the subject so natural colors are preserved.
- Available in the GUI and via
--despill 0..100on the CLI.
New Shadow Styles (Pro)
The shadow control is no longer a single look. Pick the style that fits the asset:
- Classic – downward offset only. The original LocalBG behavior; good for product shots and isolated subjects that need to "sit" on a surface.
- GIMP-style – diagonal drop shadow (equal X/Y offset). Resembles the default GIMP/Photoshop drop-shadow direction.
- Soft glow – uniform blur of the silhouette with no directional offset. Best for stickers, edge-to-edge subjects, or anywhere a directional shadow would cause artifacts.
The strength slider (0–100%) drives blur radius and offset together so a single control moves both.
- GUI: Shadow row dropdown.
- CLI:
--shadow-type classic|gimp-style|soft.
ProRes 4444 Video Export with Real Alpha
- Videos can now be exported as MOV (ProRes 4444) with a real 10-bit alpha channel (
yuva444p10le), produced via a bundled ffmpeg pipeline. - Before, transparent video output had to fall back to a green chroma key inside an MP4 (because libx264 has no alpha plane). Editors then had to key the green out, which left edge artifacts and destroyed sub-pixel detail.
- ProRes 4444 carries the alpha plane straight to your editor of choice. DaVinci Resolve, Premiere Pro, After Effects, and Final Cut all read it natively, no keying step required.
- Source audio is preserved and re-encoded as AAC.
- MP4 with green chroma-key output remains available for backwards compatibility.
- WebM/VP9 was considered and rejected: the bundled ffmpeg's libvpx-vp9 wrapper sets the
alpha_modemetadata but discards the alpha plane during encode. - GUI: Video format → MOV (ProRes 4444).
- CLI:
--video-format mov-prores.
Custom Backgrounds for Videos
Video exports now support the same background choices that images do:
-
Custom color – pick any hex color and composite the subject onto a solid background, per frame.
-
Background image – load a still image and use it as the backdrop for the whole clip. The image is preloaded once and resized per frame to match the video dimensions.
-
Blur – produce a background-blurred version of the source video, with the subject sharp on top. Useful for talking-head and product videos where you want the original scene context but de-emphasized.
-
GUI: the existing Background dropdown now applies to video files too.
-
CLI:
--background custom|image|blur(with--bg-color,--bg-image, or--blur-strengthas relevant) now accepts video inputs.