Skip to content

LocalBG v1.1.0

Choose a tag to compare

@urmandalabs urmandalabs released this 13 May 09:59
· 3 commits to main since this release
c540162

Added

Edge Despill (Pro)

Schermafbeelding 2026-05-13 103702
  • 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..100 on 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_mode metadata 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-strength as relevant) now accepts video inputs.