Repolode
Submit
royshil

royshil/obs-backgroundremoval

An OBS Studio plugin that removes or replaces the background of people in video using neural-network portrait segmentation, plus low-light enhancement.

Open-source alternative to:NVIDIA Broadcast

View on GitHubWebsite
Stars
4,630
Forks
294
Open issues
12
Last commit
10 hours ago

What is it?

OBS Background Removal is a plugin for OBS Studio that predicts a mask of a person in each video frame and removes the background pixels. The result can be composed with other OBS sources, such as an image or a transparent color, which makes it useful for virtual green-screen effects without a physical backdrop.

The plugin runs its segmentation models through ONNX Runtime. On macOS it can use CoreML acceleration, and on Linux it supports CUDA, ROCm and MIGraphX when built from source. Users can control the number of CPU threads in the settings, and the project aims to work on machines without a GPU. Recent versions also include a low-light enhancement filter and a depth-of-field effect.

The project provides a download page and release builds, with source build instructions currently officially covering Debian. Windows support for WinML acceleration is listed as planned.

Key features

  • 01Replaces or removes the background behind a person in OBS video sources.
  • 02Runs segmentation models via ONNX Runtime.
  • 03Supports CoreML on macOS and CUDA, ROCm and MIGraphX on Linux when built from source.
  • 04Adjustable CPU thread count for machines without a GPU.
  • 05Includes low-light enhancement and depth-of-field filters.

Use cases

  • Streaming or recording without a physical green screen.
  • Placing a presenter over a custom image or video background.
  • Improving image quality in dim recording environments.

Quick start

  1. 1

    Download and install the plugin from the project's download page or releases page

  2. 2

    Clone the repository to build from source

    git clone https://github.com/royshil/obs-backgroundremoval.git
  3. 3

    Run the bootstrap script from the repository root (officially supported on Debian Forky)

    sudo ./bin/bootstrap
  4. 4

    Run the setup script, then the build script, and install the resulting .deb package

    ./bin/setup

Things to know

  • Officially supported source build is only for Debian Forky; scripts for Windows, Mac and other Linux distributions are not yet provided.
  • On Mac, Intel and Apple Silicon binaries cannot be mixed; Rosetta 2 translation is not supported.
  • Licensed under GPL-3.0, a copyleft license that requires derivative works to be distributed under the same terms.

Topics

#obs-plugin#background-removal#image-segmentation#onnx#computer-vision#streaming#video#background-segmentation#libobs#mac-osx

FAQ

What is obs-backgroundremoval?
An OBS Studio plugin that removes or replaces the background of people in video using neural-network portrait segmentation, plus low-light enhancement. OBS Background Removal is a plugin for OBS Studio that predicts a mask of a person in each video frame and removes the background pixels. The result can be composed with other OBS sources, such as an image or a transparent color, which makes it useful for virtual green-screen effects without a physical backdrop.
Is obs-backgroundremoval free to use? What license does it have?
obs-backgroundremoval is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is obs-backgroundremoval still maintained?
Actively maintained. The last commit to obs-backgroundremoval was on Oct 22, 2026.
What can I use obs-backgroundremoval for?
Streaming or recording without a physical green screen. Placing a presenter over a custom image or video background. Improving image quality in dim recording environments.
How do I install obs-backgroundremoval?
Download and install the plugin from the project's download page or releases page Clone the repository to build from source: git clone https://github.com/royshil/obs-backgroundremoval.git Run the bootstrap script from the repository root (officially supported on Debian Forky): sudo ./bin/bootstrap Run the setup script, then the build script, and install the resulting .deb package: ./bin/setup
Where can I get obs-backgroundremoval?
The source code and installation instructions are on GitHub: https://github.com/royshil/obs-backgroundremoval

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects