This project allows to apply filters while using your computer's webcam. It can be used with any third party live streaming or video chat applications (eg. Zoom, Hangout, Skype, etc.) by selecting the virtual video device as your webcam device.
Current set of filters available through keyboard keys:
- face blurring (
b
) - reactions (
a
,)
) - text (
t
)
sudo apt install v4l2loopback-dkms python3-opencv python3-construct
sudo modprobe v4l2loopback exclusive_caps=1
./cameo.py
- Error:
GStreamer warning: Cannot query video position
- If you get this error, try uninstalling
python3-opencv
and install opencv-python with pip instead. - Also, using a dedicated venv for cameo might help.
- If you get this error, try uninstalling
- Error:
OSError: [Errno 22] Invalid argument
- This can be caused whenever the wrong output is used.
- Try using another output device as described here.
- This can be caused whenever the wrong output is used.
- List available webcams:
v4l2-ctl --list-devices
- List supported formats:
v4l2-ctl --list-formats
- Display a webcam with VLC:
vlc v4l2:///dev/video1
- Stream a MP4:
ffmpeg -re -i /tmp/video1.mpeg -f v4l2 /dev/video1