Add filters (background blur, etc) to your webcam on Linux
Project description
webcam-filters
Add filters (background blur, etc) to your webcam on Linux.
Video conferencing applications tend to either lack video effects altogether or support only a limited set of capabilities on Linux (e.g. Zoom [1], Google Meets [2]).
Goal here is to provide a virtual webcam via v4l2loopback with a common set of filters that can be used everywhere.
Usage
Passthrough (no-op):
$ webcam-filters --input-dev /dev/video0 --output-dev /dev/video3
Blur background:
$ webcam-filters --input-dev /dev/video0 --output-dev /dev/video3 --background-blur 150
Dependencies
Other than the Python dependencies that can be automatically installed by Pip, there are a few system dependencies that require manual attention.
v4l2loopback
v4l2loopback kernel module is required to emulate a virtual webcam. See your distro’s docs or v4l2loopback on how to install and set it up (e.g. https://archlinux.org/packages/community/any/v4l2loopback-dkms/).
You’ll probably want to create at least one loopback device (that’s persistent on boot):
$ sudo tee /etc/modprobe.d/v4l2loopback.conf << "EOF" # /dev/video3 options v4l2loopback video_nr=3 options v4l2loopback card_label="Virtual Webcam" options v4l2loopback exclusive_caps=1 EOF $ sudo modprobe v4l2loopback $ v4l2-ctl --device /dev/video3 --info
Gstreamer
gstreamer-1.0 (e.g. https://archlinux.org/packages/extra/x86_64/gstreamer/)
gst-plugins-base (e.g. https://archlinux.org/packages/extra/x86_64/gst-plugins-base/)
gst-plugins-good (e.g. https://archlinux.org/packages/extra/x86_64/gst-plugins-good/)
gst-python (e.g. https://archlinux.org/packages/extra/x86_64/gst-python/)
Installation
Nix
The provided Nix package bundles all the necessary GStreamer dependencies and should “just work” on any distro.
Install a specific release version/tag:
$ nix-env --file https://github.com/jashandeep-sohi/webcam-filters/archive/refs/tag/v0.2.2.tar.gz --install
Install a specific branch (e.g. master):
$ nix-env --file https://github.com/jashandeep-sohi/webcam-filters/archive/refs/heads/master.tar.gz --install
Pipx/Pip
You can also use pipx or pip. Pipx is recommend to keep Python dependencies isolated. Keep in mind this will not install gst-python or any of the other GStreamer dependencies, so you’ll have to install that yourself.
Latest stable:
$ pipx install --system-site-packages webcam-filters $ # Or $ pip install --user webcam-filters
Latest pre-release:
$ pipx install --system-site-packages --pip-args='--pre' webcam-filters $ # Or $ pip install --user --pre webcam-filters
Git:
$ url="git+https://github.com/jashandeep-sohi/webcam-filters.git" $ pipx install --system-site-packages "$url" $ # Or $ pip install --user "$url"
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for webcam_filters-0.2.2a0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 982132f72f5fc67283c5977aca6f13ea0586b54a66d8814f771fc4e25ece72f8 |
|
MD5 | e54485f00dd8f63994a906fe91530477 |
|
BLAKE2b-256 | 4552b3f613756e1a50006d8eb96b133d1734f0a6950f8e443f895f2f5aa30edd |