xenial (1) motion.1.gz

Provided by: motion_3.2.12+git20140228-8build1_amd64 bug

NAME

       motion -   Detect motion using a video4linux device

SYNOPSIS

       motion  [  -hmns  ]  [ -c config file path ] [ -d log level ] [ -k log type ] [ -p process_id_file ] [ -l
       logfile ]

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/motion  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.

       -m     Disable motion detection at startup.

       -n     Run in non-daemon mode.

       -s     Run in setup mode. Also forces non-daemon mode

       -d log level
              Set log level [1..9] (EMR, ALR, CRT, ERR, WRN, NTC, INF, DBG, ALL). (default: 6 / NTC)

       -k log type
              Set type of log (COR, STR, ENC, NET, DBL, EVT, TRK, VID, ALL). (default: ALL)

       -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.

       -l     Full path and filename of log file. ( use -l syslog to log to stderr and syslog )

       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).

       area_detect integer
              Values: 0 - 999999999 / Default: Not defined
              Detect motion in predefined areas (1 - 9). Areas are numbered like that:  1 2 3
              A script (on_area_detected) is started immediately when motion is         4 5 6
              detected in one of the given areas, but only once during an event.        7 8 9
              One  or  more  areas  can  be specified with this option. Take care: This option does NOT restrict
              detection to these areas! (Default: not defined)

       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.

       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.

       database_dbname string
              Values: Max 4095 characters / Default: Not defined
              Name of the database.

       database_host string
              Values: Max 4095 characters / Default: localhost
              IP address or domain name for the database server. Use "localhost" if motion and database runs  on
              the same server.

       database_password string
              Values: Max 4095 characters / Default: Not defined
              The database password.

       database_port integer
              Values: 0 - 65535 / Default: Not defined
              The database server port number.

       database_type discrete strings
              Values: mysql, postgresql / Default: Not defined
              The database type ( mysql , postgresql ).

       database_user string
              Values: Max 4095 characters / Default: Not defined
              The database user name.

       despeckle_filter 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.

       emulate_motion boolean
              Values: on, off / Default: off
              Picture are saved continuously as if motion was detected all the time.

       event_gap integer
              Values: 0 - 2147483647 / Default: 60
              Event 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.

       exif_text string
              Values:  Max 4095 characters /  Default: Not defined
              Text  to  include  in  a JPEG EXIF comment , may be any text, including conversion specifiers. The
              EXIF timestamp is included independent of this text.

       extpipe string
              Values: Max 4095 characters / Default: Not defined
              pipe raw video to generally - 'STDIN', allowing to use an external video encoder.
              e.g. using memcoder :
              extpipe  mencoder  -demuxer   rawvideo   -rawvideo   w=320:h=240:i420   -ovc   x264   -x264encopts
              bframes=4:frameref=1:subq=1:scenecut=-1:nob_adapt:
              threads=1:keyint=1000:8x8dct:vbv_bufsize=4000:crf=24:partitions=i8x8,i4x4:vbv_maxrate=800:no-
              chroma-me -vf denoise3d=16:12:48:4,pp=lb -of   avi -o %f.avi - -fps %fps

       ffmpeg_bps integer
              Values: 0 - 9999999 / Default: 400000
              Bitrate  of  movies  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_output_debug_movies boolean
              Values: on, off / Default: off
              Use ffmpeg libraries to encode motion type movies where you only see the pixels that changes.

       ffmpeg_output_movies boolean
              Values: on, off / Default: off
              Use ffmpeg libraries to encode 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 integer
              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, mov, ogg / Default: mpeg4
              Codec  to  be  used by ffmpeg for the video compression. Timelapse movies 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 integer
              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)

       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: -1 - 64, -1 = disabled / Default: -1 (disabled)
              Input channel to use expressed as an integer number starting from -1. Should normally be set to  1
              for video/TV cards, and -1 for USB cameras.

       ipv6_enabled boolean
              Values: on, off / Default: off
              Enable or disable IPV6 for http control and stream.

       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_motion discrete strings
              Values: on, off, redbox, center, redcross, 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 movie.

       logfile string
              Values: Max 4095 characters / Default: Not defined
              Use a file to save logs messages, if not defined stderr and syslog is used.

       logfile string
              Values: Max 4095 characters / Default: Not defined
              Use  a  file  to  save logs messages, if not defined stderr and syslog is used. ( if syslog is set
              then will log to stderr and syslog )

       log_level integer
              Values: 1 - 9 / Default: 6
              Level of log messages [1..9] (EMR, ALR, CRT, ERR, WRN, NTC, ERR, DBG, ALL). (default: 6 / NTC).

       log_type discrete strings
              Values: STR, ENC, NET, DBL, EVT, TRK, VID, ALL / Default: ALL
              Filter to log messages by type (STR, ENC, NET, DBL, EVT, TRK, VID, ALL).

       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_movie_time integer
              Values: 0 (infinite) - 2147483647 / Default: 3600
              The maximum length of a 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 integer
              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 relative to target_dir. This  was  previously  called
              ffmpeg_filename.

       netcam_tolerant_check boolean
              Values: on, off / Default: off
              Set less strict jpeg checks for network cameras with a poor/buggy firmware.

       netcam_keepalive discrete string
              Values: off , force, on / Default: off
              The  setting  for  keep-alive  of  network  socket,  should  improve performance on compatible net
              cameras.

       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.
              http:// ftp:// mjpg:// or file:/// ( mjpg:// is for network cameras with codec mjpeg ).

       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.

       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 integer
              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_area_detected string
              Values: Max 4095 characters / Default: Not defined
              Command to be executed when motion in a predefined area is detected, check option area_detect.

       on_camera_lost
              Values: Max 4095 characters / Default: Not defined
              Command to be executed when a camera can't be opened or if it is  lost.  You  can  use  Conversion
              Specifiers  and spaces as part of the command. Use %f for passing filename (with full path) to the
              command.

       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 event_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 event_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 a 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_debug_pictures 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_pictures discrete strings
              Values: on, off, first, best, center / 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.

       picture_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 movie file.

       picture_type discrete strings
              Values: jpeg , ppm / Default: jpeg
              Type of images motion will trigger when motion is detected.

       post_capture integer
              Values: 0 - 2147483647 / Default: 0 (disabled)
              Specifies the number of frames to be captured after motion has been detected.

       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 movies. To smooth movies 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 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.

       sdl_threadnr
              Values: 0 - 2147483647 / Default: 0 (disabled)
              Number of motion thread to show in SDL Window (default: 0 = disabled)

       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_picture boolean
              Values: on, off / Default: on
              Log to the database when creating motion triggered image file.

       sql_log_movie boolean
              Values: on, off / Default: off
              Log to the database when creating motion triggered movie 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 movie 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

       stream_auth_method integer
              Values: 0 = disabled , 1 = Basic authentication ,2 = MD5  digest  (the  safer  authentication).  /
              Default: 0 (disabled)
              Set the authentication method for stream.

       stream_authentication string
              Values: username:password / Default: not defined (disabled)
              Authentication for the stream.

       stream_limit integer
              Values: 0 - 2147483647 / Default: 0 (unlimited)
              Limit  the number of frames to number frames. After 'stream_limit' number of frames the connection
              will be closed by motion. The value 0 means unlimited.

       stream_localhost boolean
              Values: on, off / Default: on
              Limits the access to the stream to the localhost.

       stream_maxrate integer
              Values: 1 - 100 / Default: 1
              Limit the framerate of the stream in frames per second. Default is 1. Set the  value  to  100  for
              practically unlimited.

       stream_motion boolean
              Values: on, off / Default: off
              If  set  to  'on'  Motion  sends  slows  down the stream to 1 picture per second when no motion is
              detected. When motion is detected the stream runs as defined by  stream_maxrate.  When  'off'  the
              stream always runs as defined by stream_maxrate.

       stream_port integer
              Values: 0 - 65535 / Default: 0 (disabled)
              TCP port on which motion will listen for incoming connects with its stream server.

       stream_quality integer
              Values: 1 - 100 / Default: 50
              Quality  setting  in  percent for the mjpeg picture frames transferred over the stream connection.
              Keep it low to restrict needed bandwidth.

       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 special 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, " / ( ) @ ~ # < >
              | , . : - + _ \n and conversion specifiers (codes starting by a %).

       text_right string
              Values: Max 4095 characters / Default: %Y-%m-%d\n%T
              User  defined text overlayed on each in the lower right corner. Use A-Z, a-z, 0-9, " / ( ) @ ~ # <
              > | , . : - + _ \n and conversion specifiers (codes starting by a %). Default: %Y-%m-%d\n%T = 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 movies relative to target_dir (ffmpeg only).

       track_auto boolean
              Values: on, off / Default: off
              Enable auto tracking

       track_iomojo_id integer
              Values: 0 - 65535 / 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 - 65535 / Default: 0
              The maximum position for servo x.

       track_maxy integer
              Values: 0 - 65535 / Default: 0
              The maximum position for servo y.

       track_motorx integer
              Values: 0 - 65535 / Default: 0
              The motor number that is used for controlling the x-axis.

       track_motory integer
              Values: 0 - 65535 / Default: 0
              The motor number that is used for controlling the y-axis.

       track_move_wait integer
              Values: 0 - 65535 / 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.

       use_extpipe boolean
              Values: on, off / Default: off
              Enables extpipe to use an external video encoder feeding with YUV420 using a pipe .

       v4l2_palette discrete strings
              Values: 0 - 8 / Default: 8
              Allow  to  choose  preferable  palette to be use by motion to capture from those supported by your
              videodevice.

       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.

       webcontrol_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.

       webcontrol_html_output boolean
              Values: on, off / Default: on
              Enable  HTML  in  the answer sent back to a browser connecting to the webcontrol_port. This option
              must be placed in motion.conf and not in a  thread config file.

       webcontrol_localhost boolean
              Values: on, off / Default: on
              Limits the webcontrol to the localhost. This option must be placed in motion.conf  and  not  in  a
              thread config file.

       webcontrol_port integer
              Values: 0 - 65535 / Default: 0 (disabled)
              Sets  the  port number for the http (html using browser) based remote webcontrol. This option must
              be placed in motion.conf and not in a thread config file.

       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 a movie file of the last event and exit

       SIGUSR1
              Motion will create a movie 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/movie 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/motion then the editor recommends having only one
              motion.conf file in the default /usr/local/etc/motion 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/motion 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  webcontrol  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,  picture_filename,  movie_filename,  timelapse_filename,
              on_area_detected,  on_camera_lost,  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 '\n' 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_motion 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_motion 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 movies.

       %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):
              http://www.lavrsen.dk/twiki/bin/view/Motion/MotionGuide
              http://www.lavrsen.dk/twiki/bin/view/Motion/VideoFourLinuxLoopbackDevice

AUTHORS

       Jeroen Vreeken (pe1rxq@amsat.org), Folkert van Heusden, Kenneth Lavrsen (kenneth@lavrsen.dk)