help=>"The path where the ZoneMinder executables are installed is set at configure time. This is a readonly option for the purposes of distributing this information around the various binaries and scripts that need to know it. Changing this option here will tend to break things. Instead re-run configure to regenerate the path.",
help=>"The path where the ZoneMinder web files are installed is set at configure time. This is a readonly option for the purposes of distributing this information around the various binaries and scripts that need to know it. Changing this option here will tend to break things. Instead re-run configure to regenerate the path.",
help=>"The path where the ZoneMinder cgi files are installed is set at configure time. This is a readonly option for the purposes of distributing this information around the various binaries and scripts that need to know it. Changing this option here will tend to break things. Instead re-run configure to regenerate the path.",
help=>"The user name of your httpd daemon user is set at configure time. This is a readonly option for the purposes of distributing this information around the various binaries and scripts that need to know it. Changing this option here will tend to break things. Instead re-run configure to regenerate the user name.",
help=>"The user group of your httpd daemon user is set at configure time. This is a readonly option for the purposes of distributing this information around the various binaries and scripts that need to know it. Changing this option here will tend to break things. Instead re-run configure to regenerate the user group.",
description=>"Machine on which the database server is running",
help=>"This is the machine on which you have installed MySQL and which manages the database. For performance and convenience purposes this is usually on the same machine the web server is running on but can be elsewhere. Enter either your hostname or 'localhost' for this machine.",
type=>$types{hostname},
},
{
name=>"ZM_DB_NAME",
default=>"zm",
description=>"Database containing the tables",
help=>"This is the name of the MySQL database that will be used. Normally this will be just 'zm' though if you two or more installs you may wish to keep databases separate. To create this database just run the following command 'mysql < db/zmschema.sql'. You may need to give additional username and password parameters to MySQL to acquire sufficient privileges to create tables.",
description=>"Privileged DB user name, needs at least select, insert, update and delete privileges",
help=>"This is the username of a MySQL user that has full privileges to select, insert, update and delete data from your ZoneMinder database. If you have no user available yet you can create one by typing 'mysql mysql' with additional parameters as required to give you access. Then at the prompt type 'grant select,insert,update,delete on <your database name>.* to '<your username>' identified by '<your password>';'. Then type 'quit' to exit. You may also need to type 'mysqladmin reload' to ensure your changes take effect. Note that the username and passwords used here are not related to your Linux login or accounts and should not be the same.",
help=>"This is the password of a MySQL user that has full privileges to select, insert, update and delete data from your ZoneMinder database. If you have no user available yet you can create one by typing 'mysql mysql' with additional parameters as required to give you access. Then at the prompt type 'grant select,insert,update,delete on <your database name>.* to '<your username>' identified by '<your password>';'. Then type 'quit' to exit. You may also need to type 'mysqladmin reload' to ensure your changes take effect. Note that the username and passwords used here are not related to your Linux login or accounts and should not be the same.",
description=>"Unprivileged DB user name, need just select privilege.",
help=>"This is the username of a MySQL user that has only privileges to select data from your ZoneMinder database and is used in cgi programs where full access is neither necessary or desiarable. If you have no user available yet you can create one by typing 'mysql mysql' with additional parameters as required to give you access. Then at the prompt type 'grant select on <your database name>.* to '<your username>' identified by '<your password>';'. Then type 'quit' to exit. You may also need to type 'mysqladmin reload' to ensure your changes take effect. Note that the username and passwords used here are not related to your Linux login or accounts and should not be the same.",
help=>"This is the password of a MySQL user that has only privileges to select data from your ZoneMinder database and is used in cgi programs where full access is neither necessary or desiarable. If you have no user available yet you can create one by typing 'mysql mysql' with additional parameters as required to give you access. Then at the prompt type 'grant select on <your database name>.* to '<your username>' identified by '<your password>';'. Then type 'quit' to exit. You may also need to type 'mysqladmin reload' to ensure your changes take effect. Note that the username and passwords used here are not related to your Linux login or accounts and should not be the same.",
help=>"This is the path to the events directory where all the event images and other miscellaneous files are stored. It is normally given as a subdirectory of the web directory you have specified earlier however if disk space is tight it can reside on another partition in which case you should create a link from that area to the path you give here.",
help=>"Cambozola is a handy low fat cheese flavoured Java applet that ZoneMinder uses to view image streams on browsers such as Internet Explorer that don't natively support this format. It is highly recommended to install this from http://www.charliemouse.com/code/cambozola/ however if it is not installed still images at a lower refresh rate can still be viewed.",
help=>"Cambozola is a handy low fat cheese flavoured Java applet that ZoneMinder uses to view image streams on browsers such as Internet Explorer that don't natively support this format. It is highly recommended to install this from http://www.charliemouse.com/code/cambozola/ however if it is not installed still images at a lower refresh rate can still be viewed. Leave this as 'cambozola.jar' if cambozola is installed in the same directory as the ZoneMinder web client files.",
description=>"Override the detection of streaming capability by browser",
help=>"If you know that your browser can handle image streams of the type 'multipart/x-mixed-replace' but ZoneMinder does not detect this correctly you can set this option to ensure that the stream is delivered without the use of the Cambozola plugin.",
help=>"Some cameras or video cards capture images in BGR (Blue-Green-Red) order even when the paletter says RGB. If you see strange colours casts on your images then it may be worth trying this option to see if that corrects the issue. Note this option will apply only to local cameras and not those over a network.",
description=>"Are you going to use remote/networked cameras",
help=>"ZoneMinder can work with boh local cameras, ie. those attached physically to your computer and accessed via /dev/videoX, and remote or network cameras. If you will be using networked cameras select this option.",
type=>$types{boolean},
},
{
name=>"ZM_HTTP_VERSION",
default=>"1.1",
description=>"The version of HTTP that ZoneMinder will use to connect",
help=>"ZoneMinder can communicate using either of the HTTP/1.1 or HTTP/1.0 standard. A server will normally fall back to the version it supports iwht no problem so this should usually by left at the default. However it can be changed to HTTP/1.0 if necessary to resolve particular issues.",
help=>"When ZoneMinder communicates with remote cameras it will identify itself using this string and it's version number. This is normally sufficient, however if a particular cameras expects only to communicate with certain browsers then this can be changed to a different string identifying ZoneMinder as Internet Explorer or Netscape etc.",
type=>$types{string},
},
{
name=>"ZM_HTTP_TIMEOUT",
default=>"2500",
description=>"How long ZoneMinder waits before giving up on images (millseconds)",
help=>"When retrieving remote images ZoneMinder will wait for this length of time before deciding that an image is not going to arrive and taking steps to retry. This timeout is in millseconds (1000 per second) and will apply to each part of an image if it is not sent in one whole chunk.",
description=>"Is the (optional) mpeg video encoder installed",
help=>"ZoneMinder can optionally encode a series of video images into an MPEG encoded file and this path should point to where the Berkeley mpeg_encode program has ben installed. This encoder is fairly slow and you don't lose much by not having it as events can still be reviewed as video stream without it.",
help=>"ZoneMinder can optionally encode a series of video images into an MPEG encoded file and this path should point to where the Berkeley mpeg_encode program has ben installed. This encoder is fairly slow and you don't lose much by not having it as events can still be reviewed as video stream without it.",
description=>"Are the (optional) Netpbm utilities installed",
help=>"For low bandwidth situations ZoneMinder will resize images into thumbnails on the fly before sending them to the browser to reduce the network traffic at the expense of CPU on the server. It uses the Netpbm package to do this and this option should be set to where the binaries from that package are installed. If you do not have it installed it means that the images will always be sent full sizxe and rescaled on your browser whioch may or not be an isue for you.",
description=>"Path to (optional) Netpbm utilities",
help=>"For low bandwidth situations ZoneMinder will resize images into thumbnails on the fly before sending them to the browser to reduce the network traffic at the expense of CPU on the server. It uses the Netpbm package to do this and this option should be set to where the binaries from that package are installed. If you do not have it installed it means that the images will always be sent full sizxe and rescaled on your browser whioch may or not be an isue for you.",
description=>"Path to the various logs that the ZoneMinder daemons generate",
help=>"There are various daemons that are used by ZoneMinder to perform various tasks. Most generate helpful log files and this is where they go. They can be deleted if not required for debugging.",
description=>"Should the monitor window jump to the top if an alarm occurs",
help=>"When viewing a live monitor stream you can specify whether you want the window to pop to the front if an alarm occurs when the window is minimised or behind another window. This is most useful if your monitors are over doors for example when they can pop up if someone comes to the doorway.",
description=>"Whether we want to interface with X10 devices",
help=>"If you have an X10 Home Automation setup in your home you can use ZoneMinder to initiate or react to X10 signals if your computer has the appropriate interface controller. This option indicates whether X10 options will be available in the browser client.",
help=>"If you have an X10 controller device (e.g. XM10U) connected to your computer this option details which port it is conected on, the default of /dev/ttyS0 maps to serial or com port 1.",
description=>"What X10 house code should be used",
requires=>[{name=>"ZM_OPT_X10",value=>"yes"}],
help=>"X10 devices are grouped together by identifying them as all belonging to one House Code. This option details what that is. It should be a single letter between A and P.",
description=>"How often (in seconds) the X10 damon reloads the monitors from the database",
requires=>[{name=>"ZM_OPT_X10",value=>"yes"}],
help=>"The zmx10 daemon periodically checks the database to find out what X10 events trigger, or result from, alarms. This option determines how frequently this check occurs, unless you change this area frequently this can be a fairly large value.",
help=>"You can specify a sound file to play if an alarm occurs whilst you are watching a live monitor stream. So long as your browser understands the format it does not need to be any particular type. This file should be placed in the sounds directory defined earlier.",
description=>"The maximum number of monitor columns in the montage view",
help=>"The 'montage' view shows images from all your monitors at once. This parameter defines how many monitors to place across your screen before moving to the next row. If you have a very wide screen and/or small images from your cameras this can be a bigger value however if not, of if you prefer the images stacked vertically it should be small.",
description=>"When deleting events should the client only delete the database records for speed",
help=>"Normally an event created as the result of an alarm consists of entries in one or more database tables plus the various files associated with it. When deleting events in the browser it can take a long time to remove all of this if your are trying to do a lot of events at once. It is recommended that you set this option which means that the browser client only deletes the key entries in the events table, which means the events will no longer appear in listing, and leaves the zmaudit daemon to clear up the rest later.",
description=>"Whether to allow errors in setting video config to be fatal",
help=>"With some video devices errors can be reported in setting the various video attributes when in fact the operation was successful. Switching this option off will still allow these errors to be reported but will not cause them to kill the video capture daemon. Note however that doing this will cause all errors to be ignored including those which are genuine and which may cause the video capture to not function correctly. Use this option with caution.",
description=>"Shared memory key to use, only change if it clashes with another application",
help=>"ZoneMinder uses shared memory to speed up communication between modules. To identify the right area to use shared memory keys are used. This option controls what the base key is, each monitor will have it's Id or'ed with this to get the actual key used.",
type=>$types{hexadecimal},
},
{
name=>"ZM_FILTER_RELOAD_DELAY",
default=>"300",
description=>"How often (in seconds) filters are reloaded in zmfilter.pl",
help=>"ZoneMinder allows you to save filters to the database which allow events that match certain criteria to be deleted or uploaded to a remote machine. The zmfilter daemon loads these and does the deleting or uploading. This option determine how often the filters are reloaded to get the latest versions of the filters. If you don't change filters very often this can be quite large.",
type=>$types{integer},
},
{
name=>"ZM_OPT_UPLOAD",
default=>"no",
description=>"Should ZoneMinder try and upload events that match corresponding filters",
help=>"In ZoneMinder you can create event filters that specify whether events that match certain criteria should be uploaded to a remote server for archiving. This option specifies whether this functionality should be available",
description=>"What format the uploaded events should be created in. This can be 'tar' or 'zip'",
requires=>[{name=>"ZM_OPT_UPLOAD",value=>"yes"}],
help=>"Uploaded events may be stored in either .tar or .zip format, this option specifies which. Note that to use this you will need to have the Archive::Tar and/or Archive::Zip perl modules installed.",
description=>"Should archive files be compressed",
help=>"When the archive files are created they can be compressed. However in general since the images are compressed already this saves only a minimal amount of space versus utilising more CPU in their creation. Only enable if you have CPU to waste and are limited in disk space on your remote server or bandwidth",
requires=>[{name=>"ZM_OPT_UPLOAD",value=>"yes"}],
type=>$types{boolean},
},
{
name=>"ZM_UPLOAD_ARCH_ANALYSE",
default=>"no",
description=>"Whether to include the analysis files in the archive, bigger but slower",
help=>"When the archive files are created they can contain either just the captured frames or both the captured frames and for frames that caused an alarm the analysed image with the changed area highlighted. This option controls which to do. Only included analysed frames if you have a high bandwidth connection to the remote server or if you need help in figuring out what caused an alarm in the first place",
requires=>[{name=>"ZM_OPT_UPLOAD",value=>"yes"}],
type=>$types{boolean},
},
{
name=>"ZM_UPLOAD_FTP_HOST",
default=>"",
description=>"The remote server to upload to",
requires=>[{name=>"ZM_OPT_UPLOAD",value=>"yes"}],
help=>"This is the remote machine that you wish to upload archived events to.",
type=>$types{hostname},
},
{
name=>"ZM_UPLOAD_FTP_USER",
default=>"",
description=>"Your ftp username",
requires=>[{name=>"ZM_OPT_UPLOAD",value=>"yes"}],
type=>$types{string},
},
{
name=>"ZM_UPLOAD_FTP_PASS",
default=>"",
description=>"Your ftp password",
requires=>[{name=>"ZM_OPT_UPLOAD",value=>"yes"}],
type=>$types{string},
},
{
name=>"ZM_UPLOAD_FTP_LOC_DIR",
default=>"/tmp",
description=>"The local directory in which to create upload files",
help=>"If your computer is behind a firewall or proxy you may need to set FTP to passive mode. In fact for simple transfers it makes little sense to do otherwise anyway but you can set this to 'No' if you wish.",
type=>$types{boolean},
},
{
name=>"ZM_UPLOAD_FTP_DEBUG",
default=>"yes",
description=>"Whether to switch ftp debugging on",
requires=>[{name=>"ZM_OPT_UPLOAD",value=>"yes"}],
help=>"If you are having (or expecting) troubles with uploading archived events then setting this to 'yes' permits additional information to be included in the zmfilter log file.",
help=>"In ZoneMinder you can create event filters that specify whether events that match certain criteria should have their details emailed to you at a designated email address. This will allow you to be notified of events as soon as they occur and also to quickly view the events directly. This option specifies whether this functionality should be available. The email created with this option can be any size and is intended to be sent to a regular email reader rather than a mobile device.",
help=>"In ZoneMinder you can create event filters that specify whether events that match certain criteria should have their details sent to you at a designated short message email address. This will allow you to be notified of events as soon as they occur. This option specifies whether this functionality should be available. The email created by this option will be brief and is intended to be sent to an SMS gateway or a minimal mail reader such as a mobile device or phone rather than a regular email reader.",
help=>"This option is used to define the file that contains the format of the message that is sent for any events that match the appropriate filters.",
help=>"ZoneMinder needs to know how to send you the notification emails or messages. This option tell it which method to use, generally sendmail will work if configured correctly on your machine, otherwise choose smtp and then give your mail host address in the next option.",
help=>"If you have chosen SMTP as the method by which to send notification emails or messages then this option allows you to choose which SMTP server to use to send them. The default of localhost may work if you have the sendmail, exim or a similar daemon running however you may wish to enter your ISP's SMTP mail server here.",
help=>"The emails or messages that will be sent to you informing you of events can appear to come from a designated email address to help you with mail filtering etc. An address of something like ZoneMinder\@your.domain is recommended.",
help=>"The emails or messages that will be sent to you informing you of events can include a link to the events themselves for easy viewing. If you intend to use this feature then set this option to the url of your installation as it would appear from where you read your email, e.g. http://host.your.domain/zm.php.",
description=>"How often to check the capture daemons have not locked up",
help=>"The zmwatch daemon checks the image capture performance of the capture daemons to ensure that they have not locked up (rarely a sync error may occur which blocks indefinately). This option determines how often the daemons are checked.",
description=>"The maximum delay since the last captured image we will allow before restarting the capture daemons",
help=>"The zmwatch daemon checks the image capture performance of the capture daemons to ensure that they have not locked up (rarely a sync error may occur which blocks indefinately). This option determines the maximum delay we will allow since the last captured frame. The daemon will be restarted if it has not captured any images after this period though the actual restart may take slightly longer in conjunction with the check interval value above.",
help=>"The 'zmu' utility can be used to force an alarm on a monitor rather than rely on the motion detection algorithms. This option determines what score to give these alarms to distinguish them from regular ones. It must be 255 or less.",
type=>$types{integer},
},
{
name=>"ZM_RECORD_EVENT_STATS",
default=>"yes",
description=>"Whether to record event statistical information, switch off if too slow",
help=>"This version of ZoneMinder records detailed information about events in the Stats table. This can help in profiling what the optimum settings are for Zones though this is tricky at present. However in future releases this will be done more easily and intuitively, especially with a large sample of events. The default option of 'yes' allows this information to be collected now in readiness for this but if you are concerned about performance you can switch this off in which case no Stats information will be saved.",
introduction=>"There are now a number of options that are grouped into bandwidth categories, this allows you to configure the ZoneMinder client to work optimally over the various access methods you might to access the client.\n\nThe next few options control what happens when the client is running in 'high' bandwidth mode. You should set these options for when accessing the ZoneMinder client over a local network or high speed link. In most cases the default values will be suitable as a starting point.",
help=>"The main console window lists a general status and the event totals for all monitors. This is not a trivial task and should not be repeated too frequently or it may affect the performance of the rest of the system.",
description=>"How often (in seconds) the cycle watch window swaps to the next monitor",
help=>"The cycle watch window is a method of continuously cycling between still images from all of your monitors. This option determines how often to refresh with a new image.",
type=>$types{integer},
},
{
name=>"ZM_WEB_H_REFRESH_IMAGE",
default=>"5",
description=>"How often (in seconds) the watched image is refreshed (if not streaming)",
help=>"The live images from a monitor can be viewed in either streamed or stills mode. This option determines how often a stills image is refreshed, it has no effect if streaming is selected.",
type=>$types{integer},
},
{
name=>"ZM_WEB_H_REFRESH_STATUS",
default=>"3",
description=>"How often (in seconds) the status frame refreshes itself in the watch window",
help=>"The monitor window is actually made from several frames. The one in the middle merely contains a monitor status which needs to refresh fairly frequently to give a true indication. This option determines that frequency.",
type=>$types{integer},
},
{
name=>"ZM_WEB_H_REFRESH_EVENTS",
default=>"30",
description=>"How often (in seconds) the event listing is refreshed in the watch window",
help=>"The monitor window is actually made from several frames. The lower framme contains a listing of the last few events for easy access. This option determines how often this is refreshed.",
type=>$types{integer},
},
{
name=>"ZM_WEB_H_STREAM_IDLE_DELAY",
default=>"250",
description=>"How long (in milliseconds) between streamed frames in the watch window",
help=>"The top frame of the monitor window when monitoring a live feed in streaming mode contains a continuous stream of images. This option controls how often a new frame is sent to the browser when the monitor is idle, ie. not in alarm state. It makes little sense to set this too small as if it results in frames being sent much faster than they are being captured you will just get the same ones over and over. It should be set to be less or equal to the capture rate of the cameras you are using which will normally be between 2 and 25 Frames Per Second which maps to values between 500 and 40 being used here though your bandwidth may well limit how much can actually be sent. Note also that this is the update rate when no alarms are being generated, if an alarm situation occurs then the rate speeds up as per the next option so this can be set to a longer delay without you missing anything.",
type=>$types{integer},
},
{
name=>"ZM_WEB_H_STREAM_FRAME_DELAY",
default=>"50",
description=>"How long (in milliseconds) to wait before looking for the next streamed frame",
help=>"The top frame of the monitor window when monitoring a live feed in streaming mode contains a continuous stream of images. This option controls how often a new frame is sent to the browser when an alarm is being generated. It makes little sense to set this too small as if it results in frames being sent much faster than they are being captured you will just get the same ones over and over. It should be set to roughly match the capture rate of the cameras you are using which will normally be between 2 and 25 Frames Per Second which maps to values between 500 and 40 being used here though your bandwidth may well limit how much can actually be sent.",
type=>$types{integer},
},
{
name=>"ZM_WEB_H_STREAM_EVENT_DELAY",
default=>"200",
description=>"How long (in milliseconds) to wait between each frame when streaming events",
help=>"When viewing a captured event this option controls how fast frames are sent to the browser. This should roughly match your capture rate otherwise the event may appear too fast or too slow, the default of 200 is usually a good starting point.",
type=>$types{integer},
},
{
name=>"ZM_WEB_H_IMAGE_SCALING",
default=>"1",
description=>"How to scale thumbnails in events, bandwidth versus cpu in rescaling",
help=>"A value of 1 sends the whole image to the browser which resizes it in the window, larger values scale down by that amount on the server before sending a reduced size image to the browser. For high bandwidth settings the default of 1 is usally the fastest does not result in extraneous thumbnail files being generated.",
type=>$types{integer},
requires=>[{name=>"ZM_PATH_NETPBM",value=>'/'}],
},
{
name=>"ZM_WEB_M_REFRESH_MAIN",
default=>"300",
description=>"How often (in seconds) the main console window should refresh itself",
help=>"The main console window lists a general status and the event totals for all monitors. This is not a trivial task and should not be repeated too frequently or it may affect the performance of the rest of the system.",
introduction=>"The next few options control what happens when the client is running in 'medium' bandwidth mode. You should set these options for when accessing the ZoneMinder client over a slower cable or DSL link. In most cases the default values will be suitable as a starting point.",
description=>"How often (in seconds) the cycle watch window swaps to the next monitor",
help=>"The cycle watch window is a method of continuously cycling between still images from all of your monitors. This option determines how often to refresh with a new image.",
type=>$types{integer},
},
{
name=>"ZM_WEB_M_REFRESH_IMAGE",
default=>"15",
description=>"How often (in seconds) the watched image is refreshed (if not streaming)",
help=>"The live images from a monitor can be viewed in either streamed or stills mode. This option determines how often a stills image is refreshed, it has no effect if streaming is selected.",
type=>$types{integer},
},
{
name=>"ZM_WEB_M_REFRESH_STATUS",
default=>"5",
description=>"How often (in seconds) the status frame refreshes itself in the watch window",
help=>"The monitor window is actually made from several frames. The one in the middle merely contains a monitor status which needs to refresh fairly frequently to give a true indication. This option determines that frequency.",
type=>$types{integer},
},
{
name=>"ZM_WEB_M_REFRESH_EVENTS",
default=>"60",
description=>"How often (in seconds) the event listing is refreshed in the watch window",
help=>"The monitor window is actually made from several frames. The lower framme contains a listing of the last few events for easy access. This option determines how often this is refreshed.",
type=>$types{integer},
},
{
name=>"ZM_WEB_M_STREAM_IDLE_DELAY",
default=>"2500",
description=>"How long (in milliseconds) between streamed frames in the watch window",
help=>"The top frame of the monitor window when monitoring a live feed in streaming mode contains a continuous stream of images. This option controls how often a new frame is sent to the browser when the monitor is idle, ie. not in alarm state. It makes little sense to set this too small as if it exceeds the available bandwidth and results in frames being sent much faster than they are able to be displayed. In medium bandwidth mode it should be set to be rather less than the capture rate of the cameras you are using. Note also that this is the update rate when no alarms are being generated, if an alarm situation occurs then the rate speeds up as per the next option so this can be set to a longer delay without you missing anything.",
type=>$types{integer},
},
{
name=>"ZM_WEB_M_STREAM_FRAME_DELAY",
default=>"100",
description=>"How long (in milliseconds) to wait before looking for the next streamed frame",
help=>"The top frame of the monitor window when monitoring a live feed in streaming mode contains a continuous stream of images. This option controls how often a new frame is sent to the browser when an alarm is being generated. It makes little sense to set this too small as if it exceeds the available bandwidth and results in frames being sent much faster than they are able to be displayed though as should be only for a short period it may be possible to catch up. In medium bandwidth mode it should be set to maybe half the capture rate of the cameras you are using.",
type=>$types{integer},
},
{
name=>"ZM_WEB_M_STREAM_EVENT_DELAY",
default=>"50",
description=>"How long (in milliseconds) to wait between each frame when streaming events",
help=>"When viewing a captured event this option controls how fast frames are sent to the browser. This should roughly match your capture rate if possible otherwise the event may appear too fast or too slow, though your bandwidth may also slow the the stream down. The default of 200 is usually a good starting point.",
type=>$types{integer},
},
{
name=>"ZM_WEB_M_IMAGE_SCALING",
default=>"4",
description=>"How to scale thumbnails in events, bandwidth versus cpu in rescaling",
help=>"A value of 1 sends the whole image to the browser which resizes it in the window, larger values scale down by that amount on the server before sending a reduced size image to the browser. For medium bandwidth settings the default of 4 is usually the fastest though 1 may also work.",
type=>$types{integer},
requires=>[{name=>"ZM_PATH_NETPBM",value=>"/"}],
},
{
name=>"ZM_WEB_L_REFRESH_MAIN",
default=>"300",
description=>"How often (in seconds) the main console window should refresh itself",
introduction=>"The next few options control what happens when the client is running in 'low' bandwidth mode. You should set these options for when accessing the ZoneMinder client over a modem or slow link. In most cases the default values will be suitable as a starting point.",
help=>"The main console window lists a general status and the event totals for all monitors. This is not a trivial task and should not be repeated too frequently or it may affect the performance of the rest of the system.",
description=>"How often (in seconds) the cycle watch window swaps to the next monitor",
help=>"The cycle watch window is a method of continuously cycling between still images from all of your monitors. This option determines how often to refresh with a new image.",
type=>$types{integer},
},
{
name=>"ZM_WEB_L_REFRESH_IMAGE",
default=>"30",
description=>"How often (in seconds) the watched image is refreshed (if not streaming)",
help=>"The live images from a monitor can be viewed in either streamed or stills mode. This option determines how often a stills image is refreshed, it has no effect if streaming is selected.",
type=>$types{integer},
},
{
name=>"ZM_WEB_L_REFRESH_STATUS",
default=>"10",
description=>"How often (in seconds) the status frame refreshes itself in the watch window",
help=>"The monitor window is actually made from several frames. The one in the middle merely contains a monitor status which needs to refresh fairly frequently to give a true indication. This option determines that frequency.",
type=>$types{integer},
},
{
name=>"ZM_WEB_L_REFRESH_EVENTS",
default=>"180",
description=>"How often (in seconds) the event listing is refreshed in the watch window",
help=>"The monitor window is actually made from several frames. The lower framme contains a listing of the last few events for easy access. This option determines how often this is refreshed.",
type=>$types{integer},
},
{
name=>"ZM_WEB_L_STREAM_IDLE_DELAY",
default=>"10000",
description=>"How long (in milliseconds) between streamed frames in the watch window",
help=>"The top frame of the monitor window when monitoring a live feed in streaming mode contains a continuous stream of images. This option controls how often a new frame is sent to the browser when the monitor is idle, ie. not in alarm state. It makes little sense to set this too small as if it exceeds the available bandwidth and results in frames being sent much faster than they are able to be displayed. In low bandwidth mode it should be set to be far less than the capture rate of the cameras you are using. Note also that this is the update rate when no alarms are being generated, if an alarm situation occurs then the rate speeds up as per the next option so this can be set to a longer delay without you missing anything.",
type=>$types{integer},
},
{
name=>"ZM_WEB_L_STREAM_FRAME_DELAY",
default=>"250",
description=>"How long (in milliseconds) to wait before looking for the next streamed frame",
help=>"The top frame of the monitor window when monitoring a live feed in streaming mode contains a continuous stream of images. This option controls how often a new frame is sent to the browser when an alarm is being generated. It makes little sense to set this too small as if it exceeds the available bandwidth and results in frames being sent much faster than they are able to be displayed though as should be only for a short period it may be possible to catch up. In low bandwidth mode it should be set to maybe a quarter the capture rate of the cameras you are using.",
type=>$types{integer},
},
{
name=>"ZM_WEB_L_STREAM_EVENT_DELAY",
default=>"10",
description=>"How long (in milliseconds) to wait between each frame when streaming events",
help=>"When viewing a captured event this option controls how fast frames are sent to the browser. This should roughly match your capture rate if possible otherwise the event may appear too fast or too slow, though your bandwidth may also slow the the stream down. The default of 200 is usually a good starting point.",
type=>$types{integer},
},
{
name=>"ZM_WEB_L_IMAGE_SCALING",
default=>"4",
description=>"How to scale thumbnails in events, bandwidth versus cpu in rescaling",
help=>"A value of 1 sends the whole image to the browser which resizes it in the window, larger values scale down by that amount on the server before sending a reduced size image to the browser. For low bandwidth settings the default of 4 is usually the best.",
type=>$types{integer},
requires=>[{name=>"ZM_PATH_NETPBM",value=>"/"}],
},
{
name=>"ZM_WEB_P_REFRESH_MAIN",
default=>"300",
description=>"How often (in seconds) the main console window should refresh itself",
introduction=>"The next few options control what happens when the WAP client is being accessed over a mobile phone link. You should set these options for when accessing the ZoneMinder WAP client over a mobile dialup or GPRS link. In most cases the default values will be suitable as a starting point.",
help=>"The main console window lists a general status and the event totals for all monitors. This is not a trivial task and should not be repeated too frequently or it may affect the performance of the rest of the system.",
description=>"How often (in seconds) the watched image is refreshed",
help=>"The live images from a monitor are viewed as a sequence of still images. This option determines how the image is refreshed. Though the images are small setting this at too frequent a value may rapidly consume a lot of bandwidth resource.",
type=>$types{integer},
},
);
my%options_hash=map{($_->{name},$_)}@options;
#$config_file = "zmconfig.txt" if ( !$config_file );
