motion中的motion.conf的一种配置

# Rename this distribution example file to motion.conf
#
# This config file was generated by motion 3.2.9


############################################################
# Daemon
############################################################


# Start in daemon (background) mode and release terminal (default: off)
关掉deamon模式。最好这项还是选off，否则运行motion后，就会直接在后台运行，需要用top命令查看出motion的进程号（pid），然后再手动kill掉这个进程。
daemon off


# File to store the process ID, also called pid file. (default: not defined)  文件存放进程ID，也称为PID文件。 （默认值：未定义）
process_id_file /var/run/motion.pid 


############################################################
# Basic Setup Mode  基本设定模式
############################################################


# Start in Setup-Mode, daemon disabled. (default: off)   开始设置模式，守护进程禁用。 （默认：关闭）
setup_mode off


###########################################################
# Capture device options  捕获设备选项 
############################################################


# Videodevice to be used for capturing  (default /dev/video0)
# for FreeBSD default is /dev/bktr0
设置加载USB摄像头的设备，一般都是这个video0，当使用network webcam时，需要设置netcam_url，此时，videodevice选项自动失效。
videodevice /dev/video0


# Tuner device to be used for capturing using tuner as source (default /dev/tuner0)
# This is ONLY used for FreeBSD. Leave it commented out for Linux
; tunerdevice /dev/tuner0


# The video input to be used (default: 8)
# Should normally be set to 1 for video/TV cards, and 8 for USB cameras
可使用输入视频（默认值：8） 
一般应设置为1个视频/电视卡，和8个USB摄像头
input 8


# The video norm to use (only for video capture and TV tuner cards)
# Values: 0 (PAL), 1 (NTSC), 2 (SECAM), 3 (PAL NC no colour). Default: 0 (PAL)
视频制式（仅适用于视频拍摄和电视调谐器卡） 
值：0（PAL制式），1（NTSC制式），2（SECAM制式），3（PAL NC无颜色）。默认值：0（PAL制式）
norm 0


# The frequency to set the tuner to (kHz) (only for TV tuner cards) (default: 0)
频率调谐器设置为（千赫）（仅适用于电视调谐器卡）（默认值：0）
frequency 0


# Rotate image this number of degrees. The rotation affects all saved images as
# well as mpeg movies. Valid values: 0 (default = no rotation), 90, 180 and 270.
图像旋转度度数。旋转会影响所有保存的图像，及MPEG电影。有效值：0（默认值=无旋转），90，180和270。
rotate 0


# Image width (pixels). Valid range: Camera dependent, default: 352
图像宽度（像素）。有效范围：相机依赖，默认值：352
width 320


# Image height (pixels). Valid range: Camera dependent, default: 288
图像高度（像素）。有效范围：相机依赖，默认值：288
height 240


# Maximum number of frames to be captured per second.
# Valid range: 2-100. Default: 100 (almost no limit).
每秒可捕获的帧的最大数量。 
有效范围：2-100。默认值：100（几乎没有限制）。
framerate 30


# Minimum time in seconds between capturing picture frames from the camera.
# Default: 0 = disabled - the capture rate is given by the camera framerate.
# This option is used when you want to capture images at a rate lower than 2 per second.
从相机帧秒捕捉图像的最短时间
默认值：0=禁用 - 捕获速率由相机帧率给出。
当你想要捕捉图像的速度小于每秒2下时使用此选项。 
minimum_frame_time 0


# URL to use if you are using a network camera, size will be autodetected (incl http:// ftp:// or file:///)
# Must be a URL that returns single jpeg pictures or a raw mjpeg stream. Default: Not defined
如果您使用的是网络摄像头时使用的网址，尺寸将被自动检测（包括包含http:// ftp://或file :///） 
必须返回单个JPEG图片或原始MJPEG流的URL。默认值：未定义
; netcam_url value


# Username and password for network camera (only if required). Default: not defined
# Syntax is user:password
用户名和密码，网络摄像头（只当如果需要的时候）。默认值：没有定义 
语法是用户名，密码
; netcam_userpass value


# URL to use for a netcam proxy server, if required, e.g. "http://myproxy".
# If a port number other than 80 is needed, use "http://myproxy:1234".
# Default: not defined
; netcam_proxy value 


# Let motion regulate the brightness of a video device (default: off).
# The auto_brightness feature uses the brightness option as its target value.
# If brightness is zero auto_brightness will adjust to average brightness value 128.
# Only recommended for cameras without auto brightness
auto_brightness off


# Set the initial brightness of a video device.
# If auto_brightness is enabled, this value defines the average brightness level
# which Motion will try and adjust to.
# Valid range 0-255, default 0 = disabled
设置视频设备的初始亮度。 
如果auto_brightness被启用，该值定义的平均亮度水平 
该运动将尝试和调整。 
有效范围0-255，默认为0=禁用
brightness 0


# Set the contrast of a video device.
# Valid range 0-255, default 0 = disabled
设置一个视频装置的对比度。 
有效范围0-255，默认为0=禁用
contrast 0


# Set the saturation of a video device.
# Valid range 0-255, default 0 = disabled
设置视频设备的饱和度。 
有效范围0-255，默认为0=禁用
saturation 0


# Set the hue of a video device (NTSC feature).
# Valid range 0-255, default 0 = disabled
设置视频设备（NTSC功能）的色调。 
有效范围0-255，默认为0=禁用
hue 0




############################################################
# Round Robin (multiple inputs on same video device name)
############################################################


# Number of frames to capture in each roundrobin step (default: 1)
roundrobin_frames 1


# Number of frames to skip before each roundrobin step (default: 1)
roundrobin_skip 1


# Try to filter out noise generated by roundrobin (default: off)
switchfilter off




############################################################
# Motion Detection Settings:
############################################################


# Threshold for number of changed pixels in an image that
# triggers motion detection (default: 1500)
阈值变化像素的图像数 
触发移动侦测（默认值：1500）
定义了比较的阀值，当2帧图像比较时，变化的像素点超过阀值则认为图像有变化
threshold 5000


# Automatically tune the threshold down if possible (default: off)
如果设置了会自动调整阀值使其降下来，（默认值：关闭）
设置是否使用motion detection阈值自动调节。当设置为on时，下一个设置threshold 4500自动失效。设置off时，可以由threshold指定当探测到多少像素变化时，判断为图像中有运动。
threshold_tune off


# Noise threshold for the motion detection (default: 32)
noise_level 32


# Automatically tune the noise threshold (default: on)
noise_tune on


# Enables motion to adjust its detection/noise level for very dark frames
# Don't use this with noise_tune on. (default: off)
night_compensate off


# Despeckle motion image using (e)rode or (d)ilate or (l)abel (Default: not defined)
# Recommended value is EedDl. Any combination (and number of) of E, e, d, and D is valid.
# (l)abeling must only be used once and the 'l' must be the last letter.
# Comment out to disable
despeckle EedDl


# PGM file to use as a sensitivity mask.
# Full path name to. (Default: not defined)
; mask_file value


# Dynamically create a mask file during operation (default: 0)
# Adjust speed of mask changes from 0 (off) to 10 (fast)
smart_mask_speed 0


# Ignore sudden massive light intensity changes given as a percentage of the picture
# area that changed intensity. Valid range: 0 - 100 , default: 0 = disabled
lightswitch 0


# 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: 1 to thousands, recommended 1-5
minimum_motion_frames 1


# Specifies the number of pre-captured (buffered) pictures from before motion
# was detected that will be output 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.
pre_capture 0


# Number of frames to capture after motion is no longer detected (default: 0)
post_capture 0


# 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.
# Recommended value is 60 seconds (Default). The value 0 is allowed and disables
# events causing all Motion to be written to one single mpeg file and no pre_capture.
当检测到运动后，多长时间没有运动的话就触发运动结束指令。on_event_end
gap 2


# Maximum length in seconds of an mpeg movie
# When value is exceeded a new mpeg file is created. (Default: 0 = infinite)
max_mpeg_time 0


# Number of frames per second to capture when not detecting
# motion (saves CPU load) (Default: 0 = disabled)
low_cpu 0


# Always save images even if there was no motion (default: off)
output_all off




############################################################
# Image File Output
############################################################


# Output 'normal' pictures when motion is detected (default: on)
# Valid values: on, off, first, best
# When set to 'first', only the first picture of an event is saved.
# Picture with most motion of an event is saved when set to 'best'.
# Can be used as preview shot for the corresponding movie.
output_normal on


# Output pictures with only the pixels moving object (ghost images) (default: off)
output_motion off


# The quality (in percent) to be used by the jpeg compression (default: 75)
质量（以百分比表示）中使用的JPEG压缩（默认值：75）
设置图像的压缩质量
quality 75


# Output ppm images instead of jpeg (default: off)
ppm off




############################################################
# FFMPEG related options
# Film (mpeg) file output, and deinterlacing of the video input
# The options movie_filename and timelapse_filename are also used
# by the ffmpeg feature
FFMPEG相关选项
电影（MPEG）文件输出和视频输入的隔行扫描
通过ffmpeg的功能,movie_filename和timelapse_filename选项也会被用到


############################################################


# Use ffmpeg to encode mpeg movies in realtime (default: off)
实时的使用ffmpeg的编码MPEG影片（默认值：关闭）
当检测到运动时，用视频记录下来
ffmpeg_cap_new on


# Use ffmpeg to make movies with only the pixels moving
# object (ghost images) (default: off)
ffmpeg_cap_motion off


# Use ffmpeg to encode a timelapse movie 
# Default value 0 = off - else save frame every Nth second
ffmpeg_timelapse 0


# The file rollover mode of the timelapse video
# Valid values: hourly, daily (default), weekly-sunday, weekly-monday, monthly, manual
ffmpeg_timelapse_mode daily


# Bitrate to be used by the ffmpeg encoder (default: 400000)
# This option is ignored if ffmpeg_variable_bitrate is not 0 (disabled)
ffmpeg_bps 500000


# 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_variable_bitrate 0


# Codec to used by ffmpeg for the video compression.
# Timelapse mpegs are always made in mpeg1 format independent from this option.
# Supported formats are: mpeg1 (ffmpeg-0.4.8 only), mpeg4 (default), and msmpeg4.
# mpeg1 - gives you files with extension .mpg
# mpeg4 or msmpeg4 - give you files with extension .avi
# msmpeg4 is recommended for use with Windows Media Player because
# it requires no installation of codec on the Windows client.
# swf - gives you a flash film with extension .swf
# flv - gives you a flash video with extension .flv
# ffv1 - FF video codec 1 for Lossless Encoding ( experimental )
设定视屏的编码器，即是说视屏保存为xx.swf格式
ffmpeg_video_codec swf


# Use ffmpeg to deinterlace video. Necessary if you use an analog camera
# and see horizontal combing on moving objects in video or pictures.
# (default: off)
ffmpeg_deinterlace off




############################################################
# Snapshots (Traditional Periodic Webcam File Output)
############################################################


# Make automated snapshot every N seconds (default: 0 = disabled)
使每隔N秒自动快照（默认值：0=禁用）
设置自动采集图片的周期，0不自动采集图片
snapshot_interval 0




############################################################
# Text Display
# %Y = year, %m = month, %d = date,
# %H = hour, %M = minute, %S = second, %T = HH:MM:SS,
# %v = event, %q = frame number, %t = thread (camera) number,
# %D = changed pixels, %N = noise level, \n = new line,
# %i and %J = width and height of motion area,
# %K and %L = X and Y coordinates of motion center
# %C = value defined by text_event - do not use with text_event!
# You can put quotation marks around the text to allow
# leading spaces
############################################################


# Locate and draw a box around the moving object.
# Valid values: on, off and preview (default: off)
# Set to 'preview' will only draw a box in preview_shot pictures.
设置探测到图像中有运动时，把运动区域用矩形框起来。
locate on


# Draws the timestamp using same options as C function strftime(3)
# Default: %Y-%m-%d\n%T = date in ISO format and time in 24 hour clock
# Text is placed in lower right corner
text_right %Y-%m-%d\n%T-%q


# Draw a user defined text on the images using same options as C function strftime(3)
# Default: Not defined = no text
# Text is placed in lower left corner
; text_left CAMERA %t


# Draw the number of changed pixed on the images (default: off)
# Will normally be set to off except when you setup and adjust the motion settings
# Text is placed in upper right corner
text_changes off


# 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.
# Default: %Y%m%d%H%M%S
# The idea is that %C can be used filenames and text_left/right for creating
# a unique identifier for each event.
text_event %Y%m%d%H%M%S


# Draw characters at twice normal size on images. (default: off)
text_double off




############################################################
# Target Directories and filenames For Images And Films
# For the options snapshot_, jpeg_, mpeg_ and timelapse_filename
# you can use conversion specifiers
# %Y = year, %m = month, %d = date,
# %H = hour, %M = minute, %S = second,
# %v = event, %q = frame number, %t = thread (camera) number,
# %D = changed pixels, %N = noise level,
# %i and %J = width and height of motion area,
# %K and %L = X and Y coordinates of motion center
# %C = value defined by text_event
# Quotation marks round string are allowed.
############################################################


# Target base directory for pictures and films
# Recommended to use absolute path. (Default: current working directory)
当检测到运动时，图片和视频保存的路径
target_dir /root/motion


# File path for snapshots (jpeg or ppm) relative to target_dir
# Default: %v-%Y%m%d%H%M%S-snapshot
# Default value is equivalent to legacy oldlayout option
# For Motion 3.0 compatible mode choose: %Y/%m/%d/%H/%M/%S-snapshot
# File extension .jpg or .ppm is automatically added so do not include this.
# Note: A symbolic link called lastsnap.jpg created in the target_dir will always
# point to the latest snapshot, unless snapshot_filename is exactly 'lastsnap'
snapshot_filename %v-%Y%m%d%H%M%S-snapshot


# File path for motion triggered images (jpeg or ppm) relative to target_dir
# Default: %v-%Y%m%d%H%M%S-%q
# Default value is equivalent to legacy oldlayout option
# For Motion 3.0 compatible mode choose: %Y/%m/%d/%H/%M/%S-%q
# File extension .jpg or .ppm is automatically added so do not include this
# Set to 'preview' together with best-preview feature enables special naming
# convention for preview shots. See motion guide for details
jpeg_filename %v-%Y%m%d%H%M%S-%q


# File path for motion triggered ffmpeg films (mpeg) relative to target_dir
# Default: %v-%Y%m%d%H%M%S
# Default value is equivalent to legacy oldlayout option
# For Motion 3.0 compatible mode choose: %Y/%m/%d/%H%M%S
# File extension .mpg or .avi is automatically added so do not include this
# This option was previously called ffmpeg_filename
movie_filename %v-%Y%m%d%H%M%S


# File path for timelapse mpegs relative to target_dir
# Default: %Y%m%d-timelapse
# Default value is near equivalent to legacy oldlayout option
# For Motion 3.0 compatible mode choose: %Y/%m/%d-timelapse
# File extension .mpg is automatically added so do not include this
timelapse_filename %Y%m%d-timelapse




############################################################
# Live Webcam Server
############################################################


# The mini-http server listens to this port for requests (default: 0 = disabled)
webcam_port 8081


# Quality of the jpeg images produced (default: 50)
webcam_quality 50


# Output frames at 1 fps when no motion is detected and increase to the
# rate given by webcam_maxrate when motion is detected (default: off)
webcam_motion off


# Maximum framerate for webcam streams (default: 1)
webcam_maxrate 1


# Restrict webcam connections to localhost only (default: on)
webcam_localhost on


# Limits the number of images per connection (default: 0 = unlimited)
# Number can be defined by multiplying actual webcam rate by desired number of seconds
# Actual webcam rate is the smallest of the numbers framerate and webcam_maxrate
webcam_limit 0




############################################################
# HTTP Based Control
############################################################


# TCP/IP port for the http server to listen on (default: 0 = disabled)
control_port 8080


# Restrict control connections to localhost only (default: on)
control_localhost on


# Output for http server, select off to choose raw text plain (default: on)
control_html_output on


# Authentication for the http based control. Syntax username:password
# Default: not defined (Disabled)
; control_authentication username:password




############################################################
# Tracking (Pan/Tilt)
############################################################


# Type of tracker (0=none (default), 1=stepper, 2=iomojo, 3=pwc, 4=generic, 5=uvcvideo)
# The generic type enables the definition of motion center and motion size to
# be used with the conversion specifiers for options like on_motion_detected
track_type 0


# Enable auto tracking (default: off)
track_auto off


# Serial port of motor (default: none)
; track_port value


# Motor number for x-axis (default: -1)
track_motorx -1


# Motor number for y-axis (default: -1)
track_motory -1


# Maximum value on x-axis (default: 0)
track_maxx 0


# Maximum value on y-axis (default: 0)
track_maxy 0


# ID of an iomojo camera if used (default: 0)
track_iomojo_id 0


# Angle in degrees the camera moves per step on the X-axis
# with auto-track (default: 10)
# Currently only used with pwc type cameras
track_step_angle_x 10


# Angle in degrees the camera moves per step on the Y-axis
# with auto-track (default: 10)
# Currently only used with pwc type cameras
track_step_angle_y 10


# Delay to wait for after tracking movement as number
# of picture frames (default: 10)
track_move_wait 10


# Speed to set the motor to (stepper motor option) (default: 255)
track_speed 255


# Number of steps to make (stepper motor option) (default: 40)
track_stepsize 40




############################################################
# External Commands, Warnings and Logging:
# You can use conversion specifiers for the on_xxxx commands
# %Y = year, %m = month, %d = date,
# %H = hour, %M = minute, %S = second,
# %v = event, %q = frame number, %t = thread (camera) number,
# %D = changed pixels, %N = noise level,
# %i and %J = width and height of motion area,
# %K and %L = X and Y coordinates of motion center
# %C = value defined by text_event
# %f = filename with full path
# %n = number indicating filetype
# Both %f and %n are only defined for on_picture_save,
# on_movie_start and on_movie_end
# Quotation marks round string are allowed.
############################################################


# Do not sound beeps when detecting motion (default: on)
# Note: Motion never beeps when running in daemon mode.
quiet on


# Command to be executed when an event starts. (default: none)
# An event starts at first motion detected after a period of no motion defined by gap 
当检测到运动时，执行所设定目录里的文件，这里设定为/motion/appon，该文件可以是一个程序，也可以是一个脚本，只要是能执行就可以
 on_event_start /motion/appon


# Command to be executed when an event ends after a period of no motion
# (default: none). The period of no motion is defined by option gap.
当on_event_start开始之后，即检测到运动后，若有连续的gap秒检测不到运动时，就执行该选项的文件
 on_event_end /motion/appoff


# Command to be executed when a picture (.ppm|.jpg) is saved (default: none)
# To give the filename as an argument to a command append it with %f
; on_picture_save value


# Command to be executed when a motion frame is detected (default: none)
; on_motion_detected value


# Command to be executed when a movie file (.mpg|.avi) is created. (default: none)
# To give the filename as an argument to a command append it with %f
; on_movie_start value


# Command to be executed when a movie file (.mpg|.avi) is closed. (default: none)
# To give the filename as an argument to a command append it with %f
; on_movie_end value




############################################################
# Common Options For MySQL and PostgreSQL database features.
# Options require the MySQL/PostgreSQL options to be active also.
############################################################


# Log to the database when creating motion triggered image file  (default: on)
sql_log_image on


# Log to the database when creating a snapshot image file (default: on)
sql_log_snapshot on


# Log to the database when creating motion triggered mpeg file (default: off)
sql_log_mpeg off


# Log to the database when creating timelapse mpeg file (default: off)
sql_log_timelapse off


# SQL query string that is sent to the database
# Use same conversion specifiers has for text features
# Additional special conversion specifiers are
# %n = the number representing the file_type
# %f = filename with full path
# Default value:
# insert into security(camera, filename, frame, file_type, time_stamp, text_event) values('%t', '%f', '%q', '%n', '%Y-%m-%d %T', '%C')
sql_query insert into security(camera, filename, frame, file_type, time_stamp, event_time_stamp) values('%t', '%f', '%q', '%n', '%Y-%m-%d %T', '%C')




############################################################
# Database Options For MySQL
############################################################


# Mysql database to log to (default: not defined)
; mysql_db value


# The host on which the database is located (default: localhost)
; mysql_host value


# User account name for MySQL database (default: not defined)
; mysql_user value


# User password for MySQL database (default: not defined)
; mysql_password value




############################################################
# Database Options For PostgreSQL
############################################################


# PostgreSQL database to log to (default: not defined)
; pgsql_db value


# The host on which the database is located (default: localhost)
; pgsql_host value


# User account name for PostgreSQL database (default: not defined)
; pgsql_user value


# User password for PostgreSQL database (default: not defined)
; pgsql_password value


# Port on which the PostgreSQL database is located (default: 5432)
; pgsql_port 5432




############################################################
# Video Loopback Device (vloopback project)
############################################################


# Output images to a video4linux loopback device
# The value '-' means next available (default: not defined)
; video_pipe value


# Output motion images to a video4linux loopback device
# The value '-' means next available (default: not defined)
; motion_video_pipe value




##############################################################
# Thread config files - One for each camera.
# Except if only one camera - You only need this config file.
# If you have more than one camera you MUST define one thread
# config file for each camera in addition to this config file.
##############################################################


# Remember: If you have more than one camera you must have one
# thread file for each camera. E.g. 2 cameras requires 3 files:
# This motion.conf file AND thread1.conf and thread2.conf.
# Only put the options that are unique to each camera in the
# thread config files. 
; thread /usr/local/etc/thread1.conf
; thread /usr/local/etc/thread2.conf
; thread /usr/local/etc/thread3.conf
; thread /usr/local/etc/thread4.conf