This repository has been archived by the owner on Mar 15, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 98
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
25 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,29 +1,50 @@ | ||
# obs-v4l2sink | ||
|
||
This plugin provides output ability to v4l2 device . It is basically a Linux version of [obs-virtual-cam](https://github.com/CatxFish/obs-virtual-cam), but only contains the video sink part. You can use it with [v4l2loopback](https://github.com/umlaeute/v4l2loopback) to achieve cross-program image transfer between obs-studio and third party software supporting Video4Linux. | ||
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 | ||
|
||
# Usage with v4l2loopback | ||
- Make sure [load v4l2loopback module](https://github.com/umlaeute/v4l2loopback#run) and check the device path. | ||
- If using Chrome or Chromium you must use the option "exclusive_caps=1". | ||
- Open OBS and click tools > v4l2sink . | ||
- Fill device path and choose video format. | ||
- Click start. | ||
|
||
# Build | ||
## Build | ||
|
||
- Install QT | ||
|
||
``` | ||
sudo apt install qtbase5-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 | ||
``` | ||
``` |