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

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.

If you can find your camera in the device list, drag and drop it on the gray panel. If camera does not present in the list, click Manual in the bottom to open Camera Wizard to add cameras 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.
If you know your full camera stream URL, just insert it into the URL field and click OK.

After manual device has been created, drag it to the panel to add corresponding video channel.

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

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 analyse 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 - .mp4, .mkv, .avi, .flv, .wmv

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.

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.

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.

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 option does not affect video recording frame rate.
Reconnect after defines time in seconds, which Camlytics waits before trying to connect to disconnected camera.
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.