During last weeks I’ve been playing with Open Broadcaster Software (OBS) Studio, or simply OBS. An awesome free, open source software project, that among many other things allow to build to custom scenes to be used as input for video conferences. How can it be done in Linux, and more precisely in Debian?
I’ve discovered OBS a couple of months ago, while learning how to produce video content for Juntos dese casa initiative. It allows the user to compose scenes with several sources (images, video camera input, mics, etc.) and to manage those scenes like if you were a video recording manager in an studio.
It’s already available for many platforms and operating systems, and in Debian it’s been as easy as:
$ sudo apt install obs-studio
One of its cool features is that it allows direct streaming of the video generated to several services like YouTube or Twitch. But it also allows to record the output into a video to share or stream later.
But, would it possible to use these scenes in a video conference call? I’ve discovered there are plugins to do it on certain operating systems, but in Linux (and for Debian in my case), it requires some work.
How to make it work?
I would like to thank Henning Jacobs for his detailed post about this topic. It has been very useful for me.
First you need to install v4l2loopback-dkms:
$ sudo apt install v4l2loopback-dkms
To activate it, I have followed Henning recommendations:
$ sudo modprobe v4l2loopback devices=1 video_nr=10 card_label="OBS Cam" exclusive_caps=1
Next, you need to compile and install obs-v4l2sink plugin, but first you might need cmake and libobs-dev. So, as usual in Debian :
$ sudo apt install cmake libobs-dev
Once installed, you need to follow these steps:
$ sudo apt install qtbase5-dev $ git clone --recursive https://github.com/obsproject/obs-studio.git $ git clone https://github.com/CatxFish/obs-v4l2sink.git $ cd obs-v4l2sink $ mkdir build && cd build $ cmake -DLIBOBS_INCLUDE_DIR="../../obs-studio/libobs" -DCMAKE_INSTALL_PREFIX=/usr .. $ make -j4 $ sudo make install
Sadly, it seems that the plugin file ends in a wrong folder (
/usr/lib/obs-plugins/), and you need to copy it to the right one:
$ sudo cp /usr/lib/obs-plugins/v4l2sink.so /usr/lib/x86_64-linux-gnu/obs-plugins/
Now, if you run OBS, under Tools you would have a new choice: V4L2 Video Output. You need to choose the path to V4L2 device (remember the
nr parameter when you activate the v4l2loopback module).
And now, you should be able to choose your “OBS Cam” in any video conference tool. For example in Jitsi:
If you notice that the output is mirrored, or upside down, don’t worry. As far as I have tested, the rest of the people see it right in their screen.
One of the cool features about using OBS this way is that you can give an internal talk or training, with nice scenes and transitions between cameras, and record it for later consumption:
If you find this article interesting, please, let me know through comments to this post. Thank you!