登录

obs-backgroundremoval

royshilGPL-3.0活跃维护

OBS 直播/录屏插件，用 ONNX Runtime 做实时人像背景分割，一键抠掉摄像头背景换成任意画面。

An OBS plugin for removing background in portrait images (video), making it easy to replace the background when recording or streaming.

1.4.1发布于 2026-07-26 07:35 UTC4,687star +16 / 7 天301fork同步于 2026-11-10 17:38 UTC
背景分割OBS插件人像抠图实时分割ONNX推理
对比 GitHub 官网background-segmentationcomputer-visionimage-segmentationlibobsmac-osx

怎么上手

由 README 提炼，执行前请确认
原文 
git clone https://github.com/royshil/obs-backgroundremoval.git
cd obs-backgroundremoval
sudo ./bin/bootstrap
./bin/setup
./bin/build
sudo dpkg -i release/obs-backgroundremoval-*-linux-gnu.deb
硬件要求按 README 说明

README 未给出具体显存要求；目标是在没有 GPU 的系统上也能用，CPU 可跑。Mac 支持 CoreML 加速（Apple Silicon 高效，不支持 Rosetta2 跨架构）；Linux 从源码构建时支持 CUDA、MIGraphX，ROCM 自 ONNX Runtime 1.23.0 起被移除。

支持 Apple Silicon需要 CUDA支持 ROCm / AMD
下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼
没人工点评？写下你的经验

OBS 插件，用神经网络抠掉人像背景，直播录屏时一键换背景

OBS 直播/录屏插件，用 ONNX Runtime 做实时人像背景分割，一键抠掉摄像头背景换成任意画面。

核心能力

  • 用神经网络预测人像掩码并去除背景像素
  • 可与其它 OBS 插件组合替换成图片或透明色
  • 内置低光照增强模型改善暗场景画面
  • UI 可调 CPU 线程数，2 线程效果最佳
  • Mac 上用 CoreML 加速，Apple Silicon 上高效

容易踩的坑

官方源码构建脚本目前只支持 Debian Forky（x86_64 和 arm64），Windows/Mac 构建脚本尚在计划中；Linux 上要用 CUDA/MIGraphX 加速需自行从源码构建并确保 ONNX Runtime 带对应支持；Apple Silicon 上不能靠 Rosetta2 转译运行，跨架构二进制会崩溃。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本1.4.1
全部 release
  1. 1.5.01.5.0: OBS 32+ and Fix deb packagespre-release2026-08-30 · 2026-08-30 14:49 UTC
    查看更新说明
    • OBS 32 or later is required from version 1.5.0
    • A first-run About dialog is shown after installation or update
    • Debian and Ubuntu packaging has been overhauled
    • INSTALL.html is included in the Windows ZIP

  2. 1.4.11.4.1: OpenCV 5 compatibility and Debian最新正式版2026-07-26 · 2026-07-26 07:35 UTC

    What's Changed

    • OpenCV 5 compatibility
    • Debian

    See also the Official Documentation for installing our plugin into your OBS Studio on Windows, macOS, or Linux.

  3. 1.4.01.4.0: Maintaining High Standards for Supply Chain Securitypre-release2026-04-07 · 2026-04-07 13:10 UTC
    查看更新说明

    We confirmed that this release have critical issues for video quality. Please wait for a next release if you are not a developer.

    We're proud to provide our plugin's users with the highest security.

    What's Changed

    • Renew CI/CD workflows for SLSA (Supply-chain Levels for Software Artifacts) compliance
    • Clarify the contributing rules so that everyone can join our development
    • Conform to new OBS standards such as ProgramData installation in Windows and manifest.json for Plugin Manager.

    See also the Official Documentation for installing our plugin into your OBS Studio on Windows, macOS, or Linux.

    What's Changed

    New Contributors

  4. 1.3.7OBS Background Removal 1.3.72026-02-25 · 2026-02-25 22:22 UTC
    查看更新说明

    New installation for Windows, and statically linked ONNX Runtime

    Full Changelog: https://github.com/royshil/obs-backgroundremoval/compare/1.3.6...1.3.7

  5. 1.3.6OBS Background Removal 1.3.62026-01-25 · 2026-01-25 13:28 UTC
    查看更新说明

    MIGraphX, new model, new option!

    • Add MIGraphX execution provider (#740)
    • Add MediaPipe multi-class selfie segmentation model (#742)
    • Add option to keep the filter enabled when scene becomes inactive (#747)
    • Fix wolfSSL not to crash (#735)
    • Fix AVX2 not to be required for better compatibility (#754)
    • Add link to the Lite version (#753)

    Thank you for your all the feedback!

用户点评

登录用户的真实使用记录，可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译
    在 GitHub 打开

    OBS Plugin: Portrait Background Removal / Virtual Green-screen and Low-Light Enhancement

    GitHub Push (main) CI Total downloads Flathub GitHub release (latest by date)

    A plugin for OBS Studio that allows you to replace the background in portrait images and video, as well as enhance low-light scenes.

    Or, browse versions on releases page.

    Not working? Please try the Lite version (Live Background Removal Lite) developed by one of us (Kaito Udagawa).

    Usage

    Check out the usage guide page for usage walkthrough and recommendations.

    Additional tutorial videos:

    How to build from source

    Windows:

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

    Platforms we support building from source officially:

    git clone https://github.com/royshil/obs-backgroundremoval.git
cd obs-backgroundremoval
sudo ./bin/bootstrap
./bin/setup
./bin/build
sudo dpkg -i release/obs-backgroundremoval-*-linux-gnu.deb

    The supported platforms are:

    • Debian Forky (x86_64 and arm64)

    We plan to add building scripts for popular platforms such as Windows, Mac, and various distributions of Linux.

    Introduction

    This plugin is meant to make it easy to replace the background in portrait images and video. It is using a neural network to predict the mask of the portrait and remove the background pixels. It's easily composable with other OBS plugins to replace the background with e.g. an image or a transparent color.

    If you like this work, which is given to you completely free of charge, please consider supporting it by sponsoring us on GitHub:

    Support and Help

    Reach out to us on GitHub Discussions or the OBS Plugins forum for online / immediate help.

    If you found a bug or want to suggest a feature or improvement please open an issue.

    If you are looking for hands-on help or private consultation please select a sponsorship tier.

    Technical Details

    GPU support:

    • On Windows, we plan to support WinML acceleration.
    • On Mac we support CoreML for acceleration, which is efficient on Apple Silicon. Note: This plugin does not support cross-architecture translation (Rosetta2). Intel binaries on Apple Silicon or Apple Silicon binaries on Intel will crash.
    • On Linux CUDA, ROCM (deprecated in ONNX Runtime 1.23.0), and MIGraphX are supported if this plugin is built from source. Ensure your ONNX Runtime installation has CUDA, ROCM, or MIGraphX support. For AMD GPUs, MIGraphX is recommended as ROCM was removed from ONNX Runtime starting with version 1.23.0.
    • The goal of this plugin is to be available for everyone on every system, even if they don't own a GPU.

    Number of CPU threads is controllable through the UI settings. A 2-thread setting works best.

    The pretrained model weights used for portrait foreground segmentation are taken from:

    Image enhancement (low light) models are taken from:

    Some more information about how I built it: https://www.morethantechnical.com/2021/04/15/obs-plugin-for-portrait-background-removal-with-onnx-sinet-model/ and https://www.morethantechnical.com/2023/05/20/building-an-obs-background-removal-plugin-a-walkthrough/

    Code Walkthrough

    This video on YouTube will take you through the major parts of the code and explain them.

    Download Trends and Star History

    Download Trends GitHub Star History

    相关项目

    同分类里 star 最高的项目
    对比全部 →
    ultralytics
    ultralytics·Python

    YOLO 系列官方实现库，一套 PyTorch 代码覆盖目标检测、实例与语义分割、图像分类、姿态估计和目标跟踪，训练到部署全流程打通。

    目标检测+4检测 / 分割
    63281+9812kv8.4.2082026-11-10 15:51 UTC
    yolov5
    ultralytics·Python

    基于 PyTorch 的目标检测全家桶，覆盖训练、推理、实例分割、图像分类和模型导出，开箱即用，适合快速落地视觉任务。

    目标检测+4检测 / 分割
    58260+717kv7.02026-11-07 16:59 UTC
    pytorch-image-models
    huggingface·Python

    收录最全的 PyTorch 图像骨干网络合集，涵盖 ResNet、ViT、ConvNeXt 等主流模型，自带训练、评估、推理和导出脚本及预训练权重，省去自己搭网络和找权重的麻烦。

    图像分类+4检测 / 分割
    37273+85.2kv1.0.312026-11-07 23:22 UTC
    detectron2
    facebookresearch·Python

    Detectron2 是 Facebook 开源的目标检测与分割平台，提供模块化架构和丰富预训练模型，方便快速搭建和训练视觉识别任务。

    目标检测+4检测 / 分割
    34981+67.9kv0.62026-10-27 09:21 UTC