Practical overview
When it fits
Use Backscrub when you want background replacement at the virtual-camera level so the processed feed can be selected in video software rather than relying on a meeting app's own effect.
Who it is for
- Linux users who want a replacement-background camera feed for video calls.
- Developers or technically confident users able to build C++ software and configure V4L2 devices.
Documented uses
- Separate a person from the camera scene using semantic segmentation.
- Composite a wallpaper image behind the person.
- Expose processed video as a virtual camera input for conferencing or capture applications.
Requirements & limits
The repository is public and licensed under Apache-2.0. The documented build and usage instructions target Linux.
- The workflow depends on the V4L2 loopback kernel module as well as the Backscrub application.
- The README lists tested Ubuntu and dependency versions and examples of specific conferencing and capture software versions.
- The project documents a CMake build path; its root-directory make-based build is marked deprecated.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Build and start a Backscrub virtual camera
Build the C++ project and launch it with a camera input, V4L2 virtual device and replacement wallpaper.
Before you start
- Linux system with OpenCV development files, build tools, v4l2loopback-dkms and curl.
- Git and CMake.
- A camera device, a wallpaper image and permission to load the V4L2 loopback kernel module.
Steps
Install the listed dependencies and clone the repository recursively.
Create a build directory, enter it, then run
cmake ..followed by the command below.make -j $(nproc || echo 4)Load the v4l2loopback module with a virtual device, as in the README example.
Run the built
backscrubexecutable with-cfor the camera device,-vfor the virtual device and-bfor the wallpaper path.
Expected outcome
A virtual camera feed carrying the camera video with a replacement background, available to applications that can select that device.
Guide limitations
- The README's tested configurations are Ubuntu 18.04.5 and 20.04 on x86-64 with specified dependency versions.
- Some cameras may require the
-f MJPGoption for higher resolutions. - The listed conferencing and capture application versions are specific examples, not a compatibility guarantee.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 7 November 2026
- Original website title
- floe/backscrub · Official homepage title · retained in its source language

