ALT Linux Sisyphus - Пакет mjpg-streamer

.\" @(#)mjpg-streamer.1
.\" 
.\" Man page written by vodoo (a t) vakw dot ch
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License version 2
.\" as published by the Free Software Foundation.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual 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 wit
.\" this program; see the file COPYING.  If not, write to the Free Software
.\" Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
.\"
.TH mjpg_streamer 1  "January 1, 2011" "version 2.0" "USER COMMANDS"
.SH NAME
mjpg_streamer \- Stream webcam video to HTTP
.SH SYNOPSIS
.B mjpg_streamer
[\-b|\-\-background] [\-i "INPUT_PLUGIN [INPUT_OPTIONS]"]
.br
\-o "OUTPUT_PLUGIN [OUTPUT_OPTIONS]"
.PP
.B mjpg_streamer
\-h | \-\-help
.br
.B mjpg_streamer
\-v | \-\-version
.PP
.SH DESCRIPTION
.B mjpg_streamer
takes JPGs from Linux\-UVC compatible webcams, from the filesystem or from
other input plugins and streams them as M\-JPEG via HTTP to webbrowsers, VLC
and other software. Alternatively, the stream can be saved to a file or
single frames can be captured and saved. It is the successor of
uvc\-streamer, a Linux\-UVC streaming application with Pan/Tilt.
.PP
.B Note:
The name of the executable program is mjpg_streamer (with underscore) but
the name of the package is mjpg\-streamer (with hyphen). The latter is used
in pathnames too.
.SH OPTIONS
.TP
\-i | \-\-input "<input\-plugin.so> [parameters]"
.TP
\-o | \-\-output "<output\-plugin.so> [parameters]"
.TP
\-h | \-\-help
display a short help message.
.TP
\-v | \-\-version
display version information.
.TP
\-b | \-\-background
fork to the background, run in daemon mode.
.SH EXAMPLES
.TP
To open an UVC webcam "/dev/video1" and stream it via HTTP:
.B mjpg_streamer
\-i "input_uvc.so \-d /dev/video1"
.br
\-o "output_http.so"
.PP
.TP
To open an UVC webcam and stream via HTTP port 8090:
.B mjpg_streamer
\-i "input_uvc.so" \-o "output_http.so \-p 8090"
.PP
.TP
To get help for a certain plugin:
.B mjpg_streamer
\-i "input_uvc.so \-\-help"
.br
.B mjpg_streamer
\-i input_testpicture.so
.br
\-o "output_http.so \-\-help"
.PP
.TP
This is the minimum command line to start mjpg_streamer with webpages. For the input\-plugin default parameters are used:
.br
.B mjpg_streamer
\-o "output_http.so
.br
\-w /usr/share/mjpg\-streamer/www"
.PP
.SH FINDING THE PLUGINS
The default search path for the plugins is taken from the variable
LD_LIBRARY_PATH. When you get an error saying that plugins can not be found,
set LD_LIBRARY_PATH like this:
.PP
.B export
LD_LIBRARY_PATH="/usr/lib/mjpg\-streamer"
.PP
or \- for 64\-Bit systems:
.PP
.B export
LD_LIBRARY_PATH="/usr/lib64/mjpg\-streamer"
.PP
Or instead of just providing the plugin file name, use a complete (absolute)
path and filename:
.PP
.B mjpg_streamer
\-i "/usr/lib/mjpg\-streamer/input_uvc.so"
.PP
.SH PLUGINS
.B input_uvc.so
\- UVC webcam grabber
.PP
The following parameters can be passed to this plugin:
.TP
\-d | \-\-device <DEVICE>
Video device to open. Example: /dev/video0.
.TP
\-r | \-\-resolution <RES>
The resolution of the video device. Can be one of the following strings:
QSIF QCIF CGA QVGA CIF VGA SVGA XGA SXGA or a custom value like the
following example: 640x480.
.TP
\-f | \-\-fps <NUMBER>
Frames per second. You must choose a value supported by your camera.
.TP
\-y | \-\-yuv
Enable YUYV format and disable MJPEG mode.
.TP
\-q | \-\-quality <PERCENT>
JPEG compression quality in percent (activates YUYV format, disables MJPEG).
.TP
\-m | \-\-minimum_size <SIZE>
Drop frames smaller then this limit, useful if the webcam produces
small\-sized garbage frames. This may happen under low light conditions.
.TP
\-n | \-\-no_dynctrl
Do not initalize dynctrls of Linux\-UVC driver.
.TP
\-l | \-\-led <on|off|blink|auto>
Switch the LED "on", "off", let it "blink" or leave it up to the driver
using the value "auto".
.PP
.B input_file.so
\- File input plugin.
.TP
\-d | \-\-delay <DELAY>
Delay to pause between frames in ms.
.TP
\-f | \-\-folder <DIRECTORY>
Folder to watch for new JPEG files.
.TP
\-r | \-\-remove
Remove/delete JPEG file after reading.
.TP
\-n | \-\-name
Ignore changes unless filename matches.
.PP
.B input_gspcav1.so
\- GSPCAV1 webcam grabber.
.TP
\-d | \-\-device <DEVICE>
Video device to open.
.TP
\-r | \-\-resolution <RES>
The resolution of the video device. Can be one of the following strings:
QSIF QCIF CGA QVGA CIF VGA SVGA XGA SXGA or a custom value like the
following example: 640x480.
.TP
\-f | \-\-format <r16|r24|r32|yuv|jpg>
Grabbing format, should be set to 'jpg'. Can be: r16 r24 r32 yuv jpg.
.PP
.B input_testpicture.so
\- Test picture input plugin.
.TP
\-d | \-\-delay <DELAY>
Delay to pause between frames in ms.
.TP
\-r | \-\-resolution <RES>
Can be one of 960x720, 640x480, 320x240, 160x120.
.PP
.B output_http.so
\- HTTP output plugin
.TP
\-w | \-\-www <DIRECTORY>
Directory that contains webpages in flat hierarchy (no subdirectories). For
openSUSE packages this is
.br
/usr/share/mjpg\-streamer/www.
.TP
\-p | \-\-port <PORT>
TCP port for this HTTP server. The default port is 8080.
.TP
\-c | \-\-credentials <USERNAME:PASSWORD>
Ask for "username:password" on connect.
.TP
\-n | \-\-nocommands
Disable execution of commands.
.PP
.B output_file.so
\- File output plugin.
.TP
\-f | \-\-folder <DIRECTORY>
Directory to save pictures.
.TP
\-m | \-\-mjpeg
Save the stream to an mjpeg file.
.TP
\-d | \-\-delay <DELAY>
Delay after saving pictures in ms.
.TP
\-s | \-\-size <NUMBER>
Size of ring buffer (max number of pictures to hold).
.TP
\-e | \-\-exceed <NUMBER>
Allow ringbuffer to exceed limit by this amount.
.TP
\-c | \-\-command <COMMAND>
Execute command after saving picture.
.PP
.B output_udp.so
\- UDP output plugin.
.br
This plugin saves a picture from the stream upon receiving an UDP request.
The request is sent using
.B mjpg_streamer_udp_client.
.TP
\-f | \-\-folder <DIRECTORY>
Directory to save pictures.
.TP
\-d | \-\-delay <DELAY>
Delay after saving pictures in ms.
.TP
\-c | \-\-command <COMMAND>
Execute command after saving picture.
.TP
\-p | \-\-port <PORT>
UDP port to listen for picture requests. UDP message is the filename to
save. By default the client uses port 2001.
.PP
.B output_autofocus.so
\- Autofocus output plugin
.br
This plugin continuously grabs a fresh frame, calculates focus for best
sharpness and adjusts the focus accordingly.
.TP
\-d | \-\-delay <DELAY>
Delay between grabbing frames in ms. Defaults to 1000.
.PP
.SH EXIT STATUS
A running
.B mjpg_streamer
can be stopped with CTRL\-C or by sending the signal SIGINT (kill \-SIGINT) to
the process. Receiving the signal will shutdown all plugins and free
resources. On normal termination it returns a zero exit status and on
error it returns 1.
.SH AUTHOR
Tom StЖveken, MАrton MiklСs
.SH SEE ALSO
mstreamer(1), mjpg_streamer_udp_client(1)
.PP
https://sourceforge.net/apps/mediawiki/mjpg\-streamer/
.br
index.php?title=Main_Page