.\" @(#)mstreamer.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 mstreamer 1  "January 1, 2011" "version 1.0" "USER COMMANDS"
.SH NAME
mstreamer \- Wrapper script to start / stop mjpg_streamer
.SH SYNOPSIS
.B mstreamer
gui | start [\-b] | stop | status
.SH DESCRIPTION
.B mstreamer
is a wrapper script to start / stop
.B mjpg_streamer
in a simple configuration, taking it's input from the first UVC compliant
webcam and streaming to HTTP on port 8080. The
.B output_uvc.so
plugin will be included to enable taking snapshots with
.B mjpg_streamer_udp_client.
The script can be run in two configurations. As a graphical interface on the
KDE screen with the option
.B gui
or as a command line interface with the options
.B start | stop | status.
.PP
The script contains a few examples how to start
.B mjpg_streamer
with different plugins. It is well worth having a look at the code.
.SH OPTIONS
.TP
.B gui
Launch the wrapper script in the graphical mode using kdialog. Clicking the
mjpg\-streamer icon in the menu list will launch this mode. It will let
you start
.B mjpg_streamer
for HTTP streaming to the default port 8080 or stop it, if it's already
running. The image size is set to 640x480 at 5 frames per second.
.PP
.TP
.B start [\-b]
Start
.B mjpg_streamer
in command line mode. The optinal parameter
.B \-b
starts as a daemon in the background.
.PP
.TP
.B stop
Stops a running daemon. If you did not start it in the background you may
just as well type CTRL\-C on the console to stop it.
.TP
.B status
Show the status of
.B mjpg_streamer
(running / not running).
.SH CONFIGURATION
The user can change some default values by editing a file named
/etc/sysconfig/mjpg-streamer defining the following variables:
.TP
.B Configuration script /etc/sysconfig/mjpg\-streamer
VIDEODEV=""
.br
#VIDEODEV="/dev/video0"
.br
IMGSIZE="640x480"
.br
FRAMERATE="5"
.br
TCP_PORT="8080"
.br
UDP_PORT="2001"
.PP
Edit the values to your requirements but keep in mind that they must be
supported by your camera. You can also edit these variables using Yast from
the menu System \-\-> /etc/sysconfig Editor \-\-> Applications \-\->
mjpg\-streamer.
.SH AUTHOR
vodoo (a t) vakw (d o t) ch
.SH SEE ALSO
mjpg_streamer(1), mjpg_streamer_udp_client(1)