.\" @(#)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 " [parameters]" .TP \-o | \-\-output " [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 Video device to open. Example: /dev/video0. .TP \-r | \-\-resolution 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 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 JPEG compression quality in percent (activates YUYV format, disables MJPEG). .TP \-m | \-\-minimum_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 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 to pause between frames in ms. .TP \-f | \-\-folder 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 Video device to open. .TP \-r | \-\-resolution 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 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 to pause between frames in ms. .TP \-r | \-\-resolution Can be one of 960x720, 640x480, 320x240, 160x120. .PP .B output_http.so \- HTTP output plugin .TP \-w | \-\-www Directory that contains webpages in flat hierarchy (no subdirectories). For openSUSE packages this is .br /usr/share/mjpg\-streamer/www. .TP \-p | \-\-port TCP port for this HTTP server. The default port is 8080. .TP \-c | \-\-credentials 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 to save pictures. .TP \-m | \-\-mjpeg Save the stream to an mjpeg file. .TP \-d | \-\-delay Delay after saving pictures in ms. .TP \-s | \-\-size Size of ring buffer (max number of pictures to hold). .TP \-e | \-\-exceed Allow ringbuffer to exceed limit by this amount. .TP \-c | \-\-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 to save pictures. .TP \-d | \-\-delay Delay after saving pictures in ms. .TP \-c | \-\-command Execute command after saving picture. .TP \-p | \-\-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 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