Camlytics user guide

Overview of Camlytics Camera Software, and how to get started with it.

Camlytics supports all video sources that fall under these categories:

  • Web cameras
  • Onvif cameras
  • Cameras that can be accessed via Rtsp or Http
  • Video files
  • Video folders

This covers vast majority of all digital cameras. Web cameras and cameras supporting Onvif standard are discovered automatically and are available in the device list in the left part of the interface. If you cannot find your camera in the list, you need to add it manually via rtsp or http link. Camera link usually looks like rtsp://192.168.1.3/video_device.
The type of the link can usually be obtained through manufacturer's web site or through camera's web admin panel.

If you have a pre-recorded video file and want to perform analysis on it (people counting, motion detection, etc.) you can just add it as a source. The best thing about file is that you can process it in accelerated (not real time) mode which allows you to process hours of video in just minutes.

You can also process folders with video files in one batch - hundreds of hours of video can processed unattended. Following video file formats are supported: .avi, .mp4, .flv, .mov, .wmv, .mkv, .vob

cctv camera manager

If you can find your camera in the "Discovered sources" list, drag and drop it on the gray panel (or double click it) to create channel.

If you don't see your camera in the sources list, it means it is either located in external network or doesn't support ONVIF protocol. In this case, click the "Manual" button in the bottom to open Camera Wizard to add video source step by step.

Camera Wizard allows you to choose the correct camera stream address step by step by choosing camera model, ip address (or scan network and selecting correct one), setting stream parameters and checking available stream URLs.

add cctv camera

If you know your direct camera stream URL (which you may get through manufacturer's web site or through camera's web admin panel) you can insert it directly into the "URL" field and press OK to add video source. If the URL is password protected you can add it in the beginning like this: rtsp://admin:password@123.218.82.30/defaultPrimary0?streamType=u

Next you'll see the Manual channel in the sources list. Just drag it to the panel (or double click) to add corresponding video channel.

After adding channel to panel you will see the Usage scenario dialog.

cctv camera wizard

The dialog lets you choose basic camera usage scenario and mounting type for best settings to be set. Below is brief description of usage scenarios:
Camera events disabled - completely disables all video analysis and camera events, except Camera disconnected event. Uses the least amount of CPU of all. Use this option if you want just to view and record your camera.
Object detection - all moving objects in camera view will be detected and tracked - with according events generated (Object appear/disappear, etc.).
Motion detection - zone with Motion detection scenario will be created by default. According events will be generated.
Object counting - same as object detection but two counting lines will be created by default.
Other - zone will be created by default. You can specify your own scenario. Read more about zones/lines here.
Camera mounting type - for more precise analysis choose mounting type of your camera. If camera looks vertically at the floor, chose Overhead, otherwise choose Angle type.
You can always change camera settings in future regardless of what option you've chosen.

Upon successful connection of the camera Calibration window will appear that allows you to adjust tracker object sizes for your camera.

After adding channel and adjusting its dimensions you can lock it by clicking on lock icon - this will prevent from further modification of channel window. You can also change its name or view additional info by clicking on Channel settings icon or choosing from channel's dropdown menu.

Channel info shows information about network stream - uri, resolution, profile, etc.
Stream type - allows to customize stream receiving protocol, you can change it to UDP, TCP or HTTP if camera picture looks broken (having artifacts, pixelated, edgy or uneven). Changing stream type might also help with frequent camera disconnects.
Stream format - set it as MJPEG if your stream is motion jpeg not working on Auto, otherwise dont change this setting.

In other tabs of the dialog box you can also change recording and camera events settings for this channel.

Files are a great way to analyze pre-recorded videos and generate events for them - count people, vehicles, detect motion, etc. When real time mode is disabled, video is usually analyzed 5x-7x speed of real time video which makes video files a really useful application.
To create a video file based channel, just double click or drag and drop the file icon into channels space.

In file dialog choose the location of your video file, all kinds of extensions are supported - .avi, .mp4, .flv, .mov, .wmv, .mkv, .vob

video channel settings

After adding channel and configuring analytics file will start playing automatically. If you want to re-run analytics, just hit the Refresh icon and the playback will start all over again.
By default video will play fast - to speed up the analytics process, if you want it to play realtime - just set the corresponding checkbox in channel settings.

Folder channel type allows processing hundreds of files of video unattended. This feature is available in premium version only.

Camlytics supports floorplans, or camera maps for easier navigation and better event notification. You can add floorplan by right clicking on channels panel and choosing Add floor plan.

cctv camera floor plan

In opened dialog box, choose the background image, change plan title, drag and drop cameras from the list on the selected image. You can adjust camera orientation and coverage by dragging camera view controls.
To adjust cameras sizes on the map, use the Map size scroll.

cctv floorplan

After floor plan has been added, new events will cause cameras on map blink with red color. Also, when camera is highlighted by mouse, corresponding channel's name will also be highlighted with red color.

Here is the brief description of Camlytics general settings.

Language is responsible for application wide language.
Display framerate configures refresh rate of video in user interface. Reducing its value may improve performance in case of multiple HD channels added.
This setting does not affect video recording frame rate.
Reconnect after defines time in seconds, which Camlytics waits before trying to connect to disconnected camera.
Database events lifetime determines how long Camlytics should keep all camera events and heatmap data in it's database. The bigger value the more disk space the database file will take.
Hide to the system tray enables hiding Camlytics to the system tray to run in background.
Show intro on startup turns on notificartions on application startup.
Enable REST API turns on or off the API.

Find more about recording settings here

You can configure email settings for notifications or reports of camera events vie email.
First, enter your email address. Then, in order to use custom SMTP server, enter server address, port and credentials for the custom SMTP server. If you are using Gmail SMTP service make sure Less secure apps sitting is enabled (https://support.google.com/accounts/answer/6010255?hl=en).

In Reports you can configure daily aggregated email reports for events for all channels. Please make sure that reports are also enabled in each desired channel.

Logging options are made mainly for diagnostics purposes.
Playback logging can be turned on if you experience problems with you IP or web camera playback or recording (not connecting, bad quality, wrong bitrates, etc.).
Analytics logging records video analysis log. It is encoded and is for reporting purposes only .
All logs will be located in %appdata%\Camlytics\Logs folder.