git.sesse.net Git - nageru-docs/blob - v4l2.rst

   1 V4L2 output
   2 ===========
   3
   4 Since Nageru 1.9.3, Nageru has had (in addition to the regular
   5 :doc:`hdmisdi`) support for output to Linux' Video4Linux API
   6 (also known as V4L2, or just V4L). This is intended for one
   7 specific purpose, namely using Nageru as a camera/mixer for
   8 input to a video conference, such at Jitsi, Google Meet or
   9 similar—it may not be all that suitable for an actual
  10 output, since it does not carry audio (and does not synchronize
  11 to any V4L clock).
  12
  13 To use it as an input, you will first need to install
  14 `v4l2loopback <https://github.com/umlaeute/v4l2loopback>`_,
  15 which turns V4L outputs into V4L inputs. If you are on
  16 Debian or Ubuntu, the following should suffice to install::
  17
  18   sudo apt install v4l2loopback-dkms
  19
  20 You will also need to load and configure the module,
  21 using a command line such as::
  22
  23   sudo modprobe v4l2loopback video_nr=2 card_label='Nageru loopback' max_width=1280 max_height=720 exclusive_caps=1
  24
  25 The *exclusive_caps=1* parameter is so that once you start
  26 outputting, the virtual card will appear only as an input
  27 card to other V4L clients; in particular, Google Chrome
  28 needs this, or the card will not show up. However, this means
  29 that you will need to start Nageru output *before* trying to
  30 use it in the browser.
  31
  32 Finally, you can start Nageru as usual with the *--v4l-output*
  33 flag, outputting to the device you just created::
  34
  35   nageru --v4l-output /dev/video2
  36
  37 Nageru should then show up as a device in your browser
  38 or videoconferencing client.
  39
  40 V4L output is in addition to any other output you may have
  41 (whether stream output, :doc:`hdmisdi`, or both), and can
  42 only be configured from the command line. It does not control
  43 the master clock, is always 4:2:0; and does not include audio.