webcam reads the configuration from the given config file or ~/.webcamrc if
none is specified in the command line.
The config file has at least two sections. The "grab" section holds
the capture parameters. Any other section describes where the image
should be uploaded. Older versions used "ftp" as name for that
section. Recently the webcam utility got support for multiple
connections, thus any section name is accepted and you can have more
than one ftp section (you have to use another name for each section
througth, name them by upload servers for example).
Here is an sample config file (the given values are the defaults):
text is processed with strftime. Check the strftime(3) or date(1) manpage
to see how you can format the timestamps. The text can also be read
from a extern file (use
infofile for that). The default color for the text overlay is white
(RGB=255,255,255). Entries in the range of 0 through 255 for
fg_blue can be used to define a different color. Likewise
bg_blue can be used to set the background color (which defaults to
device = /dev/video0
driver = libv4l
text = "webcam %Y-%m-%d %H:%M:%S"
infofile = filename
fg_red = 255
fg_green = 255
fg_blue = 255
width = 320
height = 240
delay = 3
wait = 0
input = composite1
norm = pal
rotate = 0
top = 0
left = 0
bottom = -1
right = -1
quality = 75
trigger = 0
once = 0
host = www
user = webcam
pass = xxxxxx
dir = public_html/images
file = webcam.jpeg
tmp = uploading.jpeg
passive = 1
debug = 0
auto = 0
local = 0
ssh = 0
input is the video source (TV/composite/whatever),
norm the TV norm.
delay is the delay between two images in seconds.
wait is the initial delay before the first image is grabbed (some cameras
need some time for adapting to lightning, thus dont return images with
reasonable quality within the first few seconds ...).
quality is the JPEG quality for the stored images.
top, bottom, left, and
right in the grab section allow cropping the image after it is grabbed.
They should satisfy 0<=top<bottom<=height and
0<=left<right<=width. (0,0 is the top, left corner.)
rotate is positive, the output image will be rotated counter-clockwise
90 degrees that number of times (1, 2, or 3).
trigger set to a non-zero value webcam will upload the image only if the
content of the image has changed. It just looks for the maximum
difference between the last uploaded and current image and if it is
greater than the specified value the image will be uploaded.
once is set to 1 webcam will upload a single frame and quit.
archive can be used to create a (local) archive of the webcam images. Just
specify the filename for the files as argument. The filename will be
processed with strftime(3), so you can use the place the usual time
format controls into the string to get unique filenames. Non-existing
directories are created if needed.
debug in the ftp section is set to 1 the complete communication between
webcam and the ftp utility is printed to stderr.
auto enables autologin via ~/.netrc (starts the ftp utility without the -n
switch, check the ftp(1) man page for more info about the ~/.netrc file).
local in the ftp section is non-zero, files will be stored locally (using
dir, tmp, and
file parameters) rather than ftped.
ssh set to non-zero makes webcam use ssh instead of ftp.