The following configuration options can be supplied to MJPG Streamer on start to modify certain camera settings. To change any of these options in OctoPi, edit the relevant sections in octopi.txt
as described here.
USB webcams (input_uvc.so
)
input_uvc.so
comes bundled with MJPG Streamer.
See also the documentation for the recommended MJPG Streamer fork (bundled with OctoPi) for additional options not listed here.
-
-d <device>
: The video device to use, e.g.-d /dev/video0
-
-r <resolution>
: The resolution, e.g.-r 640x480
for 640x480px -
-f <framerate>
: The framerate in frames per second, e.g.-f 10
for 10 fps -
-q <quality>
: The quality of the JPG compression to use, e.g.-q 85
for compression down to 85% -
-y
: Use this if your camera doesn't support MJPG, pictures will be captured in YUVY
Raspicam (input_raspi.so
)
input_raspi.so
is included in this MJPG Streamer fork by Jackson Liam which also supports the Raspberry Pi Camera. This is the fork that is shipped on the OctoPi SD card image for the Raspberry Pi.
See also the documentation for more information about these options.
-
-fps
or--framerate
: set video framerate, default 1 frame/sec -
-x
or--width
: width of frame capture, default 640 -
-y
or--height
: height of frame capture, default 480 -
-quality
: set JPEG quality (0 to 100), default 85 -
-usestills
: uses stills mode instead of video mode -
-sh
: Set image sharpness (-100 to 100) -
-co
: Set image contrast (-100 to 100) -
-br
: Set image brightness (0 to 100) -
-sa
: Set image saturation (-100 to 100) -
-ISO
: Set capture ISO -
-vs
: Turn on video stablisation -
-ev
: Set EV compensation -
-ex
: Set exposure mode, valid values (according to the RaspiCam documentation):off
-
auto
: Use automatic exposure -
night
: Select setting for night shooting nightpreview
-
backlight
: Select setting for back-lit subject spotlight
-
sports
: Select setting for sports (fast shutter etc.) -
snow
: Select setting optimized for snowy scenery -
beach
: Select setting optimized for beach -
verylong
: Select setting for long exposures -
fixedfps
: Constrain fps to a fixed value -
antishake
: Antishake mode -
fireworks
: Select setting optimized for fireworks
-
-awb
: Set AWB mode, valid values (according to the RaspiCam documentation):-
off
: Turn off white balance calculation -
auto
: Automatic mode (default) -
sun
: Sunny mode -
cloudshade
: Cloudy mode -
tungsten
: Tungsten lighting mode -
fluorescent
: Fluorescent lighting mode -
incandescent
: Incandescent lighting mode -
flash
: Flash mode -
horizon
: Horizon mode
-
-
-ifx
: Set image effect (according to the RaspiCam documentation):-
none
: No effect -
negative
: Produces a negative image -
solarise
: Solarise the image -
whiteboard
: Whiteboard effect -
blackboard
: Blackboard effect -
sketch
: Sketch-style effect -
denoise
: Denoise the image -
emboss
: Embossed effect -
oilpaint
: Oil paint-style effect -
hatch
: Cross-hatch sketch style -
gpen
: Graphite sketch style -
pastel
: Pastel effect -
watercolour
: Watercolour effect -
film
: Grainy film effect -
blur
: Blur the image -
saturation
: Colour-saturate the image -
colourswap
: Not fully implemented -
washedout
: Not fully implemented -
posterise
: Not fully implemented -
colourpoint
: Not fully implemented -
colourbalance
: Not fully implemented -
cartoon
: Not fully implemented
-
-
-cfx
: Set colour effect (U:V), the supplied U and V parameters (range 0 to 255) are applied to the U and Y channels of the image. For example,--colfx 128:128
should result in a monochrome image (according to the RaspiCam documentation). -
-mm
: Set metering mode (see raspistill notes), valid values (according to the RaspiCam documentation):-
average
: Average the whole frame for metering -
spot
: Spot metering -
backlit
: Assume a backlit image -
matrix
: Matrix metering
-
-
-rot
: Set image rotation (0-359, at the present only 0, 90, 180 and 270 are supported though) -
-hf
: Set horizontal flip -
-vf
: Set vertical flip