README.md
1mjpg-streamer input plugin: input_raspicam
2==========================================
3
4MJPEG Streamer with raspicam input plugin (based on raspistill mmal source code)
5
6Discussion / Questions / Help
7=============================
8
9Probably best in this thread
10http://www.raspberrypi.org/phpBB3/viewtopic.php?f=43&t=45178
11
12
13Instructions
14============
15
16If you ran the basic build, you can run from the mjpeg streamer experimental
17folder with:
18```
19export LD_LIBRARY_PATH=.
20./mjpg_streamer -o "output_http.so -w ./www" -i "input_raspicam.so"
21```
22
23You can specify options, like in raspivid:
24```
25export LD_LIBRARY_PATH=.
26./mjpg_streamer -o "output_http.so -w ./www" -i "input_raspicam.so -x 1280 -y 720 -fps 15 -ex night"
27```
28
29It does support upto 1080p 30fps, but the bandwidth produced would be more than the usb bus (and therefore ethernet port / wifi dongle) can provide. 720p 15fps is a good compromise.
30
31Here's some help for this input plugin:
32```
33 ---------------------------------------------------------------
34 Help for input plugin..: raspicam input plugin
35 ---------------------------------------------------------------
36 The following parameters can be passed to this plugin:
37
38 [-fps | --framerate]...: set video framerate, default 5 frame/sec
39 [-x | --width ]........: width of frame capture, default 640
40 [-y | --height]........: height of frame capture, default 480
41 [-quality].............: set JPEG quality 0-100, default 85
42 [-usestills]...........: uses stills mode instead of video mode
43 [-preview].............: enable full screen preview
44
45 -sh : Set image sharpness (-100 to 100)
46 -co : Set image contrast (-100 to 100)
47 -br : Set image brightness (0 to 100)
48 -sa : Set image saturation (-100 to 100)
49 -ISO : Set capture ISO
50 -vs : Turn on video stabilisation
51 -ev : Set EV compensation
52 -ex : Set exposure mode (see raspistill notes)
53 -awb : Set AWB mode (see raspistill notes)
54 -ifx : Set image effect (see raspistill notes)
55 -cfx : Set colour effect (U:V)
56 -mm : Set metering mode (see raspistill notes)
57 -rot : Set image rotation (0-359)
58-stats : Compute image stats for each picture (reduces noise)
59 -drc : Dynamic range compensation level (see raspistill notes)
60 -hf : Set horizontal flip
61 -vf : Set vertical flip
62 ---------------------------------------------------------------
63
64```
65Some of the camera options like ISO may not work due to it not working in the mmal-libs.
66
67Video mode is the default as it allows much smoother video (higher framerates).
68Stills mode allows you to use the full-frame of the sensor, but has a max framerate of around 8fps, probably less.
69Use stills mode with low FPS (e.g. 1 or 2).
70
71In order to have preview output shown on the raspi screen add the -preview option.
72
73This should run indefinitely. ctrl-c closes mjpeg streamer and raspicam gracefully.
74
75Based on https://github.com/raspberrypi/userland/blob/master/host_applications/linux/apps/raspicam/RaspiStill.c
76modified mmal header and source files from https://github.com/raspberrypi/userland/tree/master/interface/mmal
77