LookingGlass/doc/obs.rst

106 lines
2.2 KiB
ReStructuredText
Raw Normal View History

OBS plugin
##########
You can add a Looking Glass video feed
to OBS as a video source with the included OBS plugin. This provides a
lower-latency alternative to capturing the Looking Glass client window
with a Screen or Window Capture source.
2021-07-05 16:43:07 +00:00
This may help improve your viewers' watching experience, and
allows you to use your host privately.
Build Instructions
~~~~~~~~~~~~~~~~~~
The OBS plugin is included in the main source tree of Looking Glass. The
building process is very similar to the
:ref:`client's <build_client_section>`.
Dependencies
^^^^^^^^^^^^
The OBS plugin requires the following extra dependencies alongside the
:ref:`client's build
dependencies <installing_build_dependencies>`.
- libobs-dev
2021-07-05 16:43:07 +00:00
Install this package with ``apt-get``
.. code:: bash
apt-get install libobs-dev
.. _obs_building:
Building
^^^^^^^^
2021-07-05 16:43:07 +00:00
These instructions are similar to building the
:ref:`client <client_building>`.
.. code:: bash
mkdir obs/build
cd obs/build
cmake -DUSER_INSTALL=1 ../
make
Alternatively, if you would like to install the plugin for all users:
.. code:: bash
mkdir obs/build
cd obs/build
cmake ../
make
Installation
~~~~~~~~~~~~
You can install the plugin by running ``make install``.
2021-07-05 16:43:07 +00:00
.. code:: bash
make install
2021-12-25 18:32:29 +00:00
If you've opted to install the plugin for all users, you will need to run
this command as ``root``.
2021-12-25 18:32:29 +00:00
.. code:: bash
sudo make install
Setup
~~~~~
Once installed, you can select the *"Looking Glass Client"* source from
2021-07-05 16:43:07 +00:00
the OBS sources menu. Configuration requires the IVSHMEM file
used by the VM, and this is pre-populated with the default
filename for Looking Glass.
.. _open_broadcaster_software:
Open Broadcaster Software
~~~~~~~~~~~~~~~~~~~~~~~~~
The plugin is made for OBS, an open source streaming and recording
studio. Find out more at https://obsproject.com/
2021-07-05 16:43:07 +00:00
OBS is available under most distributions as *obs-studio* or just *obs*.
Screenshots
~~~~~~~~~~~
.. figure:: images/Looking-Glass-OBS-Source-Add.png
:alt: Adding the plugin as a video source
Adding the plugin as a video source
.. figure:: images/Looking-Glass-OBS-config.png
:alt: Plugin configuration settings
Plugin configuration settings