NAME¶
motion - Detect motion using a video4linux device
SYNOPSIS¶
motion [ -hns ] [ -c config file path ] [ -d level ] [ -p process_id_file
]
DESCRIPTION¶
Motion uses a video4linux device to detect motion. If motion is detected
both normal and motion pictures will be taken. Motion can also take actions to
notify you if needed. Creation of automated snapshots is also possible.
OPTIONS¶
- -c
- Full path and filename of config file. E.g.
/home/kurt/motion.conf. Default is /usr/local/etc unless specified
differently when building Motion. Many RPMs and debian packages will most
likely use /etc or /etc/motion as default.
- -h
- Show help screen.
- -n
- Run in non-daemon mode.
- -s
- Run in setup mode. Also forces non-daemon mode
- -d level
- Run in debug mode, level 1-9.
- -p
- Full path and filename for process id file (pid file). E.g
/var/run/motion.pid. Default is not defined. Pid file is only created when
Motion is started in daemon mode.
CONFIG FILE OPTIONS¶
These are the options that can be used in the config file.
They are
overridden by the commandline! All number values are integer numbers (no
decimals allowed). Boolean options can be on or off (values "1",
"yes" and "on" all means true and any other value means
false).
- auto_brightness boolean
- Values: on, off / Default: off
Let motion regulate the brightness of a video device. Only recommended for
cameras without auto brightness
- brightness integer
- Values: 0 - 255 / Default: 0 (disabled)
The brightness level for the video device.
- contrast boolean
- Values: 0 - 255 / Default: 0 (disabled)
The contrast level for the video device.
- control_authentication string
- Values: Max 4096 characters / Default: Not defined
To protect HTTP Control by username and password, use this option for HTTP
1.1 Basic authentication. The string is specified as username:password. Do
not specify this option for no authentication. This option must be placed
in motion.conf and not in a thread config file.
- control_html_output boolean
- Values: on, off / Default: on
Enable HTML in the answer sent back to a browser connecting to the
control_port. This option must be placed in motion.conf and not in a
thread config file.
- control_localhost boolean
- Values: on, off / Default: on
Limits the http (html) control to the localhost. This option must be placed
in motion.conf and not in a thread config file.
- control_port integer
- Values: 0 - 65535 / Default: 0 (disabled)
Sets the port number for the http (html using browser) based remote control.
This option must be placed in motion.conf and not in a thread config
file.
- daemon boolean
- Values: on, off / Default: off
Start in daemon (background) mode and release terminal. This option must be
placed in motion.conf and not in a thread config file.
- despeckle string
- Values: EedDl / Default: Not defined
Despeckle motion image using combinations of (E/e)rode or (D/d)ilate. And
ending with optional (l)abeling.
- ffmpeg_bps integer
- Values: 0 - 9999999 / Default: 400000
Bitrate of mpegs produced by ffmpeg. Bitrate is bits per second. Default:
400000 (400kbps). Higher value mans better quality and larger files.
Option requires that ffmpeg libraries are installed.
- ffmpeg_cap_motion boolean
- Values: on, off / Default: off
Use ffmpeg libraries to encode motion type mpeg movies where you only see
the pixels that changes.
- ffmpeg_cap_new boolean
- Values: on, off / Default: off
Use ffmpeg libraries to encode mpeg movies in realtime.
- ffmpeg_deinterlace boolean
- Values: on, off / Default: off
Use ffmpeg to deinterlace video. Necessary if you use an analog camera and
see horizontal combing on moving objects in video or pictures.
- ffmpeg_timelapse boolean
- Values: 0 - 2147483647 / Default: 0 (disabled)
Create a timelapse movie saving a picture frame at the interval in seconds
set by this parameter. Set it to 0 if not used.
- ffmpeg_timelapse_mode discrete strings
- Values: hourly, daily, weekly-sunday, weekly-monday,
monthly, manual / Default: daily
The file rollover mode of the timelapse video.
- ffmpeg_variable_bitrate integer
- Values: 0, 2 - 31 / Default: 0 (disabled)
Enables and defines variable bitrate for the ffmpeg encoder. ffmpeg_bps is
ignored if variable bitrate is enabled. Valid values: 0 (default) = fixed
bitrate defined by ffmpeg_bps, or the range 2 - 31 where 2 means best
quality and 31 is worst.
- ffmpeg_video_codec discrete strings
- Values: mpeg1 (ffmpeg-0.4.8 only), mpeg4, msmpeg4, swf,
flv, ffv1 / Default: mpeg4
Codec to be used by ffmpeg for the video compression. Timelapse mpegs are
always made in mpeg1 format independent from this option.
- framerate integer
- Values: 2 - 100 / Default: 100 (no limit)
Maximum number of frames to be captured from the camera per second.
- frequency boolean
- Values: 0 - 999999 / Default: 0 (Not set)
The frequency to set the tuner to (kHz). Valid range: per tuner spec,
default: 0 (Don't set it)
- gap integer
- Values: 0 - 2147483647 / Default: 60
Gap is the seconds of no motion detection that triggers the end of an event.
An event is defined as a series of motion images taken within a short
timeframe.
- height integer
- Values: Device Dependent / Default: 288
The height of each frame in pixels.
- hue integer
- Values: 0 - 255 / Default: 0 (disabled)
The hue level for the video device.
- input integer
- Values: 0 - 7, 8 = disabled / Default: 8 (disabled)
Input channel to use expressed as an integer number starting from 0. Should
normally be set to 1 for video/TV cards, and 8 for USB cameras.
- jpeg_filename string
- Values: Max 4095 characters / Default: %v-%Y%m%d%H%M%S-%q
File path for motion triggered images (jpeg or ppm) relative to target_dir.
Value 'preview' makes a jpeg filename with the same name body as the
associated saved mpeg movie file.
- lightswitch integer
- Values: 0 - 100 / Default: 0 (disabled)
Ignore sudden massive light intensity changes given as a percentage of the
picture area that changed intensity.
- locate boolean
- Values: on, off, preview / Default: off
Locate and draw a box around the moving object. Value 'preview' makes Motion
only draw a box on a saved preview jpeg image and not on the saved mpeg
movie.
- low_cpu integer
- Values: 0 - 100 / Default: 0 (disabled)
When this option is not zero motion will be in a low cpu mode while not
detecting motion. In low cpu mode Motion reduces the framerate to the
value given for this option. Value zero means disabled.
- mask_file string
- Values: Max 4095 characters / Default: Not defined
PGM file to use as a sensitivity mask. This picture MUST have the same width
and height as the frames being captured and be in binary format.
- max_mpeg_time integer
- Values: 0 (infinite) - 2147483647 / Default: 3600
The maximum length of an mpeg movie in seconds. Set this to zero for
unlimited length.
- minimum_frame_time integer
- Values: 0 - 2147483647 / Default: 0
Minimum time in seconds between the capturing picture frames from the
camera. Default: 0 = disabled - the capture rate is given by the camera
framerate.
- minimum_motion_frames boolean
- Values: 1 - 1000s / Default: 1
Picture frames must contain motion at least the specified number of frames
in a row before they are detected as true motion. At the default of 1, all
motion is detected. Valid range is 1 to thousands, but it is recommended
to keep it within 1-5.
- motion_video_pipe string
- Values: Max 4095 characters / Default: Not defined
The video4linux video loopback input device for motion images. If a
particular pipe is to be used then use the device filename of this pipe,
if a dash '-' is given motion will use /proc/video/vloopback/vloopbacks to
locate a free pipe. Default: not set
- movie_filename string
- Values: Max 4095 characters / Default: %v-%Y%m%d%H%M%S
File path for motion triggered ffmpeg movies (mpeg) relative to target_dir.
This was previously called ffmpeg_filename.
- mysql_db string
- Values: Max 4095 characters / Default: Not defined
Name of the MySQL database.
- mysql_host string
- Values: Max 4095 characters / Default: localhost
IP address or domain name for the MySQL server. Use "localhost" if
motion and MySQL runs on the same server.
- mysql_password string
- Values: Max 4095 characters / Default: Not defined
The MySQL password.
- mysql_user string
- Values: Max 4095 characters / Default: Not defined
The MySQL user name.
- netcam_proxy string
- Values: Max 4095 characters / Default: Not defined
URL to use for a netcam proxy server, if required. The syntax is
http://myproxy:portnumber
- netcam_url string
- Values: Max 4095 characters / Default: Not defined
Specify an url to a downloadable jpeg file or raw mjpeg stream to use as
input device. Such as an AXIS 2100 network camera.
- netcam_userpass string
- Values: Max 4095 characters / Default: Not defined
For network cameras protected by username and password, use this option for
HTTP 1.1 Basic authentication. The string is specified as
username:password. Do not specify this option for no authentication.
- night_compensate boolean
- Values: on, off / Default: off
When this option is set the noise threshold will be lowered if the picture
is dark. This will improve the sensitivity in dark places. However it
might also increase the number of false alarms since most cameras also
increase light sensitivity with their AGC (Automatic Gain Control) and
this will increase noise.
- noise_level integer
- Values: 1 - 255 / Default: 32
The noise level is used as a threshold for distinguishing between noise and
motion.
- noise_tune boolean
- Values: on, off / Default: on
Activates the automatic tuning of noise level.
- norm discrete strings
- Values: 0 (PAL), 1 (NTSC), 2 (SECAM), 3 (PAL NC no colour)
/ Default: 0 (PAL)
Select the norm of the video device. Values: 0 (PAL), 1 (NTSC), 2 (SECAM), 3
(PAL NC no colour). Default: 0 (PAL)
- on_event_end string
- Values: Max 4095 characters / Default: Not defined
Command to be executed when an event ends after a period of no motion. The
period of no motion is defined by option gap. You can use Conversion
Specifiers and spaces as part of the command.
- on_event_start string
- Values: Max 4095 characters / Default: Not defined
Command to be executed when an event starts. An event starts at first motion
detected after a period of no motion defined by gap. You can use
ConversionSpecifiers and spaces as part of the command.
- on_motion_detected string
- Values: Max 4095 characters / Default: Not defined
Command to be executed when a motion frame is detected. You can use
Conversion Specifiers and spaces as part of the command.
- on_movie_end string
- Values: Max 4095 characters / Default: Not defined
Command to be executed when an ffmpeg movie is closed at the end of an
event. You can use Conversion Specifiers and spaces as part of the
command. Use %f for passing filename (with full path) to the command.
- on_movie_start string
- Values: Max 4095 characters / Default: Not defined
Command to be executed when an mpeg movie is created. You can use Conversion
Specifiers and spaces as part of the command. Use %f for passing filename
(with full path) to the command.
- on_picture_save string
- Values: Max 4095 characters / Default: Not defined
Command to be executed when an image is saved. You can use Conversion
Specifiers and spaces as part of the command. Use %f for passing filename
(with full path) to the command.
- output_all boolean
- Values: on, off / Default: off
Picture are saved continuously as if motion was detected all the time.
- output_motion boolean
- Values: on, off / Default: off
Output pictures with only the moving object. This feature generates the
special motion type movies where you only see the pixels that changes as a
graytone image. If labelling is enabled you see the largest area in blue.
Smartmask is shown in red.
- output_normal discrete strings
- Values: on, off, first, best / Default: on
Normal image is an image that is stored when motion is detected. It is the
same image that was taken by the camera. I.e. not a motion image like
defined by output_motion. Default is that normal images are stored.
- pgsql_db string
- Values: Max 4095 characters / Default: Not defined
Name of the PostgreSQL database.
- pgsql_host string
- Values: Max 4095 characters / Default: localhost
IP address or domain name for the PostgreSQL server. Use
"localhost" if motion and PostgreSQL runs on the same
server.
- pgsql_password string
- Values: Max 4095 characters / Default: Not defined
The PostgreSQL password.
- pgsql_port integer
- Values: 0 - 65535 / Default: 5432
The PostgreSQL server port number.
- pgsql_user string
- Values: Max 4095 characters / Default: Not defined
The PostgreSQL user name.
- post_capture integer
- Values: 0 - 2147483647 / Default: 0 (disabled)
Specifies the number of frames to be captured after motion has been
detected.
- ppm boolean
- Values: on, off / Default: off
Output ppm images instead of jpeg. This uses less CPU time, but causes a LOT
of hard disk I/O, and it is generally slower than jpeg.
- pre_capture integer
- Values: 0 - 100s / Default: 0 (disabled)
Specifies the number of previous frames to be outputted at motion detection.
Recommended range: 0 to 5, default=0. Do not use large values! Large
values will cause Motion to skip video frames and cause unsmooth mpegs. To
smooth mpegs use larger values of post_capture instead.
- process_id_file string
- Values: Max 4095 characters / Default: Not defined
File to store the process ID, also called pid file. Recommended value when
used: /var/run/motion.pid
- quality integer
- Values: 1 - 100 / Default: 75
The quality for the jpeg images in percent.
- quiet boolean
- Values: on, off / Default: off
Be quiet, don't output beeps when detecting motion.
- rotate discrete strings
- Values: 0, 90, 180, 270 / Default: 0 (not rotated)
Rotate image the given number of degrees. The rotation affects all saved
images as well as mpeg movies.
- roundrobin_frames integer
- Values: 1 - 2147483647 / Default: 1
Specifies the number of frames to capture before switching inputs, this way
also slow switching (e.g. every second) is possible.
- roundrobin_skip integer
- Values: 1 - 2147483647 / Default: 1
Specifies the number of frames to skip after a switch. (1 if you are feeling
lucky, 2 if you want to be safe).
- saturation integer
- Values: 0 - 255 / Default: 0 (disabled)
The colour saturation level for the video device.
- setup_mode boolean
- Values: on, off / Default: off
Run Motion in setup mode.
- smart_mask_speed integer
- Values: 0 - 10 / Default: 0 (disabled)
Slugginess of the smart mask. Default is 0 = DISABLED. 1 is slow, 10 is
fast.
- snapshot_filename string
- Values: Max 4095 characters / Default:
%v-%Y%m%d%H%M%S-snapshot
File path for snapshots (jpeg or ppm) relative to target_dir.
- snapshot_interval integer
- Values: 0 - 2147483647 / Default: 0 (disabled)
Make automated snapshots every 'snapshot_interval' seconds.
- sql_log_image boolean
- Values: on, off / Default: on
Log to the database when creating motion triggered image file.
- sql_log_mpeg boolean
- Values: on, off / Default: off
Log to the database when creating motion triggered mpeg file.
- sql_log_snapshot boolean
- Values: on, off / Default: on
Log to the database when creating a snapshot image file.
- sql_log_timelapse boolean
- Values: on, off / Default: off
Log to the database when creating timelapse mpeg file
- sql_query string
- Values: Max 4095 characters / Default: insert into
security(camera, filename, frame, file_type, time_stamp, text_event)
values('%t', '%f', '%q', '%n', '%Y-%m-%d %T', '%C')
SQL query string that is sent to the database. The values for each field are
given by using convertion specifiers
- switchfilter boolean
- Values: on, off / Default: off
Turns the switch filter on or off. The filter can distinguish between most
switching noise and real motion. With this you can even set
roundrobin_skip to 1 without generating much false detection.
- target_dir string
- Values: Max 4095 characters / Default: Not defined =
current working directory
Target directory for picture and movie files.
- text_changes boolean
- Values: on, off / Default: off
Turns the text showing changed pixels on/off.
- text_double boolean
- Values: on, off / Default: off
Draw characters at twice normal size on images.
- text_event string
- Values: Max 4095 characters / Default: %Y%m%d%H%M%S
This option defines the value of the speciel event conversion specifier %C.
You can use any conversion specifier in this option except %C. Date and
time values are from the timestamp of the first image in the current
event.
- text_left string
- Values: Max 4095 characters / Default: Not defined
User defined text overlayed on each in the lower left corner. Use A-Z, a-z,
0-9, " / ( ) @ ~ # < > | , . : - + _ and conversion specifiers
(codes starting by a %).
- text_right string
- Values: Max 4095 characters / Default: %Y-%m-%d0T
User defined text overlayed on each in the lower right corner. Use A-Z, a-z,
0-9, " / ( ) @ ~ # < > | , . : - + _ and conversion specifiers
(codes starting by a %). Default: %Y-%m-%d0T = date in ISO format and time
in 24 hour clock
- thread string
- Values: Max 4095 characters / Default: Not defined
Specifies full path and filename for a thread config file. Each camera needs
a thread config file containing the options that are unique to the camera.
If you only have one camera you do not need thread config files. If you
have two or more cameras you need one thread config file for each camera
in addition to motion.conf. This option must be placed in motion.conf and
not in a thread config file.
- threshold integer
- Values: 1 - 2147483647 / Default: 1500
Threshold for declaring motion. The threshold is the number of changed
pixels counted after noise filtering, masking, despeckle, and
labelling.
- threshold_tune boolean
- Values: on, off / Default: off
Activates the automatic tuning of threshold level.
- timelapse_filename string
- Values: Max 4095 characters / Default: %v-%Y%m%d-timelapse
File path for timelapse mpegs relative to target_dir (ffmpeg only).
- track_auto boolean
- Values: on, off / Default: off
Enable auto tracking
- track_iomojo_id integer
- Values: 0 - 2147483647 / Default: 0
Use this option if you have an iomojo smilecam connected to the serial port
instead of a general stepper motor controller.
- track_maxx integer
- Values: 0 - 2147483647 / Default: 0
The maximum position for servo x.
- track_maxy integer
- Values: 0 - 2147483647 / Default: 0
The maximum position for servo y.
- track_motorx integer
- Values: -1 - 2147483647 / Default: -1
The motor number that is used for controlling the x-axis.
- track_motory integer
- Values: -1 - 2147483647 / Default: -1
The motor number that is used for controlling the y-axis.
- track_move_wait integer
- Values: 0 - 2147483647 / Default: 10
Delay during which tracking is disabled after auto tracking has moved the
camera. Delay is defined as number of picture frames.
- track_port string
- Values: Max 4095 characters / Default: Not defined
This is the device name of the serial port to which the stepper motor
interface is connected.
- track_speed integer
- Values: 0 - 255 / Default: 255
Speed to set the motor to.
- track_step_angle_x integer
- Values: 0-90 / Default: 10
Angle in degrees the camera moves per step on the X-axis with auto tracking.
Currently only used with pwc type cameras.
- track_step_angle_y integer
- Values: 0-40 / Default: 10
Angle in degrees the camera moves per step on the Y-axis with auto tracking.
Currently only used with pwc type cameras.
- track_stepsize integer
- Values: 0 - 255 / Default: 40
Number of steps to make.
- track_type discrete strings
- Values: 0 (none), 1 (stepper), 2 (iomojo), 3 (pwc), 4
(generic), 5 (uvcvideo) / Default: 0 (None)
Type of tracker.
- tunerdevice string
- Values: Max 4095 characters / Default: /dev/tuner0
The tuner device used for controlling the tuner in a tuner card. This option
is only used when Motion is compiled for FreeBSD.
- video_pipe string
- Values: Max 4095 characters / Default: Not defined
The video4linux video loopback input device for normal images. If a
particular pipe is to be used then use the device filename of this pipe.
If a dash '-' is given motion will use /proc/video/vloopback/vloopbacks to
locate a free pipe.
- videodevice string
- Values: Max 4095 characters / Default: /dev/video0
(FreeBSD: /dev/bktr0)
The video device to be used for capturing. Default for Linux is /dev/video0.
for FreeBSD the default is /dev/bktr0.
- webcam_limit integer
- Values: 0 - 2147483647 / Default: 0 (unlimited)
Limit the number of frames to number frames. After 'webcam_limit' number of
frames the connection will be closed by motion. The value 0 means
unlimited.
- webcam_localhost boolean
- Values: on, off / Default: on
Limits the access to the webcam to the localhost.
- webcam_maxrate integer
- Values: 1 - 100 / Default: 1
Limit the framerate of the webcam in frames per second. Default is 1. Set
the value to 100 for practically unlimited.
- webcam_motion boolean
- Values: on, off / Default: off
If set to 'on' Motion sends slows down the webcam stream to 1 picture per
second when no motion is detected. When motion is detected the stream runs
as defined by webcam_maxrate. When 'off' the webcam stream always runs as
defined by webcam_maxrate.
- webcam_port integer
- Values: 0 - 65535 / Default: 0 (disabled)
TCP port on which motion will listen for incoming connects with its webcam
server.
- webcam_quality integer
- Values: 1 - 100 / Default: 50
Quality setting in percent for the mjpeg picture frames transferred over the
webcam connection. Keep it low to restrict needed bandwidth.
- width integer
- Values: Device Dependent / Default: 352
The width in pixels of each frame. Valid range is camera dependent.
SIGNALS¶
Motion responds to the following signals:
- SIGHUP
- The config file will be reread.
- SIGTERM
- If needed motion will create an mpeg file of the last event
and exit
- SIGUSR1
- Motion will create an mpeg file of the current event.
NOTES¶
- Snapshot
- A snapshot is a picture taken at regular intervals
independently of any movement in the picture.
- Motion image
- A "motion" image/mpeg shows the pixels that have
actually changed during the last frames. These pictures are not very
useful for normal presentation to the public but they are quite useful for
testing and tuning and making mask files as you can see exactly where
motion sees something moving. Motion is shown in greytones. If labelling
is enabled the largest area is marked as blue. Smart mask is shown in
read.
- Normal image
- A "normal" image is the real image taken by the
camera with text overlayed.
- Threads and config files
- If Motion was invoked with command line option -c pathname
Motion will expect the config file to be as specified. When you specify
the config file on the command line with -c you can call it anything.
If you do not specify -c or the filename you give Motion does not exist,
Motion will search for the configuration file called 'motion.conf' in the
following order:
1. Current directory from where motion was invoked
2. Then in a directory called '.motion' in the current users home directory
(shell environment variable $HOME). E.g. /home/goofy/.motion/motion.conf
3. The directory defined by the --sysconfdir=DIR when running .configure
during installation of Motion (If this option was not defined the default
is /usr/local/etc/)
If you have write access to /usr/local/etc then the editor recommends having
only one motion.conf file in the default /usr/local/etc/ directory.
Motion has a configuration file in the distribution package called
motion-dist.conf. When you run 'make install' this files gets copied to
the /usr/local/etc directory.
The configuration file needs to be renamed from motion-dist.conf to
motion.conf. The original file is called motion-dist.conf so that your
perfectly working motion.conf file does not accidentally get overwritten
when you re-install or upgrade to a newer version of Motion.
If you have more than one camera you should not try and invoke Motion more
times. Motion is made to work with more than one camera in a very elegant
way and the way to do it is to create a number of thread config files.
Motion will then create an extra tread of itself for each camera. If you
only have one camera you only need the motion.conf file. The minute you
have two or more cameras you must have one thread config file per camera
besides the motion.conf file.
So if you have for example two cameras you need motion.conf and two thread
config files. Total of 3 config files.
An option that is common to all cameras can be placed in motion.conf. (You
can also put all parameters in the thread files but that makes a lot of
editing when you change a common thing).
An option that is unique to a camera must be defined in each thread file.
The first camera is defined in the first thread file called from
motion.conf. The 2nd camera is defined in the 2nd thread file called from
motion.conf etc.
Any option defined in motion.conf will be used for all cameras except for
the cameras in which the same option is defined in a thread config file.
Motion reads its configuration parameters in the following sequence. If the
same parameter exists more than one place the last one read wins.
1. Motion reads the configuration file motion.conf from the beginning of the
file going down line by line.
2. If the option "thread" is defined in motion.conf, the thread
configuration file(s) is/(are) read.
3. Motion continues reading the rest of the motion.conf file. Any options
from here will overrule the same option previously defines in a thread
config file.
4. Motion reads the command line option again overruling any previously
defined options.
So always call the thread config files in the end of the motion.conf file.
If you define options in motion.conf AFTER the thread file calls, the same
options in the thread files will never be used. So always put the thread
file call at the end of motion.conf.
If motion is built without specific features such as ffmpeg, mysql etc it
will ignore the options that belongs to these features. You do not have to
remove them or comment them out.
If you run the http control command http://host:port/0/config/writeyes,
motion will overwrite motion.conf and all the thread.conf files by
autogenerated config files neatly formatted and only with the features
included that Motion was built with. If you later re-build Motion with
more features or upgrade to a new version, you can use your old config
files, run the motion.conf.write command, and you will have new config
files with the new options included all set to their default values. This
makes upgrading very easy to do.
- Conversion Specifiers for Advanced Filename and Text
Features
- The table below shows all the supported Conversion
Specifiers you can use in the options text_left, text_right,
snapshot_filename, jpeg_filename, ffmpeg_filename, timelapse_filename,
on_event_start, on_event_end, on_picture_save, on_movie_start,
on_movie_end, and on_motion_detected.
In text_left and text_right you can additionally use '0 for new line.
- %a
- The abbreviated weekday name according to the current
locale.
- %A
- The full weekday name according to the current locale.
- %b
- The abbreviated month name according to the current
locale.
- %B
- The full month name according to the current locale.
- %c
- The preferred date and time representation for the current
locale.
- %C
- Text defined by the text_event feature
- %d
- The day of the month as a decimal number (range 01 to
31).
- %D
- Number of pixels detected as Motion. If labelling is
enabled the number is the number of pixels in the largest labelled motion
area.
- %E
- Modifier: use alternative format, see below.
- %f
- File name - used in the on_picture_save, on_movie_start,
on_movie_end, and sql_query features.
- %F
- Equivalent to %Y-%m-%d (the ISO 8601 date format).
- %H
- The hour as a decimal number using a 24-hour clock (range
00 to 23).
- %i
- Width of the rectangle containing the motion pixels (the
rectangle that is shown on the image when locate is on).
- %I
- The hour as a decimal number using a 12-hour clock (range
01 to 12).
- %j
- The day of the year as a decimal number (range 001 to
366).
- %J
- Height of the rectangle containing the motion pixels (the
rectangle that is shown on the image when locate is on).
- %k
- The hour (24-hour clock) as a decimal number (range 0 to
23); single digits are preceded by a blank. (See also %H.)
- %K
- X coordinate in pixels of the center point of motion.
Origin is upper left corner.
- %l
- The hour (12-hour clock) as a decimal number (range 1 to
12); single digits are preceded by a blank. (See also %I.)
- %L
- Y coordinate in pixels of the center point of motion.
Origin is upper left corner and number is positive moving downwards (I may
change this soon).
- %m
- The month as a decimal number (range 01 to 12).
- %M
- The minute as a decimal number (range 00 to 59).
- %n
- Filetype as used in the on_picture_save, on_movie_start,
on_movie_end, and sql_query features.
- %N
- Noise level.
- %o
- Threshold. The number of detected pixels required to
trigger motion. When threshold_tune is 'on' this can be used to show the
current tuned value of threshold.
- %p
- Either 'AM' or 'PM' according to the given time value, or
the corresponding strings for the current locale. Noon is treated as `pm'
and midnight as `am'.
- %P
- Like %p but in lowercase: `am' or `pm' or a corresponding
string for the current locale.
- %q
- Picture frame number within current second. For jpeg
filenames this should always be included in the filename if you save more
then 1 picture per second to ensure unique filenames. It is not needed in
filenames for mpegs.
- %Q
- Number of detected labels found by the despeckle
feature
- %r
- The time in a.m. or p.m. notation.
- %R
- The time in 24-hour notation (%H:%M).
- %s
- The number of seconds since the Epoch, i.e., since
1970-01-01 00:00:00 UTC.
- %S
- The second as a decimal number (range 00 to 61).
- %t
- Thread number (camera number)
- %T
- The time in 24-hour notation (%H:%M:%S).
- %u
- The day of the week as a decimal, range 1 to 7, Monday
being 1. See also %w.
- %U
- The week number of the current year as a decimal number,
range 00 to 53, starting with the first Sunday as the first day of week
01. See also %V and %W.
- %v
- Event number. An event is a series of motion detections
happening with less than 'gap' seconds between them.
- %V
- The ISO 8601:1988 week number of the current year as a
decimal number, range 01 to 53, where week 1 is the first week that has at
least 4 days in the current year, and with Monday as the first day of the
week. See also %U and %W.
- %w
- The day of the week as a decimal, range 0 to 6, Sunday
being 0. See also %u.
- %W
- The week number of the current year as a decimal number,
range 00 to 53, starting with the first Monday as the first day of week
01.
- %x
- The preferred date representation for the current locale
without the time.
- %X
- The preferred time representation for the current locale
without the date.
- %y
- The year as a decimal number without a century (range 00 to
99).
- %Y
- The year as a decimal number including the century.
- %z
- The time-zone as hour offset from GMT.
- %Z
- The time zone or name or abbreviation.
- More information
- Motion homepage: http://motion.sourceforge.net/
Motion Guide (user and installation guide):
AUTHORS¶
Jeroen Vreeken (pe1rxq@amsat.org), Folkert van Heusden, Kenneth Lavrsen
(kenneth@lavrsen.dk) Juan Angulo Moreno <juan@apuntale.com>