Some commands require the version 1.1.61 firmware available here:
To pull single JPEG frames:
http://<ip>/image.jpg (or http://<ip>/netcam.jpg)
on multiple input devices:
http://<ip>/jpeg.cgi?x (where x = input number, 0 origin)
To pull MJPEG stream:
http://<ip>/nph-mjpeg.cgi?0
The ?0 indicates camera or video input number. On NetCam SC and XL, this value is assumed since it's a single camera device. On the Express video servers, this value indicates input number (0-3). You may also use the more descriptive camera=0.
The following parameters can be added to the MJPEG URL (Version 1.1.61+, NetCam SC Only):
fps=x Limit frame rate to x frames per second
motion=x Stream video on motion only but send "keep alive" or confidence frame every x seconds
Example: http://<ip>/nph-mjpeg.cgi?motion=2
You can also obtain the MJPEG stream directly through streaming video port (default is 8001). However, the recommended method is the http nph-mjpeg URL.
To read a list of various configuration pages:
http://<ip>/admin.cgi?tablist
To read configuration parameters for a specific page:
http://<ip>/admin.cgi?image&_
http://<ip>/admin.cgi?overlay&_
http://<ip>/admin.cgi?ftp&_
http://<ip>/admin.cgi?applet&_
http://<ip>/admin.cgi?datetime&_
http://<ip>/admin.cgi?network&_
http://<ip>/admin.cgi?dialout&_
http://<ip>/admin.cgi?security&_
http://<ip>/admin.cgi?ptz&_
http://<ip>/admin.cgi?tzo&_
http://<ip>/admin.cgi?trigger&_
http://<ip>/admin.cgi?wx&_
To read information about the device (Version 1.1.61+):
http://<ip>/info.cgi
To read the resolution list for a device (Version 1.1.61+):
http://<ip>/info.cgi?resolutions
Example of how to change parameters:
http://<ip>/admin.cgi?image&quality=50&sharpen=off
Note that you can only set configuration options from one "page" at a time, but you can specify multiple options.
The configuration files are automatically saved to flash memory, since this is essentially the same thing as hitting the the form's "Apply" button when using a web browser.
The above are all "HTTP PUT" examples; "HTTP POST" may also be used. Both are well known HTTP transfer methods and documentation is widely available ("PUT" sends the data in the URL, "POST" sends it in the "body" of the HTTP request).
HTTP authentication will also need to be used in order to access the pages as "admin" if you are not accessing the pages through a web browser.
The URL format for changing image parameters is as follows:
http://<ip>/admin.cgi?image¶m=value
You can combine multiple image parameters in one line:
http://<ip>/admin.cgi?image¶m1=value¶m2=value¶m3=value
brightness
This is the target value for the auto exposure code. The higher the value,
the brighter the image becomes. Only applies if auto_exposure is enabled.
brightness=[0-255]
Recommended Range: 70-200
auto_exposure
Enable to have the camera determine the proper image exposure based on the
average brightness of the pixels. Can be adjusted with brightness value.
auto_exposure=[0-1]
Recommended Value: 1
exposure
Set the camera’s exposure. Only applies if auto_exposure is disabled.
exposure=[0-32767]
exposure_limit
Set maximum exposure. Only applies if auto_exposure is enabled.
exposure_limit=[0-32767]
extended
Allow extended exposures. Enable to allow camera to enter extended exposure
mode. In low light, the frame rate will slow down to allow longer exposures.
extended=[0/1]
auto_iris
Only enable if there is a DC Auto Iris lens installed and plugged into the
camera.
auto_iris=[0/1]
sync
Fluorescent light synchronization. If camera scene is primarily illuminated
by fluorescent lighting, set sync to 60Hz or 50Hz, depending on the country’s
electrical frequency.
sync=[0-2] (0=off, 1=60Hz, 2=50Hz)
backlight
Enable for backlight compensation (BLC).
backlight=[0/1]
agc
Enable for automatic gain control (digital gain). AGC dynamically adjusts
the intensity value in low light.
agc=[0/1]
agc_limit
Automatic gain compensation limit, which is a limit on the digital gain amount
used by AGC. A higher value produces a noisier but
brighter image in low light. Only applies if agc is enabled.
agc_limit=[0-255]
recommended range: 32-128
intensity
This is the digital gain setting. Only applies if agc is disabled.
intensity=[0-255]
Recommended Range: 16-128
lowlight
Low light mode automatically turns on analog gain if the camera control logic
determines it is required. Image noise will be increased slightly.
lowlight=[0/1]
lowlight_preset
Sets a variety of lowlight settings.
lowlight_preset=[0-3]
0 = Manual (allows access to individual controls on web config page)
1 = High Speed, Low Gain
2 = High Speed, High Gain
3 = Low Speed, Low Gain
4 = Low Speed, High Gain
lowlight_dnr
Determines the amount of digital noise reduction (DNR).
A value of 0 means no DNR.
lowlight_dnr=[0-3]
lowlight_pixelrep
The amount of pixel replication or binning allowed in low light situations. The higher the pixelrep value, the brighter the image at the expense of clarity.
lowlight_pixelrep=[0-3]
0 = None
1 = Minimal
2 = Average
3 = Full
lowlight_saturation
Determines how the saturation value adjusts in low light and IR conditions.
This value is bit-oriented.
lowlight_saturation=[0-15]
Bit 8 = Go into black & white mode if camera goes into IR mode
Bits 0-7 = Determine amount to desaturate in low light (the higher the number, the higher the saturation level)
lowlight_imagespeed
Determines what has more priority in low light conditions, long exposure or low light gain methods.
A setting of 0 means to give long exposure priority. Only applies if extended=1.
lowlight_imagespeed=[0-3]
0 = Slow
1 = Medium
2 = Fast
3 = Fastest
lowlight_yuv
An alternate method of color processing that yieds brighter images in low light at the expense image clarity.
lowlight_yuv=[0/1]
resolution
Set the image/video resolution. The resolution lists vary for each model.
resolution=[value]
or
resolution=[widthxheight] (Version 1.1.61+)
To read the resolution list, http://<ip>/info.cgi?resolutions (Version 1.1.61+)
saturation
Amount of color saturation in video/image.
saturation=[0-255]
Recommended Range: 90-160
Note: A value of 0 renders a black & white (monochrome) image.
haze
Represents haze subtraction. The higher value, the higher the contrast. Only
applies if auto_haze is disabled.
haze=[0-255]
Recommended Range: 10-40
auto_haze
When enabled, camera automatically adjusts the haze.
auto_haze=[0/1]
Recommended Value: 1
quality
This represents the JPEG quality. A high value creates a bigger image filesize
(higher bandwidth consumption) and less visible compression artifacts. A
low value creates a smaller image filesize (lower bandwidth consumption)
and more visible compression artifacts.
quality=[20-100]
Recommended Range: 50-90
jpeg_size
Limit JPEG size to X KB.The best way to limit the bandwidth consumption. JPEG quality is adjusted on the fly so JPEG file size does not exceed the specified size (in Kilobytes).
jpeg_size=[0-1024]
0 = Disable
sharpen
Camera software sharpens the image.
sharpen=[0/1]
Recommended Value:1
filter
Level of sharpening.
filter=[0-3]
Recommended Value: 0 or 1
filter_lpf
Do not sharpen darker areas.
filter_lpf=[0-1]
Recommended Value: 1
skip
Represents frame skip. A frame skip value of 0 means skip no frames, a frame
skip value of 1 means skip every 1 frame, etc. Can be used to reduce bandwidth
consumption.
skip=[0-32767]
Default Value: 0
led
Sets the status of the camera’s front LED.
led=[0-7]
Recommended Values: 1, 3, 5 or 7
0 = LED is always off
1 = LED is always green
2 = LED is off, but flashes yellow if imaging
3 = LED is green, but flashes yellow if imaging
4 = LED is off, but flashes red if motion
5 = LED is green, but flashes red if motion
6 = LED if off, but flashes yellow if imaging, flashes red if motion
7 = LED Is green, but flashes yellow if imaging, flashes red if motion
Note: “imaging” occurs when the camera creates an image for an http request or FTP upload.
manual color balance values
Set manual color balance values. Only applies if balance is disabled.
red=[0-1023]
green=[0-1023]
blue=[0-1023]
Recommended Range: 256-1023
balance
Automatic color balance. Enable to have the camera automatically correct red,
green & blue values to achieve a proper color balance.
balance=[0-1]
Recommended Value: 1
balance_type
This is color balance method.
balance_type=[0-3]
Recommended Value: 0
0 = Average
1 = Bright
2 = Spot
3 = Automatic
color skew values
Set auto color balance skew values. Only applies if balance is enabled. Can
be used to skew the auto color balance to achieve a custom auto color balance. Only
applies if balance=1.
red_scale=[0-1023]
green_scale=[0-1023]
blue_scale=[0-1023]
Recommended Range: 256-1023
balance_show
If enabled, areas used for color balance are shown as green pixels.
balance_show=[0-1]
Recommended value: 0
ir_enable (NetCam SC IR Models Only)
Determines behavior of mechanical IR filter.
ir_enable=[0-2]
Default value: 0
0 = Off (non-IR mode)
1 = On (IR mode)
2 = Auto
exposure_grid
The exposure grid is divided into an 8 x 8 grid. Each of the 64 sections can
be enabled or disabled. The enabled areas are used to help determine the
proper exposure. Only applies when auto_exposure is
enabled.
exposure_grid_[00-63]=[0/1]
All motion detection related parameters are now in the motion section (Version 1.1.61+)
The URL format for changing overlay parameters is as follows:
http://<ip>/admin.cgi?overlay¶m=value
You can combine multiple overlay parameters in one line:
http://<ip>/admin.cgi?overlay¶m1=value¶m2=value¶m3=value
overlay
Displays date/time information, optional weather and sensor information and
customizable text on top of live image.
overlay=[off/on]
overlay_utc
Display overlay date/time information in UTC.
overlay_utc=[0-1]
overlay_text
overlay_text=[text]
Up to four lines of text is allowed. There is a maximum of 255 characters
pre line. Lines are truncated with \r\n.
overlay_scale
overlay_scale=[0-3]
Determines scale or size of font
0=1x
1=2x
2=3x
3=4x
The URL format for changing FTP parameters is as follows:
http://<ip>/admin.cgi?ftp¶m=value
You can combine multiple FTP parameters in one line:
http://<ip>/admin.cgi?ftp¶m1=value¶m2=value¶m3=value
sched_ftp_upload
Turn on to enable FTP upload.
sched_ftp_upload=[off/on]
ftp_timeout
If upload is too slow or error prone, increase the FTP timeout value, which
represents the number of seconds to wait before retrying FTP transmission.
ftp_timeout=[0-1024]
Recommended value: 120
ftp_hostname
The FTP hostname, in the format domain.extension or machine.domain.extension
or an IP address ( Do not include ftp:// or http://).
ftp_hostname=[hostname or IP
address]
Example: example.com
ftp_user
FTP host username.
ftp_user=[username]
ftp_password
FTP host password.
ftp_password=[password]
ftp_passive
FTP "passive" mode.
ftp_passive=[off/on]
ftp_archive
When enabled, a renaming scheme maintains a rotating archive of the last ten images.
ftp_archive=[off/on]
ftp_delete_file
This is an option for FTP hosts that have restrictions on renaming
a file with a filename that already exists. Instead renaming the uploaded image from camera0.jpg.tmp to camera0.jpg,
it will first delete camera0.jpg and then rename camera0.jpg.tmp to camera0.jpg.
ftp_delete_file=[off/on]
ftp_iis_bug
A workaround for restrictions that some Microsoft IIS servers.
ftp_iis_bug=[off/on]
ftp_filename
The primary path/filename of the image to be FTP uploaded.
ftp_filename=[path/filename.jpg]
ftp_filename2
The secondary path/filename of the image to be FTP uploaded.
ftp_filename2=[path/filename.jpg]
ftp_filename3
Only used for the ip.html upload. The filename can be renamed but the html
contents are always the same. It contains the date/time when the upload occurred
and the camera's IP address.
ftp_filename3=[path/filename.html]
sched_ftp_delay
Amount of time in seconds to delay between FTP uploads.
sched_ftp_delay=[0-86399]
sched_ftp_time_start
Time of day to start FTP upload.
sched_ftp_time_start=[00:00-23:59]
sched_ftp_time_stop
Time of day to end FTP upload.
sched_ftp_time_stop=[00:00-23:59]
sched_ftp_day
Days of week to run FTP upload.
sched_ftp_day_[sun-sat]=[on/off]
ftp_image
Represents the internal image filename. Normally this would not be changed.
ftp_image=[path/filename]
Recommended value: /dev/video/jpeg0
sched_ftp_command
Internal name for the FTP scripting program. Normally this would not be changed.
sched_ftp_command=[filename]
Recommended value: ftpscript0
The URL format for changing date/time parameters is as follows:
http://<ip>/admin.cgi?datetime¶m=value
You can combine multiple date/time parameters in one line:
http://<ip>/admin.cgi?datetime¶m1=value¶m2=value¶m3=value
mode
Date/time mode can be either manual or automatic. Automatic implies external
timeserver synchronization.
mode=[automatic/manual]
time_server
External time server to synchronize with. Only applies if mode=automatic.
time_server=[timeserver]
Example: time.nist.gov
time_zone
Time zone camera is in.
time_zone=[timezone]
Example: PST8PDT
date
Set current date.
date=yyyy-mm-dd
time
Set current time.
time=hh:mm:ss
The URL format for changing network parameters is as follows:
http://<ip>/admin.cgi?network¶m=value
You can combine multiple network parameters in one line:
http://<ip>/admin.cgi?network¶m1=value¶m2=value¶m3=value
NETWORKING
Turns on/off networking.
NETWORKING=[no/yes]
eth0_BOOTPROTO
The Ethernet bootproto can be either DHCP or none.
eth0_BOOTPROTO=[dhcp/none]
eth0_IPADDR
Ethernet IP address.
eth0_IPADDR=[n.n.n.n]
eth0_NETMASK
Ethernet subnet mask.
eth0_NETMASK=[n.n.n.n]
GATEWAY
Network gateway IP address.
GATEWAY=[n.n.n.n]
NAMESERVER
DNS entries 1-3.
NAMESERVER[1-3]=[n.n.n.n]
eth0_BROADCAST
Ethernet broadcast address.
eth0_BROADCAST=[n.n.n.n]
http_port
Set the camera's default http port.
http_port=[0-65535]
Default value: 80
mjpeg_base_port
The motion JPEG starting port (on single camera devices, this is the only motion
JPEG port).
mjpeg_base_port=8001
Default value: 8001
HOSTNAME
Hostname for the camera or device.
HOSTNAME=[hostname]
Example: netcamsc
eth0_DEVICE
Ethernet 0 device. Always set as eth0.
eth0_DEVICE=eth0
The URL format for changing dial-out parameters is as follows:
http://<ip>/admin.cgi?dialout¶m=value
You can combine multiple dial-out parameters in one line:
http://<ip>/admin.cgi?dialout¶m1=value¶m2=value¶m3=value
DIALOUT_ENABLED
When set to yes, dial-out is enabled.
DIALOUT_ENABLED=[no/yes]
Default value: no
ppp0_DEVICE
PPP0 device. This is normally left as ppp0.
ppp0_DEVICE=ppp0
ppp0_ONBOOT
Enabled or disable PPP on boot.
ppp0_ONBOOT=[no/yes]
Default value: no
DIALOUT_DEVICE
The serial port the dial-out device is connected to, either S0 or S1.
DIALOUT_DEVICE=/dev/ttyS[0-1]
DIALOUT_DEVICE_SPEED
Baud rate of dial-out device.
DIALOUT_DEVICE_SPEED=[baudrate]
Default value: 38400
DIALOUT_MODEM_INIT
Dial-out modem initialization string.
DIALOUT_MODEM_INIT=[init-string]
DIALOUT_PHONE_NUMBER
Dial-out phone number.
DIALOUT_PHONE_NUMBER=[nnn-nnn-nnnn]
DIALOUT_CONNECT_TIMEOUT
Dial-out connect timeout value (in seconds).
DIALOUT_CONNECT_TIMEOUT=[0-32767]
Default value: 180
DIALOUT_USERNAME
Dial-out username (usually ISP login name).
DIALOUT_USERNAME=[username]
DIALOUT_PASSWORD
Dial-out password (usually ISP login password).
DIALOUT_PASSWORD=[password]
DIALOUT_ALWAYS_UP
When enabled, dial-out connection remains open. When disabled, dial-out connection
is driven by client side activity (FTP upload, ping, etc.).
DIALOUT_ALWAYS_UP=[no/yes]
Default value: no
DIALOUT_DEFAULT_ROUTE
When enabled, a dial-out connection will be the default route.
DIALOUT_DEFAULT_ROUTE=[no/yes]
DIALOUT_SHELL_LOGIN
Advanced option. Set only when ISP requires a shell login.
DIALOUT_SHELL_LOGIN=[no/yes]
Default value: no
DIALOUT_SEND_CR
Advanced option. Set only when ISP requires a CR to be sent.
DIALOUT_SEND_CR=[no/yes]
Default value: no
ppp0_DEVICE
PPP0 device. This is normally left as ppp0.
ppp0_DEVICE=ppp0
The URL format for changing PTZ parameters is as follows:
http://<ip>/admin.cgi?ptz¶m=value
You can combine multiple PTZ parameters in one line:
http://<ip>/admin.cgi?ptz¶m1=value¶m2=value¶m3=value
ENABLED
Set to yes to enable PTZ control (requires compatible pan/tilt/zoom unit connected
via serial port).
ENABLED=[no/yes]
CAMERA
On video servers, select camera input number.
CAMERA=[0-12]
TYPE
Pan/tilt type.
TYPE=[ad/pelco/sony/stardot]
DEV
Serial port pan/tilt is connected to.
DEV=/dev/ttyS[0-1]
The URL format for changing TZO parameters is as follows:
http://<ip>/admin.cgi?tzo¶m=value
You can combine multiple TZO parameters in one line:
http://<ip>/admin.cgi?tzo¶m1=value¶m2=value¶m3=value
TZO_ENABLED
Set to yes to enabled TZO dynamic DNS service.
TZO_ENABLED=[no/yes]
TZO_NAME
TZO hostname.
TZO_NAME=[name.tzo.com]
(or name.remotecam.com, name.stardotcams.com)
TZO_EMAIL
Email address associated with TZO hostname.
TZO_EMAIL=[user@example.com]
TZO_KEY
Key or password associated TZO hostname (generated by TZO.com).
TZO_KEY=[XXXXXXXX]
TZO_GATEWAY
Set to yes to enable TZO gateway
TZO_GATEWAY=[no/yes]
Default value: yes
TZO_CTYPE
TZO type. Advanced setting, leave value as 3.
TZO_CTYPE=3
The URL format for changing trigger parameters is as follows:
http://<ip>/admin.cgi?trigger¶m=value
You can combine multiple trigger parameters in one line:
http://<ip>/admin.cgi?trigger¶m1=value¶m2=value¶m3=value
TRIGGER
Set to on to enable triggering.
TRIGGER=[off/on]
EXEC
Script that is run once a triggered event occurs.
EXEC=[trigger-ftp/trigger-smtp]
CAMERA
Select which camera(s) will buffer images. Network cameras are always Camera0.
Video servers have multiple camera inputs, up to 12.
CAMERA[0-12]=[off/on]
MODE
Select type of mode.
MODE=[trigger/continuous]
TYPE
Type of trigger.
TYPE=[edge/level]
Default value: edge
io_port
The I/O port on the back of NetCam.
io_port=[1-4]
io_level
The trigger level, high or low.
io_level=[0/1]
SCHEDULE
For 24/7 operation, set to off. To limit the
days and hours, set to on.
SCHEDULE=[off/on]
START
Trigger schedule start time. Only applies if schedule=on.
START=[00:00-23:59]
STOP
Trigger schedule stop time. Only applies if schedule=on.
STOP=[00:00-23:59]
Day of Week
Set days of week for triggering.
Only applies if schedule=on.
[SUN-SAT]=[off/on]
PRE_BUFFER
To pre-buffer triggered image, set to on.
PRE_BUFFER=[off/on]
PRE_BUFFER_DELAY
Delay in milliseconds between pre-buffered trigger images.
PRE_BUFFER_DELAY=[0-32767]
Default value: 250
PRE_BUFFER_COUNT
Number of triggered images to pre-buffer. Storage capacity is dependent on
available resources and size of JPEG images. It may not always be possible
to store 50 pre-buffer images.
PRE_BUFFER_COUNT=[1-50]
Default value: 8
POST_BUFFER
To post-buffer triggered image, set to on.
POST_BUFFER=[off/on]
POST_BUFFER_DELAY
Delay in milliseconds between post-buffered trigger images.
POST_BUFFER_DELAY=[0-32767]
Default value: 250
POST_BUFFER_COUNT
Number of triggered images to post-buffer. Storage capacity is dependent on
available resources and size of JPEG images. It may not always be possible
to store 50 post-buffer images.
POST_BUFFER_COUNT=[1-50]
Default value: 8
smtp_MAILTO
Email address to send images to after trigger occurs.
smtp_MAILTO=user@example.com
smtp_MAILFROM
Email address in "From" field in triggered image email.
smtp_MAILFROM=user@example.com
ftp_timeout
The amount of time to delay before re-attempting an FTP delay.
ftp_timeout=120
Default value: 120
ftp_hostname
The FTP server hostname the triggered images will upload to.
ftp_hostname=[example.com]
ftp_user
The username for the FTP server the triggered images will upload to.
ftp_user=[username]
ftp_password
The password for the FTP server the triggered images will upload to.
ftp_password=[password]
ftp_passive
Enable/disable passive mode for the FTP server the triggered images will upload
to.
ftp_passive=[off/on]
ftp_path
FTP path where the triggered images will upload to.
ftp_path=[path]
motion_noise
Motion detection noise filter. A low value means ignore less noise, a higher
value means ignore more noise.
motion_noise=[0-15]
Default value: 8
motion_noheaders
If enabled, motion detection flag will not be included in the JPEG header.
motion_noheaders=[0-1]
motion_gradual
If enabled, the motion detection logic will ignore gradual lighting changed
(like a sunset).
motion_gradual=[0-1]
motion_time
Represents the amount of time (in seconds) to keep signalling motion after
motion was detected.
motion_time=[0-7.5]
Default value: 4
motion_show
If enabled, the motion detected areas will display as green squares on the image.
motion_show=[0-1]
motion_sensitivity
Sensitivity of the motion detection logic. A low value means less
sensitive, a higher value means more sensitive.
motion_sensitivity=[0-15]
Default value: 8
The URL format for changing weather station parameters is as follows:
http://<ip>/admin.cgi?wx¶m=value
You can combine multiple weather station parameters in one line:
http://<ip>/admin.cgi?wx¶m1=value¶m2=value¶m3=value
WX_ENABLED
Set to yes to enable weather station polling.
WX_ENABLED=[no/yes]
WX_MODEL
Weather station model number.
WX_MODEL=[wx1/wx2]
WX_DEVICE
Serial port the weather station is connected to.
WX_DEVICE=/dev/ttyS[0-1]
WX_ALTITUDE
Altitude at weather station / camera location, measured in feet.
WX_ALTITUDE=[0-32767]
WX_TEMPERATURE
Temperature offset, in celsius, positive or negative, decimal values permitted.
WX_TEMPERATURE=x
WX_HUMIDITY
Humidity offset, positive or negative, only integers permitted.
WC_HUMIDITY=x