NAME

v4l2loopback-ctl - control v4l2 loopback devices

DESCRIPTION

usage: v4l2loopback-ctl [general commands]

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

-v : print version and exit

-h : print this help and exit

add {<flags>} [<device> [<outputdevice>]] delete <device> query <device> set-fps <device> <fps> get-fps <device> set-caps <device> <caps> get-caps <device> set-timeout-image {<flags>} <device> <image>

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

v4l2loopback-ctl add {<flags>} [<device> [<outputdevice>]]

<flags>

any of the following flags may be present

-n <name>

: pretty name for the device

-w <max_width>

: maximum allowed frame width

-h <max_height>

: maximum allowed frame height

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

-b <buffers>

: buffers to queue

-o <max_openers>

: maximum allowed concurrent openers

-v

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

<device>

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').

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

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

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').

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

v4l2loopback-ctl query <device>

<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') =============================

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') =============================

v4l2loopback-ctl get-fps <device>

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

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

<device>

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

<caps>

format specification, e.g. 'UYVY:3840x2160@60/1 (<fourcc>:<width>x<height>@<fps>)

known fourcc-codes ------------------ BGR4 877807426 32 bpp RGB, le RGB4 876758866 32 bpp RGB, be BGR3 861030210 24 bpp RGB, le RGB3 859981650 24 bpp RGB, be AR24 875713089 32 bpp RGBA, le AB24 875708993 32 bpp RGBA RGB1 826427218 8 bpp RGB-3-3-2 R444 875836498 16 bpp RGB (xxxxrrrr ggggbbbb) RGBO 1329743698 16 bpp RGB-5-5-5 RGBP 1346520914 16 bpp RGB-5-6-5 RGBQ 1363298130 16 bpp RGB-5-5-5 BE RGBR 1380075346 16 bpp RGB-5-6-5 BE BGRH 1213351746 18 bpp BGR-6-6-6 YUYV 1448695129 4:2:2, packed, YUYV UYVY 1498831189 4:2:2, packed, UYVY YVYU 1431918169 4:2:2, packed YVYU VYUY 1498765654 4:2:2, packed VYUY YYUV 1448434009 4:2:2, packed YYUV YUV4 878073177 YUV-8-8-8-8 GREY 1497715271 8 bpp, Greyscale Y04 540291161 4 bpp Greyscale Y06 540422233 6 bpp Greyscale Y10 540029273 10 bpp Greyscale Y12 540160345 12 bpp Greyscale Y16 540422489 16 bpp, Greyscale Y444 875836505 16 bpp xxxxyyyy uuuuvvvv YUVO 1331058009 16 bpp YUV-5-5-5 YUVP 1347835225 16 bpp YUV-5-6-5 RGGB 1111967570 Bayer RGGB 8bit GRBG 1195528775 Bayer GRBG 8bit GBRG 1196573255 Bayer GBRG 8bit BA81 825770306 Bayer BA81 8bit YVU9 961893977 4:1:0, planar, Y-Cr-Cb YV12 842094169 4:2:0, planar, Y-Cr-Cb YUV9 961959257 4:1:0, planar, Y-Cb-Cr YU12 842093913 4:2:0, planar, Y-Cb-Cr 422P 1345466932 16 bpp YVU422 planar 411P 1345401140 16 bpp YVU411 planar Y41P 1345401945 12 bpp YUV 4:1:1 NV12 842094158 12 bpp Y/CbCr 4:2:0 MJPG 1196444237 Motion-JPEG JPEG 1195724874 JFIF JPEG dvsd 1685288548 DV1394 MPEG 1195724877 MPEG-1/2/4 Multiplexed H264 875967048 H264 with start codes AVC1 826496577 H264 without start codes M264 875967053 H264 MVC H263 859189832 H263 MPG1 826757197 MPEG-1 ES MPG2 843534413 MPEG-2 ES MPG4 877088845 MPEG-4 part 2 ES XVID 1145656920 Xvid VC1G 1194410838 SMPTE 421M Annex G compliant stream VC1L 1278296918 SMPTE 421M Annex L compliant stream VP80 808996950 VP8 VP90 809062486 VP9 HEVC 1129727304 HEVC

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

v4l2loopback-ctl get-caps <device>

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

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

<flags>

any of the following flags may be present

-t <timeout>

: timeout (in ms)

<device>

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

<image>

image file