V4L2LOOPBACK-CTL(1)

NAME
v4l2loopback-ctl - control v4l2 loopback devices

DESCRIPTION
usage: utils/v4l2loopback-ctl [general commands]

    general commands ================

-v/--version : print version and exit

-h/-?/--help : print this help and exit

    add {<flags>} [<outputdevice> [<capturedevice>]]

    delete <device>

    list {<flags>}

    query {<flags>} <device>

    set-fps <device> <fps>

    get-fps <device>

    set-caps <device> <caps>

    get-caps <device>

    set-timeout-image {<flags>} <device> <image>

    adding devices ('add') ======================

    utils/v4l2loopback-ctl add {<flags>} [<outputdevice> [<capturedevice>]]

<flags>
    any of the following flags may be present

-n/--name <name>
    : pretty name for the device

--min-width <w>
    : minimum allowed frame width

-w/--max-width <w>
    : maximum allowed frame width

--min-height <w>
    : minimum allowed frame height

-h/--max-height <h>
    : maximum allowed frame height

-x/--exclusive-caps <x> : whether to announce OUTPUT/CAPTURE capabilities exclusively

-b/--buffers <num>
    : buffers to queue

-o/--max-openers <num>
    : maximum allowed concurrent openers

-v/--verbose
    : verbose mode (print properties of device after successfully creating it)

-?/--help
    : print this help and exit

<outputdevice>
    if given, create a specific device (otherwise just create a free one).

    either specify a device name (e.g. '/dev/video1') or a device number ('1').

<capturedevice>
    if given, use separate output & capture devices (otherwise they are the same).

    deleting devices ('delete') ===========================

    utils/v4l2loopback-ctl delete <device>

<device>
    can be given one more more times (to delete multiple devices at once). either specify a device name (e.g. '/dev/video1') or a device number ('1').

    listing devices ('list') ========================

    utils/v4l2loopback-ctl list {<flags>}

<flags>
    any of the following flags may be present

-e/--escape
    : escape control-characters in (device) names

-h/--help
    : print this help and exit

    list all available loopback-devices

    querying devices ('query') ==========================

    utils/v4l2loopback-ctl query {<flags>} <device>

<flags>
    any of the following flags may be present

-e/--escape
    : escape control-characters in (device) names

-h/--help
    : print this help and exit

<device>
    can be given one more more times (to query multiple devices at once). either specify a device name (e.g. '/dev/video1') or a device number ('1').

    setting framerate ('set-fps') =============================

    utils/v4l2loopback-ctl set-fps <device> <fps>

<device>
    either specify a device name (e.g. '/dev/video1') or a device number ('1').

<fps>
    frames per second, either as integer ('30') or fraction ('50/2').

    getting framerate ('get-fps') =============================

    utils/v4l2loopback-ctl get-fps <device>

    setting capabilities ('set-caps') =================================

    utils/v4l2loopback-ctl set-caps <device> <caps>

<device>
    either specify a device name (e.g. '/dev/video1') or a device number ('1').

<caps>
    format specification as '<fourcc>:<width>x<height>@<fps>' (e.g. 'UYVY:1024x768@60/1') unset the current caps with the special value 'any'

    getting capabilities ('get-caps') =================================

    utils/v4l2loopback-ctl get-caps <device>

    setting timeout image ('set-timeout-image') ===========================================

    utils/v4l2loopback-ctl set-timeout-image {<flags>} <device> <image>

<flags>
    any of the following flags may be present

-t/--timeout <timeout>
    : timeout (in ms)

-v/--verbose
    : raise verbosity (print what is being done)

-h/--help
    : print this help and exit

<device>
    either specify a device name (e.g. '/dev/video1') or a device number ('1').

<image>
    image file