https://github.com/CatxFish/obs-v4l2sink
obs studio output plugin for Video4Linux2 device
https://github.com/CatxFish/obs-v4l2sink
obs-studio obs-studio-plugin v4l2
Last synced: 6 months ago
JSON representation
obs studio output plugin for Video4Linux2 device
- Host: GitHub
- URL: https://github.com/CatxFish/obs-v4l2sink
- Owner: CatxFish
- License: gpl-2.0
- Archived: true
- Created: 2018-07-25T05:56:37.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2021-03-15T07:31:49.000Z (over 4 years ago)
- Last Synced: 2024-08-01T22:52:46.330Z (about 1 year ago)
- Topics: obs-studio, obs-studio-plugin, v4l2
- Language: C++
- Homepage:
- Size: 49.8 KB
- Stars: 928
- Watchers: 34
- Forks: 97
- Open Issues: 68
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# obs-v4l2sink
**Notice: [OBS Studio 26.1](https://github.com/obsproject/obs-studio/releases/tag/26.1.0)
officially provides virtual cam support, and can be used without installing this plugin.
See [issue (#56)](https://github.com/CatxFish/obs-v4l2sink/issues/56#issuecomment-753191690)
for more information.**
An [OBS Studio][obs-proj] plugin that provides output capabilities to a
Video4Linux2 device. It is basically a Linux version of [obs-virtual-cam][vcam],
but only contains the video sink part. You can use it with
[v4l2loopback][v4l2loopback] to achieve cross-program video transfer between OBS
Studio and third party software supporting Video4Linux2, e.g. to present an OBS
session in proprietary browser-based conferencing systems by selecting the OBS
session as a webcam.
The idea for this plugin originated from the discussions around [obs-virtual-cam
issue #17][vcam#17].
[obs-proj]: https://obsproject.com/
[vcam]: https://github.com/CatxFish/obs-virtual-cam
[v4l2loopback]: https://github.com/umlaeute/v4l2loopback
[vcam#17]: https://github.com/CatxFish/obs-virtual-cam/issues/17
## Usage with v4l2loopback
- Make sure to [load the v4l2loopback module][run-v4l2loopback] and check the Device Path.
- If using Chrome or Chromium you must use the option `exclusive_caps=1`.
- Open OBS and select the menu entry `Tools > V4L2 Video Output`.
- Fill in the Device Path and select the appropriate video format.
- Click the `Start` button.
[run-v4l2loopback]: https://github.com/umlaeute/v4l2loopback#run
## Build
- Install QT
```
sudo apt install qtbase5-dev
```
- Install LibObs
```
sudo apt install libobs-dev
```
- Get obs-studio source code
```
git clone --recursive https://github.com/obsproject/obs-studio.git
```
- Build plugins
```
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
```