forked from umlaeute/v4l2loopback
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
125 lines (101 loc) · 4.67 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
v4l2loopback - a kernel module to create V4L2 loopback devices
==============================================================
this module allows you to create "virtual video devices"
normal (v4l2) applications will read these devices as if they were ordinary
video devices, but the video will not be read from e.g. a capture card but
instead it is generated by another application.
this allows you for instance to apply apply some nifty video effects on your
Skype video...
it also allows some more serious things (e.g. I've been using it to add
streaming capabilities to an application by the means of hooking GStreamer into
the loopback devices).
--- NEWS ---
to get the main features of each new release, see the NEWS file.
you could also have a look at the ChangeLog (which gets automatically generated and might
only be of limited use...
--- ISSUES ---
for current issues, checkout https://github.com/umlaeute/v4l2loopback/issues
please use the issue-tracker for reporting any problems
--- BUILD ---
to build the kernel module run "make".
this should give you a file named "v4l2loopback.ko", which is the kernel module
--- INSTALL ---
to install the module run "make install" (you might have to be 'root' to have
all necessary permissions to install the module).
if your system has "sudo", do:
$ make && sudo make install
if your system lacks "sudo", do:
$ make
$ su
(enter root password)
# make install
# exit
--- RUN ---
Load the v4l2loopback module as root :
# modprobe v4l2loopback
using sudo use:
$ sudo modprobe v4l2loopback
this will create an additional video-device, e.g. /dev/video0 (the number
depends on whether you already had video devices on your system), which can be
fed by various programs.
tested feeders:
GStreamer: using the "v4l2sink" element
Gem(>=0.93) using the "recordV4L2" plugin
in theory most programs capable of _writing to_ a v4l2 device should work.
the data sent to the v4l2loopback device can then be read by any v4l2-capable
application.
you can find a number of scenarios on the wiki at
http://github.com/umlaeute/v4l2loopback/wiki
--- OPTIONS ---
if you need several independent loopback devices, you can pass the "devices"
option, when loading the module; e.g.
# modprobe v4l2loopback devices=4
will give you 4 loopback devices (e.g. /dev/video1 ... /dev/video5)
you can also specify the device IDs manually; e.g.
# modprobe v4l2loopback video_nr=3,4,7
will create 3 devices (/dev/video3 /dev/video4 & /dev/video7)
--- ATTRIBUTES ---
you can set and/or query some per-device attributes via sysfs, in a human
readable format. see
/sys/devices/virtual/video4linux/video*/
--- KERNELs ---
the original module has been developed for linux-2.6.28;
i don't have a system with such an old kernel anymore, so i don't know whether
it still works.
further development has been done mainly on linux-2.6.32 and linux-2.6.35, with
newer kernels being continually tested as they enter debian.
support:
<= 2.6.27 definitely will NOT work
2.6.28 - 2.6.31 may work (seems to compile but i cannot test)
>= 2.6.32 should work
>= 3.0.0 should work as well
--- DISTRIBUTIONS ---
v4l2loopack is now (2010-10-13) available as a Debian-package.
This means, that it is also part of Debian-derived distributions, including
Ubuntu (starting with natty).
The most convenient way is to install the package "v4l2loopback-dkms".
This should automatically build and install the module for your current kernel
(provided you have the matching kernel-headers installed).
Another option is to install the "v4l2loopback-source" package.
In this case you should be able to simply do (as root):
# aptitude install v4l2loopback-source module-assistant
# module-assistant auto-install v4l2loopback-source
--- DOWNLOAD ---
the most up-to-date version of this module can be found at
http://github.com/umlaeute/v4l2loopback/.
--- LICENSE/COPYING ---
Copyright (c) 2010-2011 IOhannes m zmoelnig <[email protected]>
Copyright (c) 2011 Stefan Diewald ([email protected])
Copyright (c) 2010 Scott Maines <[email protected]>
Copyright (c) 2009 Gorinich Zmey
Copyright (c) 2005-2009 Vasily Levin
This package is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.