{"id":28272650,"url":"https://github.com/royshil/obs-backgroundremoval","last_synced_at":"2026-10-18T20:07:59.052Z","repository":{"id":37953925,"uuid":"358081783","full_name":"royshil/obs-backgroundremoval","owner":"royshil","description":"An OBS plugin for removing background in portrait images (video), making it easy to replace the background when recording or streaming.","archived":false,"fork":false,"pushed_at":"2026-10-16T23:35:36.000Z","size":216094,"stargazers_count":4622,"open_issues_count":17,"forks_count":293,"subscribers_count":38,"default_branch":"main","last_synced_at":"2026-10-17T06:41:15.742Z","etag":null,"topics":["background-segmentation","computer-vision","image-segmentation","libobs","mac-osx","obs","obs-plugin","obs-studio","obs-studio-plugin","obsproject","onnx","onnx-runtime","onnxruntime","onnxruntime-gpu","plugin","video-segmentation"],"latest_commit_sha":null,"homepage":"https://royshil.github.io/obs-backgroundremoval/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/royshil.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"accessibility":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null},"funding":{"github":["royshil","umireon"]}},"created_at":"2021-04-15T00:44:35.000Z","updated_at":"2026-10-17T06:15:21.000Z","dependencies_parsed_at":"2026-10-17T04:18:24.252Z","dependency_job_id":null,"html_url":"https://github.com/royshil/obs-backgroundremoval","commit_stats":{"total_commits":310,"total_committers":25,"mean_commits":12.4,"dds":0.5483870967741935,"last_synced_commit":"00576b987bf351de9013e0e89f646c5f7682e69c"},"previous_names":["obs-ai/obs-backgroundremoval","occ-ai/obs-backgroundremoval","royshil/obs-backgroundremoval","locaal-ai/obs-backgroundremoval"],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/royshil/obs-backgroundremoval","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/royshil%2Fobs-backgroundremoval","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/royshil%2Fobs-backgroundremoval/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/royshil%2Fobs-backgroundremoval/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/royshil%2Fobs-backgroundremoval/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/royshil","download_url":"https://codeload.github.com/royshil/obs-backgroundremoval/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/royshil%2Fobs-backgroundremoval/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38333073,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-17T02:00:06.547Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["background-segmentation","computer-vision","image-segmentation","libobs","mac-osx","obs","obs-plugin","obs-studio","obs-studio-plugin","obsproject","onnx","onnx-runtime","onnxruntime","onnxruntime-gpu","plugin","video-segmentation"],"created_at":"2025-05-21T00:05:25.216Z","updated_at":"2026-10-18T20:07:59.043Z","avatar_url":"https://github.com/royshil.png","language":"C++","funding_links":["https://github.com/sponsors/royshil","https://github.com/sponsors/umireon","https://github.com/sponsors/royshil?frequency=one-time"],"categories":["C++","HarmonyOS","computer-vision"],"sub_categories":["Windows Manager"],"readme":"\u003c!--\nSPDX-FileCopyrightText: 2021-2026 Roy Shilkrot \u003croy.shil@gmail.com\u003e\nSPDX-FileCopyrightText: 2023-2026 Kaito Udagawa \u003cumireon@kaito.tokyo\u003e\n\nSPDX-License-Identifier: GPL-3.0-or-later\n--\u003e\n\n# OBS Plugin: Portrait Background Removal / Virtual Green-screen and Low-Light Enhancement\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub](https://img.shields.io/github/license/royshil/obs-backgroundremoval)](https://github.com/royshil/obs-backgroundremoval/blob/main/LICENSE)\n[![Push (main) CI](https://github.com/royshil/obs-backgroundremoval/actions/workflows/push-main.yml/badge.svg)](https://github.com/royshil/obs-backgroundremoval/actions/workflows/push-main.yml)\n[![Total downloads](https://img.shields.io/github/downloads/royshil/obs-backgroundremoval/total)](https://github.com/royshil/obs-backgroundremoval/releases)\n![Flathub](https://img.shields.io/flathub/downloads/com.obsproject.Studio.Plugin.BackgroundRemoval?label=Flathub%20Installs)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/royshil/obs-backgroundremoval)](https://github.com/royshil/obs-backgroundremoval/releases)\n\n\u003c/div\u003e\n\nA plugin for [OBS Studio](https://obsproject.com/) that allows you to replace the background in portrait images and video, as well as enhance low-light scenes.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://royshil.github.io/obs-backgroundremoval/\"\u003e\n    \u003cb\u003e⬇️ Download \u0026 Install OBS Background Removal ⬇️\u003c/b\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nOr, browse versions on [releases page](https://github.com/royshil/obs-backgroundremoval/releases).\n\n\u003e Not working? Please try [the Lite version (Live Background Removal Lite)](https://github.com/kaito-tokyo/live-backgroundremoval-lite) developed by one of us (Kaito Udagawa).\n\n## Usage\n\n\u003cdiv style=\"text-align:center;\"\u003e\n\u003cvideo src=\"https://github.com/royshil/obs-backgroundremoval/assets/1067855/5ba5aae2-7ea2-4c90-ad45-fba5ccde1a4e\" width=\"320\"\u003e\u003c/video\u003e\n\u003c/div\u003e\n\nCheck out the [usage guide page](https://royshil.github.io/obs-backgroundremoval/usage/) for usage walkthrough and recommendations.\n\nAdditional tutorial videos:\n\n- [▶︎ Official guide to the Background Removal plugin for OBS Studio on YouTube](https://www.youtube.com/playlist?list=PLfd4SnaQQz_DVr_18OQozucYmiC56rRhy)\n- Depth of Field effect: https://youtu.be/jC3EKSpNjQk\n- Low-light enhancement: https://youtu.be/WSBLYWFrn2Q\n- Remove background from ANY object (not just human): https://youtu.be/N74VCDCToX8\n\n## How to build from source\n\n**Windows**:\n\n```pwsh\ngit clone https://github.com/royshil/obs-backgroundremoval.git\n```\n\n**Platforms we support building from source officially:**\n\n```\ngit clone https://github.com/royshil/obs-backgroundremoval.git\ncd obs-backgroundremoval\nsudo ./bin/bootstrap\n./bin/setup\n./bin/build\nsudo dpkg -i release/obs-backgroundremoval-*-linux-gnu.deb\n```\n\nThe supported platforms are:\n\n- Debian Forky (x86_64 and arm64)\n\nWe plan to add building scripts for popular platforms such as Windows, Mac, and various distributions of Linux.\n\n## Introduction\n\nThis plugin is meant to make it easy to replace the background in portrait images and video.\nIt is using a neural network to predict the mask of the portrait and remove the background pixels.\nIt's easily composable with other OBS plugins to replace the background with e.g. an image or\na transparent color.\n\nIf you like this work, which is given to you completely free of charge, please consider supporting it by sponsoring us on GitHub:\n\n- https://github.com/sponsors/royshil\n- https://github.com/sponsors/umireon\n\n### Support and Help\n\nReach out to us on [GitHub Discussions](https://github.com/royshil/obs-backgroundremoval/discussions) or the [OBS Plugins forum](https://obsproject.com/forum/resources/background-removal-portrait-segmentation.1260/) for online / immediate help.\n\nIf you found a bug or want to suggest a feature or improvement please open an [issue](https://github.com/royshil/obs-backgroundremoval/issues).\n\nIf you are looking for hands-on help or private consultation please select a [sponsorship tier](https://github.com/sponsors/royshil?frequency=one-time).\n\n### Technical Details\n\nGPU support:\n\n- On Windows, we plan to support WinML acceleration.\n- 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.\n- 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.\n- The goal of this plugin is to be available for everyone on every system, even if they don't own a GPU.\n\nNumber of CPU threads is controllable through the UI settings. A 2-thread setting works best.\n\nThe pretrained model weights used for portrait foreground segmentation are taken from:\n\n- https://github.com/anilsathyan7/Portrait-Segmentation/tree/master/SINet\n- https://github.com/PaddlePaddle/PaddleSeg/tree/release/2.7/contrib/PP-HumanSeg\n- https://github.com/PINTO0309/PINTO_model_zoo/tree/main/082_MediaPipe_Meet_Segmentation\n- https://github.com/PeterL1n/RobustVideoMatting\n- https://github.com/PINTO0309/PINTO_model_zoo/tree/main/384_TCMonoDepth and https://github.com/yu-li/TCMonoDepth\n\nImage enhancement (low light) models are taken from:\n\n- https://github.com/PINTO0309/PINTO_model_zoo/tree/main/213_TBEFN\n- https://github.com/PINTO0309/PINTO_model_zoo/tree/main/372_URetinex-Net\n- https://github.com/PINTO0309/PINTO_model_zoo/tree/main/370_Semantic-Guided-Low-Light-Image-Enhancement\n\nSome 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/\n\n### Code Walkthrough\n\nThis video on YouTube will take you through the major parts of the code and explain them.\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://youtu.be/iFQtcJg0Wsk\" target=\"_blank\"\u003e\n    \u003cimg width=\"50%\" src=\"https://img.youtube.com/vi/iFQtcJg0Wsk/maxresdefault.jpg\"/\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n## Download Trends and Star History\n\n\u003cdiv align=\"center\"\u003e\n\n![Download Trends](docs/download-trends.svg)\n![GitHub Star History](docs/star-history.svg)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froyshil%2Fobs-backgroundremoval","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froyshil%2Fobs-backgroundremoval","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froyshil%2Fobs-backgroundremoval/lists"}