Download this User Manual in PDF

Found a feature that is not described in this manual, or have questions or suggestions? Please, let us know.

Complete Xeoma User Manual

Table of contents:

1.1. Introduction
1.2. Key features and typical applications
1.3. System requirements
1.4. Modes of functioning

2.1. Getting started
2.2. Interface of Main Window in Xeoma
2.2.1. Interface of Main Window in Xeoma
2.2.2. Layouts menu (grid, visualization, decoding settings)
2.3. Quick settings window
2.4. Detailed settings window
2.5. Module settings window
2.6. Changing cameras order
2.7. Camera bulk management: Device List
2.8. PTZ control and zoom
2.9. Camera bulk management: eMap

3.1. Sources settings
3.2. Destination settings
3.3. Filters
3.4. Motion detector
3.5. Archive
3.6. Face Detector and Face Recongition
3.7. Visitors Counter
3.8. Marking
3.9. Relay Switch
3.10. Privacy masking
3.11. Smoke detector
3.12. Object detector
3.13. HTTP marking (POS integration)
3.14. HTTP request sender (integration with home automation)
3.15. HTTP upload to other Xeoma
3.16. RTSP Broadcasting

4.1. Client-server architecture
4.2. Installation
4.3. Licensing
4.4. Activation
4.4.1. Online activation
4.4.2. Offline activation
4.4.3. Activation on virtual machines
4.4.4. Activation on virtual machines with license server
4.4.4. Activation on virtual machines with license server
4.4.5. Hardware keys (USB flash drive)
4.5. Updates
4.6. Operators and user access rights
4.6.1. User access rights
4.6.2. PTZ blocking for operators/users
4.7. Settings Restore
4.8. The visualization of movement
4.9. Heatmap
4.10. TLS secure connection
4.11. Backup of recordings
4.12. Failover
4.13. Hardware acceleration
4.13.1. Server
4.13.2. Client

5.1. Work with proxy servers
5.2. Remote access options
5.3. Repeater
5.4. Web server
5.5. Web server customization
5.6. Android app
5.7. iPhone/iPad app
5.8. VPN connection

6.1. Xeoma Pro
6.2. Xeoma Cloud
6.3. Customization of Xeoma

7.1. Uninstallation
7.2. Tips on how to reduce CPU load

1 – Typical applications. Scenarios
2 – Typical video surveillance goals and how to do that with Xeoma
3 – Easy start guide even for newbies
4 – Console work
3 – Supported console commands
5 – Console launch troubleshooting
6 – Web server customization for online view of cameras in Xeoma
7 – Xeoma settings
8 – Change camera order
9 – Multi-server mode
10 – Repeater
11 – Step-by-step guide on using free rebranding of Xeoma
12 – Device List (devices by groups)
13 – FTP-receiver: easier way to connect your camera
14 – Dual streaming with rtsp (h264) cameras
15 – How to set Xeoma on Raspberry Pi with ARM processor
16 – How to move Xeoma recordings
17 – Time lapse in Xeoma


1.1. Introducing Xeoma

Xeoma is Russia’s #1 bestseller in video surveillance software, according to, one of the biggest software online stores.

It is a complete video surveillance solution with unlimited flexibility owing to its innovative construction-set principle. Easy for non-tech savvies, powerful for professionals, it allows to build both small and enterprise-level systems with truly unlimited number of cameras (up to several thousand cameras on single computer). The program works on Windows, Linux, Mac OS and Android devices (full-featured version) with full remote access and view from any mobile devices and computers.

Xeoma offers auto-detection of and support for almost any cameras – IP, ONVIF, USB webcams, H.264, H.265, H.264+, H.265+, MJPEG, MPEG4, PTZ, WiFi (up to 99.9% of cameras on the market supported). With its help, in just a few seconds a computer and a camera will turn into a ready to work out-of-the-box surveillance system.

Intellectual motion detector with advanced false alarm avoiding logic, motion-triggered or scheduled notifications (SMS, email, sound alarm, etc.) and screen captures, work with sound are perfect for staff monitoring and parental control.

Shared access rights, encryption, password protection, network clustering, also on operating systems without graphical shell, make monitoring efficient and stable even for professional-scale surveillance systems. No installation and no admin privileges required. Professionals will certainly appreciate automatic backup to FTP server, powerful web server and remote view of all cameras with sound (flash video streaming), cyclic archive with export feature.

Economy at its best: Try the demo edition of Xeoma with unlimited functionality! Use it as long as you want. Once you feel like extending your system, you can purchase a license at most economical price! Save at expense of security staff or costly surveillance solutions, replacing and maintaining out-of-date surveillance equipment.

Xeoma doesn’t contain any spy, virus or malware. It is completely safe.

Download       Buy       Videos       Contact us

1.2. Xeoma key features

Camera/sources processing:

  • Compatible with any webcams, analog cams, including WiFi wireless cctv cameras
  • Supports IP-cameras (including H.264, H.265, H.264+, H.265+, JPEG/MJPEG, MPEG-4, Fisheye, PTZ and ONVIF, wireless cams, i.e. perfect both for wired and wireless cctv)
  • Any resolution (Mpix)
  • Screen captures from all monitors simultaneously
  • Adjustable sound quality and sound volume
  • Up to 2 000 cameras can be connected on 1 computer!

Professional surveillance made easy:

  • Free rebranding and customization
  • Quick setup: group settings of modules
  • Quick navigation and control of cameras with Device list
  • Xeoma Cloud Service
  • Xeoma Pro – professional extension to regular Xeoma
  • Setup of cameras, modules, and schemes in a configuration file in Xeoma Pro
  • Creating a surveillance network of Xeoma cctv software servers by using web server
  • Multi-Server and Multi-Client connection architecture for video surveillance of any size
  • Flexible setup of access rights (user permissions)
  • Password protection of settings
  • Fullscreen view
  • Work with multiple monitors
  • Support for PTZ control
  • 360° camera image rotation
  • Sound detector
  • Instant screenshots of camera image

Intellectual modules and features:

  • Fisheye cameras image dewarping
  • eMap – map of your video surveillance site with interactive cameras on it
  • Face detector
  • Object detector to follow objects even if they’re not moving
  • Synchronization with camera’s SD card
  • Synchronization with cashier registers
  • LDAP active directory synchronization
  • Easy home automation system integration thanks to HTTP request sender and HTTP switcher modules
  • Possibility to create your own cloud video surveillance service with Xeoma Pro
  • Privacy masking to blur areas you’re not supposed to record, or faces
  • Automatic object tracking with zoom (PTZ tracking) and visualization of moving objects
  • Sabotage detector to notify you when problems are detected
  • PTZ control also in browsers
  • Quick turning on/off of chains remotely (HTTP Switcher) and locally (Button Switcher)
  • Search in archive for motion events by time or in selected areas
  • RTSP and HTTP broadcasting: emulation of IP cameras streaming in MJPEG, JPEG, H264, etc.

Remote access:

  • Remote view via mobile devices (Android, iPhone, iPad supported)
  • Online view of all cameras with sound
  • Full remote access to settings, archive and cameras from a workstation
  • Internet broadcasting
  • Possibility to embed camera image to your site
  • Remote access even with dynamic IP address
  • View of archives and basic setup in web browsers

Motion detector:

  • Setting up of zone(s) of any size and shape to monitor for motion
  • Visual motion detection, with time of the last detected movement shown on preview
  • Setting up maximum object size to be ignored, and sensitivity level of sensor
  • Pre-record option to store several seconds preceding motion detection
  • Post-record to continue recording after the event has finished
  • Record delay
  • Enhanced algorithm to avoid false alarms caused by pets or weather changes


  • Loop recording
  • Adjustable maximum size of archive and compression rate of images stored to archive
  • Possibility to store archive onto different HDDs, RAIDs
  • Support for network attached storage (NAS), Google Cloud disc, etc.
  • User-friendly built-in media player with search for motion event or specific time
  • Export of a selected extract right from the viewer
  • Deletion of unneeded extracts from the viewer
  • Search for motion events by time and in selected areas
  • Simultaneous synchronized view of several archives

Notifications and reactions:

  • Text message (SMS) sending
  • E-mail notifications (with attached JPEG images and MJPEG videos)
  • Event-triggered pop-up window
  • Sound alarm
  • Running a specified external program
  • FTP server upload of images and videos with sound
  • Saving files to the specified path with cyclic recording

All high-demand features:

  • Hidden mode of work
  • WEBM (VP8 and VP9), MPEG-4, MP4 and MJPEG video formats
  • Marking (embedded time and date, custom text, GPS coordinates, or image stamp over camera’s stream)
  • Scheduler, setting up when system’s components are to start/end work
  • Adjustable volume of sound in preview mode
  • Quick setup: duplicating of chains
  • Adjustable preview mode (camera layouts, window transparency, font)
  • Automatic slide show of real-time images
  • 1-click-easy updates
  • New versions notifications

Xeoma advantages:

  • Full-featured work on Windows, Mac OS X, Linux and Android
  • Free download
  • Full featured trial (demo) edition can be used multiple times
  • Free edition with no time-of-use
  • Ready to work right after downloading with default settings
  • No installation needed
  • No admin rights required
  • Simple additional settings
  • Flexible control like in a children’s construction set
  • Innovative intuitive graphical interface
  • Dynamic development and addition of cutting-edge features
  • Available in Main languages:
    English, Spanish, Italian, Brazilian Portuguese, Chinese, French, German, Japanese, Hungarian, Polish and Russian.

    Additional languages:
    Dutch, Danish, Romanian, Turkish, Croatian, Finnish, Greek, Czech, Bulgarian, Ukrainian and Belorussian.


Typical applications:

  • Object monitoring in non-working hours (office, store, warehouse)
  • Security surveillance (perimeter security monitoring, car, etc.)
  • Smart home systems integration
  • Staff monitoring (industry workers, office employees, caregivers and home staff)
  • Monitoring of activity of children and office workers on computer, control over visited sites
  • Pet surveillance
  • Watching machinery in industries

1.3. Minimum system requirements:

Windows – Windows 7, Windows 8, Windows 10, both 64-bit and 32-bit versions, Windows Server 2008 R2/2012/2016.

Linux – both 32-bit and 64-bit versions with XWindows or console/server. Available for Linux based on ARM processor (e.g. Raspberry Pi) or Intel processors.
Supported Linux distros:
Ubuntu latest versions (12, 13, 14 and newer),
Debian 7 and up,
openSUSE 12.2 and up,
Mint 13 and up,
CentOS version 7 or higher,
Red Hat Enterprise Linux version 6 or higher,
ArchLinux (archlinux 2015.06.01 or newer).

Note: Linux console sound support requires: libasound2. To install or run Xeoma on Linux please make sure you are uncompressing xeoma_linux.tgz archive on Linux machine. Otherwise, it is required to execute: chmod a+x and then you can run Xeoma as usual: ./

If you are installing 32 bit version on your 64 bit Linux distro (although it’s better to download the 64 bit version in this case), you might need to install ia32-libs.

Mac OS X version 10.7* or higher.

Android – Android OS 4.0 (API LEVEL 10) or higher (recommended – 4.2 or higher), 20 Mb of free operating memory, screen resolution – 450×450 or higher.

iPhone/iPad – iOS version 6 or higher.

For more detailed information please visit our minimum system requirements calculator page.

*Support for Windows XP, Windows Vista or lower, and Ubuntu 11.10 or lower, and 32-bit Mac OS, as well as for Raspberry Pi I device is discontinued in version 17.6.23 and up. Please make sure to upgrade to a more recent operating system by that time if you are planning to use future versions of Xeoma.
**Starting from version 17.7.31 Xeoma requires GLIBC_2.17 or higher so it is recommended that you use CentOS 7 or higher.

Available languages:

Main languages:
English, Spanish, Italian, Brazilian Portuguese, Chinese, French, German, Japanese, Hungarian, Polish and Russian.

Additional languages:
Dutch, Danish, Romanian, Turkish, Croatian, Finnish, Greek, Czech, Bulgarian, Ukrainian and Belorussian.

See Xeoma information in your language

1.4. Xeoma’s modes of functioning

Xeoma can be used in either of its 3 modes (free, trial and commercial (which in its turn is divided into Lite, Standard, and Pro editions)):

The free edition lets you view unlimited number of video sources (cameras) and up to three modules in each scheme. Maximum 4 Preview and Archive modules, maximum 4 Sending Email modules are available. Connection to remote server can be done with any version of Xeoma. But please pay attention: remote connection TO the machine with Xeoma in the free mode cannot be done. See video about Free edition

Lite version is the first of 3 commercial editions, it lets you use up to four video sources and up to six modules in each scheme. This version should be activated with the special license. Xeoma Lite doesn’t support updates of the program, and renewals are not applicable. You can use the version that you activated Xeoma Lite on for unlimited time. See also video about Lite edition

Trial version has no limitations in functionality, number of video sources or modules but all settings will be reset in 4 hours and will not be saved at program restart. Please note, due to trial version limitations you can store your Archive for only 1 hour, then it will be rewritten. Remote server can be connected to with any version of Xeoma. video about Trial edition. If you need more time to test Xeoma before you buy, simply contact us.

The Standard edition has no limitation in remote connections and video sources number. Total number of video sources/cameras in use depends on your license. Video about Standard edition

The Pro edition has all the advantages of the Standard edition + professional modules like ANPR, Face Recognition, Smoke Detector, etc. See more here

You can switch between modes via Main Menu -> Information or Main Menu -> Information -> About.

Comparison table for Xeoma video surveillance software editions:

Trial Free Lite Standard Pro
Maximum number of available sources Unlimited Unlimited 4 Unlimited (depend on license type) Unlimited (depend on license type)
Maximum number of modules in chain Unlimited 3 6 Unlimited (depend on license type) Unlimited (depend on license type)
Archive retention period before overwriting 1 hour 5 days Unlimited Unlimited Unlimited
Remote access Yes No Yes Yes Yes
Multiple user profiles available Yes No No Yes Yes
Possibility to use Repeater* Yes No Yes Yes Yes
Time of work 4 hours after last change of settings Unlimited Unlimited Unlimited Unlimited
Watermark Free Yes Yes Yes Yes
Updates to new versions of Xeoma Yes Yes No Yes (1 year since purchase date)

extend the free updates period with up to 80% discount

Yes (1 year since purchase date)

extend the free updates period with up to 80% discount

Customization Yes No Yes Yes Yes
Other key features free of charge

settings are restored to defaults every 4 hours/at program exit

all features available for test

free of charge

maximum 4 Preview and Archive modules, maximum 4 Sending Email modules

user profiles available for access on the same computer

unlimited time of work with free updates of the program

paid mode (requires a license)

limited number of available modules

paid mode (requires a license)

Standard licenses cumulate with Pro

all regular modules available

paid mode (requires a license)

Pro licenses cumulate with Standard

regular + special PRO modules available

Camera view in web browser Yes, 1 camera No Yes Yes Yes
Change of settings in web browser Yes No Yes Yes Yes
PTZ control Yes Yes Yes Yes
PTZ control through web browser Yes Yes
Digital zoom Yes Yes Yes
PTZ Tracking Yes Yes Yes
Fisheye Dewarping Yes Yes Yes
Search in the archive viewer by date/date Yes Yes Yes Yes Yes
Search in the archive viewer in certain area Yes Yes Yes
Synchronized playback of several archives Yes Yes
Quick turning off/on of the cameras Yes Yes Yes Yes Yes
Button Switcher Yes Yes
HTTP Switcher Yes Yes Yes
Device List Yes Yes Yes Yes
Interactive maps eMap Yes Yes
Visitors Counter Yes Yes Yes
Loitering Detector Yes Yes
Face Detector Yes Yes
Privacy Masking Yes Yes
Motion Detector Yes Yes Yes Yes Yes
Sound Detector Yes Yes Yes
Smoke Detector Yes Yes
Detector of Abandoned Objects Yes Yes
Problems Detector Yes Yes Yes
Object Detector Yes Yes Yes Yes Yes
Image Rotate Yes Yes Yes Yes Yes
Image Resize Yes Yes Yes
Picture in Picture Yes Yes Yes Yes
Unitor Yes Yes Yes Yes
SMS Sending Yes Yes Yes
Visualization of movement – preview Yes Yes Yes Yes Yes
Visualization of movement – archive Yes Yes
RTSP Broadcasting Yes Yes
FTP Upload Yes Yes Yes
ANPR Sender to FTP Yes Yes
Saving still image (preview, archive) Yes Yes Yes
Various layouts Yes Yes Yes Yes
Fullscreen mode Yes Yes Yes Yes
Client parts update automatically Yes Yes
LDAP synchronization Yes Yes
Possibility to delete pieces of archive Yes Yes Yes Yes Yes
Possibility to make intervals of archive undeletable Yes Yes
Sound alarm – client Yes Yes
Sound alarm – server Yes Yes Yes Yes Yes
HTTP Marking Yes Yes Yes
Application Runner Yes Yes Yes
Sending Email Yes Yes Yes Yes Yes
Relay Switch Yes Yes Yes
HTTP Receiver Yes Yes Yes
HTTP Upload to other Xeoma Yes Yes Yes
HTTP Request Sender Yes Yes Yes
Activation on virtual machines, including Docker Yes, details here Yes, details here
Live view Yes Yes Yes Yes Yes
Save to Archive Yes Yes Yes Yes Yes
Save to File Yes Yes Yes Yes Yes

*Repeater is an optional service, bought separately for additional price.


2.1. Let’s get it started, or how to use Xeoma

You can also view Xeoma Video Tutorial

Suppose you have a goal of conducting video surveillance. You have a computer or a tablet, a camera or several cameras to start with, and an area to monitor. Xeoma will be a perfect solution, for it works with cameras of all types (hundreds of models are supported), and can work on various operating systems. These are the simple steps to make it work.

1. Download Xeoma for your operating system from our site. You can choose between official release or beta version (usually more recent, also stable but undergone only alpha-testing). Suggested version of Xeoma for the device you’re accessing our site from is to be found above the download options table. If you don’t know what to use, try this one on this device.
Xeoma consists of 2 parts – server and client – the downloadable executable file contains both (except for iOS, Linux/ARM). You can separate the two parts when you run Xeoma or install it.

For OS with graphical shell:

For console (don’t forget to unpack the archive after it’s downloaded):

2. Run Xeoma as usual applications on the computer that will become the core of your video surveillance system. This will be your server. It will process cameras and other sources, save recordings, etc. If Xeoma is not activated yet, including when you run it for the first time, it will be launched in the trial edition. Switch between free, trial and commercial editions in Main menu. Troubleshooting of launch and installation

For graphical shell OS: simple click or double click on Xeoma executable file (make sure to unpack the archive if it was archived)

For console:

3. When you first launch Xeoma, it scans the network in search for cameras. All cameras that Xeoma finds will be added to the Main Window. Cameras that require authorization and therefore cannot be added yet will be listed in ‘+’ menu in the panel below. If the scanning takes too much time, or if all your cameras are already added, you can stop the search by clicking on scanning progress bar in the right bottom corner. More about automatic search.

4. By default, all found cameras are added with a default scheme of Universal camera – Scheduler – Motion detector – Preview and archive – Problems detector – Email sending modules with default settings (exception is the Lite and Free edition where default chains are Universal Camera – Motion Detector – Preview and Archive, due to limitation of maximum count of modules in chains). You can add, delete or re-configure modules the way you need.

  • Camera: select image resolution and refresh interval (for USB cameras), or a stream with pre-configured parameters (for network cameras). Analog cameras will be detected either as USB or IP cameras, depending on the method they are connected through. More about configuring a camera
  • Motion detector: select a zone or several zones to monitor for motion, set pre- or post-record, sensitivity of the sensor.
  • Scheduler: set time and dates the following modules are to work. By default, set to work 24/7.
  • Preview and Archive (also known as the Archive module): you can re-configure where to save files to, how long to keep files before they are overwritten, maximum size the archive is allowed to take. By default, time of storage is 1 hour in the trial mode. When in the commercial or free mode, you can set archives to be kept for a longer period of time.

5. Xeoma executable file is portable. That means you can choose to install Xeoma or just launch it when you need it. Install Xeoma to make it start with your operating system. Hidden mode of work can also be set in the Installation menu. Learn why you need installation

6. To view recordings, press the small ‘Play’ button in the top right corner of camera image in Main window or a bigger ‘Play’ button in the panel below. You will get to the built-in archive player where recordings can be viewed and exported.

Remote access and view of cameras live and recorded feeds is also required? Xeoma is perfect for meeting this goal as well. Use the data from Connection dialog to connect remotely, from any other place, for example, from another workstation.

No remote access required? Then Xeoma can work without Internet connection. Instruction on Offline activation

You can also create user profiles for those who are authorized to watch and control the cameras, and assign them specific rights and permissions, and many other useful features.

Tip: For work on operating systems with no graphical shell, please check our console guide.

2.2. Interface of Main window in Xeoma

2.2.1. Interface of Main window in Xeoma

Interface of main window in Xeoma webcam app Main program window includes operating system’s window title/titlebar (1) and program interface – preview boxes (2) (live images from cameras and other sources of signal) and a bar below the previews (3). Window title usually contains version of Xeoma used (4), mode of functioning (5) and name of the screen you’re currently in (6). When connected to a remote server, you can also see IP address of the server in the window title and if version of the client doesn’t match the server’s, the client version as well.

In the titlebar there are usual control buttons: ‘Minimize’, ‘Maximize’, ‘Close’. Window position can be moved on the screen by dragging with mouse of its titlebar. Window can be resized by any edge and border.

Each preview box has small archive (7) and settings (8) icons in the top right corner used to access archive viewer and detailed configuration of the camera (source) by clicking on corresponding icons. If the camera supports PTZ controlling, a small PTZ icon will be shown along with the other two.

Below the archive and detailed settings icons, you will see the time of last detected motion (9) (if there is a motion detector module in the chain working). Clicking on the time of last detected motion will open archive on the place when this motion began. Moreover, if there was motion detected, the preview box frame will become red in color that will gradually (in 3 minutes) come back to the original white circuit (blue when cursor is hovering over it). If a motion event is currently in progress, you will see red ‘•Rec’ instead of time indication below the small archive and settings icons.

In the left top corner of the preview box there is the preview’s name (11) that can be set up in Preview or Archive and Preview module. Click on the name here to open the settings right here.

Quick overview of settings for each preview box can be accessed by clicking on the preview box image (anywhere within the preview box) (12).

The popup bar below has buttons as follows: ‘List‘, ‘Plus‘, ‘Nut‘, ‘Play‘, ‘Window‘, ‘Info‘. The bar can be hidden by dragging it down and showed by dragging it up, or simply by clicking on it.

  • ‘List‘ is a Main Menu symbol. It has somewhat different option depending on what Screen you’re at at the moment. In Real Time View Screen it opens a dialog that allows to

– configure remote access options (including Repeater and user profiles setup),
– turn all sources off and back on,
– enable/disable Device List,
– install or uninstall the program to autostart (including Hidden mode), open Xeoma Video Tutorial and switch between trial, free and commercial versions of the program,
– buy a license and activate the commercial version in Registration menu,
– find information about the program, your licenses, leave feedback or visit official developer’s site,
– switch languages.

  • ‘Plus‘ button is used to add new cameras. If there were any cameras detected in the local network, they will be available for adding right in this menu. If not, there are choices of either add random world webcam, duplicate the last scheme, repeat scanning for cameras, or use advanced search for cameras, this time with use of login, password, subnetwork indication, or camera’s port.

Also, here you can duplicate the camera you last viewed – this option comes in handy when you need to quickly clone complicated schemes because their settings are almost identical.

  • ‘Nut‘ is the same as settings symbol in top right corner of a preview box – here it is used to access Detailed Settings of the camera you last viewed and configure all features in the visual way.
  • ‘Play‘ in the lower panel is similar to the archive symbol in top right corner of a preview box – here it opens a dialog to select archive recordings of which cameras you’d like to view. After selection archive viewer will be opened where all recordings made with the “Preview and Archive” module can be viewed and extracts in chosen format can be exported.

Tip: another good way to conveniently control and group cameras is Device List.

2.2.2. Layouts menu

Multiple camera feeds on a single screen can be quite a confusing mess, unless arranged properly. Xeoma holds an abundance of tools to help you with that. Too many camera images on one screen? Want the cameras to scroll automatically? Need to get rid of black borders on the sides of the video? Want the program to show exactly what it detected and where and even enlarge the right window when it happens? How about an interactive map of the complex with every camera accounted for?

All these can be customized by accessing Xeoma’s “Layouts menu”. Click the button with a window to start optimizing your screen. The most basic (and the most useful) function is “Manage layouts”. To assign a specific set of cameras to a single screen choose “Layout: custom” and click on the camera images you need (they will be highlighted in blue), then click the window-button again. In the upper left corner you will now see 2 tabs: “All cameras” and “Page 1”. The latter is the one you’ve just created, right-click on it to rename the tab, e.g. the area these cameras oversee. If you need to change the images’ positions on the screen, simply drag them.


If you need another page simply go to “Layouts menu” → “Manage layouts” → “Layout: custom” → “Add new tab” and highlight other cameras. Made a mistake while selecting cameras for a certain page? Choose “Edit current tab” in the same menu and select/deselect the camera images. Don’t need the page anymore? Click “Delete current tab” (the cameras will stay connected to the server, you can still see them in the “All cameras” tab). Finally, if you want Xeoma to arrange the cameras automatically by the sample, choose “Layout: XxY” (the first number is the amount of cameras across the window, the second – down the window). If you don’t want the tabs to be visible in the window, go “Layouts menu” → “Manage layouts” → “Hide pages panel”.

The black borders on the sides of the image can be rather annoying. To get rid of them you will need to go “Layouts menu” → “Manage layouts” and choose “Stretch: select cameras” (if you want to affect only specific cameras) or “Stretch: all cameras”. Now you can select the the type of stretching: “Original”, “Stretch” or “Fit in”. The first means no stretching – the images are shown the way they are. “Stretch” will eliminate the black borders by stretching the image in the right sides, which will slightly affect the proportions. Please be advised that “Fit in” will force the image to both fit the window and keep the proportions intact by cutting parts of it off if necessary.

If you are making your own security station, you may want Xeoma to automatically scroll between several pages with a fixed interval. To do that go “Layouts menu” → “Manage layouts” → “Automatic scrolling” and choose the interval (5 sec, 1 min or 5 min). All done!

When you have several camera feeds on a single page one or two of those may be more important than the others. If you want them to take more space on the screen, you will need the “Larger grid mode” menu. There pick “Larger grid: 1×1” (if you need 1 big image, pick “Larger grid: 2×1” for 2). If Xeoma enlarged the wrong video, access the “Larger grid mode” and choose “Click-to-add mode”, then simply click on the right image.

If your chains have detectors in them (e.g. “Motion Detector”) you can make Xeoma enlarge an image as soon as a detector there is triggered. Go to “Layouts menu” → “Larger grid mode” → “Form group by detectors”. Easy!


You can adjust Xeoma’s window itself by accessing the “Window settings” menu. If either your traffic or your CPU experience a high load you can adjust the “Maximum FPS” slider. The image will be less “smooth”, however. If you can’t see the camera names on screen, check the “Font size for camera names” and set it higher. The interface itself can be enlarged too by adjusting the “Scale interface (in percents of original size)” slider. You can also enable the transparency of the window (by checking the box “Turn transparency on” and change it with the slider “Transparency”. Finally, you can check the box “Always on top” to make sure that Xeoma’s window is never blocked by another one.


Sometimes the program can prove to be more attentive than a human. Suppose it manages to notice a movement the guard missed. Can it point out exactly what moved? Sure. Go “Layouts menu” → “Visualization settings” → “Turn on visualization of movement”. Now Xeoma will consistently highlight every movement the “Motion Detector” noticed with a frame.

You can also visualize the trajectory of the moving object by selecting “Turn on movement track visualization” in the same menu. Now Xeoma will add green dots on the screen following the object’s path.

If a camera is disconnected or not sending any feed you would want to know that right away, Xeoma can help you with that, too. Go to “Layouts menu” → “Visualization settings” → “Show red cross over disconnected cameras”. With this option on, every time the image of any camera “freezes”, it will be crossed out alerting the viewer.

If you are managing the security for an entire building, you may need an interactive map with cameras marked on it to facilitate the control. Go to “Layouts menu” → “eMap”< and press “Load map”. Now click the folder-button to the right to choose the file containing the map (any image file will do: png, jpg, bmp, etc.). Press “Save” to keep this map in Xeoma. Once the map is loaded you can start adding cameras to it by clicking “Add camera to map”. Select the camera's IP in the drop-down menu and click its location on the map. After the camera appears on the map you can also press and turn it so that it faces the right way. layouts_emap

When any detector is triggered within a chain for a camera, you will see the detector’s symbol outlined in red under its respective camera.

If you are experiencing FPS issues (“jerky” video) with a high resolution camera, you can try accessing “Client decoding settings” in the “Layouts menu”. Here you can change “Video decoding on the client side for live preview”. By default, it’s set on “Auto detection”, but you can switch it to “Disabled” if you are having troubles viewing your cameras by remotely accessing the server. Be advised, however, that this will increase the server’s load. Choose “Enabled for Single Camera View mode” or “Enabled” if your server’s load is too high. This will put more strain on the client, though.

Changing “Video decoding on the client side for archive view” may also help in reducing the server’s load. Finally, you can use “Hardware acceleration of video decoding” to deal with FPS issues. It can be either “Intel Quick Sync” (for processors with integrated graphics) or “NVIDIA CUDA” (for graphics cards). Please make sure that the client-machine’s hardware supports either of these two, otherwise it won’t work.

There is one more way to somewhat relieve the server at the expense of the client and that is to go “Layouts menu” → “Enable buffering on the client side”. More ways of reducing CPU load.

Layout management is a very important factor in creating effective security systems protecting both your private and business life.

2.3. Interface in Quick settings window

Quick settings interface has a side popup panel with list of features in use for this camera with check boxes to turn them on or off quickly. Click on a module’s name to open its settings and set it up right in this window. Use arrows to navigate between chains (cameras).

The bottom bar in Quick settings acquires additional icons, as compared to the Main window interface: ‘Arrow‘, ‘Red Cross‘, ‘Flip‘ and Volume (optional: Screenshot icon – if you chose in the Main Menu to have it as a button).

Handy left panel for quick configuration of your video surveillance system

PTZ control in Xeoma webcam app ‘Arrow‘ is used to go back to the previous window, in this case – to the preview window (main window).

‘Red Cross‘ will delete the current camera and all modules connected to it (the whole chain). Please pay attention – the action is irreversible.

Click ‘Flip‘ to activate intuitive PTZ (pan-tilt-zoom) control feature of your camera. Click ‘Volume‘ to activate volume control and adjust volume of sound. Screenshot does the same as Screenshot menu option: instant captures of this camera image and stores them to a default folder that you can change.

2.4. Interface in Detailed settings window

Interface of Detailed Settings window in Xeoma webcam appThe bottom bar of Detailed settings window is nothing unusual compared to those of previous screens.

Modules represent features that can be used to achieve maximum efficiency of the video surveillance system Xeoma. Thanks to the construction-set principle you can .

Top panel is the list of available modules and ready-to-use sample chains, under top panel there is the scheme of work. To the left there is an arrow symbolizing going back to the previous screen you were on before you went to the Detailed settings, and the Eye symbol that will take you to the Main Window.

  • To add a module into a scheme drag it down to the scheme.
  • To connect modules place one of them on another or drag a line (a wire, or connection) from one of them to another.
  • To delete connection between modules click on it.
  • To change the order of modules simply drag a module on another connection.

To add a module, click on it in the modules panel, or drag it down To delete a module, drag it back to the modules panel, or click on any connection, or click on Trash bin in the module's settings

To set a module up click on it, when it’s in the scheme of work area.

Note: a scheme will only work when all modules you chose are wired (connected with white lines). If modules are connected with grey lines, it means one of the modules is switched off and all of the following ones are not getting image from it.

Generally, 2 modules are necessary for every scheme to work: 1 source module and 1 destination module of any kind.

For example, the default scheme is Universal camera -> Scheduler -> Motion detector -> Preview and Archive. You can build a scheme much more complicated than that though, depending on your goals.

2.5. Interface in Module settings window

Interface of settings window in Xeoma webcam appTo open a module’s settings, you can either click on the module name in the left panel of the Quick Settings Screen, or click on the module icon in the field of work of the Detailed Settings Screen.
Naturally, various modules will have various settings. But some elements are the same.

(1) – Icon of the module you’re in the settings for. Click it to get more information about what this module does.
(2) – Module state: Enabled, Disabled (or Skipping – only for filter modules). Enabled – module is working and passing signal on to other modules it’s connected to via white wires. Disabled – module is disabled, signal does not get through on to following modules. Skipping – module is ignored, signal gets through as if there was no such module in the scheme.
(3) – Camera image with the Skipping or Not skipping text.
(4) – Some modules have some of their settings hidden under ‘Advanced settings’ link. Usually it’s more complicated settings that not every one needs. Click on it to expand the advanced setting of a module.
(5) – Recycle bin. Click it to delete the module.
(6) – Information icon. Click it to get more information about what this module does.
(7) – The big X button is the cancel button. Click it to discard the changes you applied during the current visit to the settings window.
(8) – The big tick button is the OK button. Click it for Xeoma to accept and remember the changes you applied during the current visit to the settings window.
(9) – Group settings (where applicable) this option at the top of the module’s settings window will help you apply changes to all or some modules of this type. It’s convenient when you need to quickly set up many modules of the same type.

2.6. Changing cameras order

You can change the order the cameras are laid out on your main screen simply by dragging the preview box of the camera to the right place (i.e. exchanging its position with another preview box).

Photo instruction on changing cameras order

2.7. Device List (devices by groups)

When working with large numbers of cameras, the quick access and grouping of Device List might come in especially handy. Here is the instruction.

2.8. PTZ control and zoom

In Xeoma, you can have control over camera’s PTZ (pan tilt zoom) functions or, if a camera doesn’t support it, use digital zoom.

1. PTZ. If your camera was connected to Xeoma all right, and pan tilt zoom commands it supports were successfully identified, you will see the PTZ control icon in the top right corner of camera’s preview box on the Main Screen/Quick Settings Screen, or in the lower panel of the Quick Settings Screen. Clicking on the icon yields opening of the PTZ control. Click on the arrows to turn camera up/down/left/right. Click on + or – to zoom in or out.

If the PTZ control is shown but clicking on arrows, + or – of the control does not work, go to the Detailed Settings Screen for this camera, open module settings of the Universal camera and go down to the PTZ options list. Try different options there, if any other is detected for your camera. If a non-standard port is used for pan tilt zoom commands in your camera, you can specify the correct one in the provided box. If none of this works, try using a different URL for your camera or contact Xeoma Support Team to get information.

If you’re sure that the camera does support PTZ yet the PTZ control is not shown in Xeoma:
a) Make sure you’ve filled in correct and full authorization data for the cam.
b) Try to re-add this camera with the same or different URL.
c) Make sure you’ve specified the correct PTZ port for the cam.

2. Digital zoom. Digital zoom is a method to digitally enhance the image, bringing the subject closer electronically without using the lens.
If your camera has a quite high resolution and you need to descry a far away object – just enable the option in the Main Menu of the Quick Settings Window or the ARchive Viewer Window and zoom in and out by scrolling mouse wheel.

3. PTZ control in a browser. See web server

2.9. eMap (interactive map of the site)

Interface of settings window in Xeoma webcam appE-Map displays the monitoring area on an electronic map, by which the operator can easily find the cameras. Download the facility plan to the program and locate security equipment. Drag and drop camera icons on the scheme, name your cameras and specify each camera angle. To improve video surveillance effectiveness please use the built-in motion and noise detectors. As soon as one of the detectors will trigger, Xeoma will show you what is happening on the map. You will see the red sensor and can easily determine in which room there was a movement or noise threshold exceeded the limit. Navigate to camera preview in 1 second!

Xeoma’s eMap is multilayered, it can store as many maps for different floors as you need. Click “Load map” again and choose a different name and path. “Save” it and you now have 2 different maps to work with. You can switch between them by using the drop-down menu “Choose map”. Add cameras to the second map the same way you did for the first one.


Now it’s as simple as clicking a camera to access its image. Moreover, if the chains for your cameras contain detectors (e.g. “Motion Detector”), the eMap will help you oversee their work. Each time a detector reacts, an outline of that detector’s symbol will appear in red right under the camera.


If you no longer need a certain eMap, you can always click it in the “Choose map” drop-down menu and press “Delete map” underneath. If you misplaced a camera on the map, you can press Delete camera from map and simply click it.

2.10. Changing camera’s names in preview

If you want tochange the camera’s name in its preview box top left corner, use one of the following ways:

1. Mainly the Source name setting in Universal Camera is designed to change camera’s name:


2. You can also change the camera’s name in the Preview and Archive or Preview modules settings:


Name of the camera will be comprised of what is set up in Universal Camera and Preview and Archive or Archive so it might be a good to only set up camera’s name in just one of these places.

3. Click on the camera name in Main Window or Single Camera Window.


Right in this window a settings dialog will be opened:
– “Preview and Archive” (“Preview”), if you never edited the camera’s name. See 2,
– “Universal Camera”, if you edited the camera’s name before. See 1

For changing of camera name in web browser view see Web Server

Modules settings

3.1. Sources settings

Click on camera icon to configure it

Universal camera

This module allows you to select as source of the image – a camera (IP, USB, including wireless cameras) or world Internet camera (‘Random IP Camera’). Name of the camera can be specified in Preview module settings (or Preview and Archive module).

For USB-cameras: choose your camera from the list. Select the required combination of image refresh rate (fps) and image resolution (set by the camera’s drivers). Below are the regular settings for image settings like brightness, contrast, sharpness, etc. that you can change with the slider. ‘Back to defaults’ will set the settings back to the camera’s initail settings.

For Internet cameras: you can specify the image refresh rate in the advanced settings menu.

For IP cameras:

  1. select your camera from the list of available (auto detected) cameras;
  2. if your camera is not on the list, choose the camera’s manufacturer and specify its IP, if needed along with access data (username and password);
  3. if your camera still doesn’t display image, check if it’s connected, then choose ‘Manual Setup’ and fill in the ‘Full URL’ field, and if needed access data (username and password) fields;
  4. you can also specify a URL for direct storing to the archive without re-encoding (for RTSP cameras);
  5. you can expand/minimize advanced settings by clicking on the text button below.

Advanced settings for IP cameras:

– Sound settings

  1. Sound URL field
  2. Sound quality (sampling frequency) settings

– Settings for PTZ cameras:

  1. HTTP port to control PTZ functions of the camera (if the port differs from a standard port)
  2. Turning on/off horizontal or vertical inversion of PTZ
  3. Available PTZ options – if the automatically detected PTZ API doesn’t work for you, try selecting other PTZ presets from this combobox.

For analogue cameras:

Xeoma supports video capture cards that use DirectShow/WDM drivers and have 1 chip per channel. Such capture cards are seen in Windows as a number of separate devices (Device #1, Device #2, etc.) Xeoma will detect them as a number of USB webcams. Xeoma works with default settings, so if something is not working the way you wanted, you need to change the defaults on your card/analogue camera.

Xeoma also works with DVRs that have direct URLs for JPEG, MJPEG, WEBM (VP8 and VP9) or MPEG-4 streams for each channel and stream video over http or rtsp protocols. Xeoma “sees” such DVRs as a number of separate IP cameras. Sometimes these cameras are found automatically with simple search or search by IP/password (both launched in ‘+’ menu in the panel below). Sometimes, however, in order to connect DVR to Xeoma, you need to know the exact URLs for video streams of this DVR (http/rtsp for MJPEG/H264). It can be found in the device documentation, or its web admin interface, or you can contact the manufacturer of this DVR and ask them directly.

Click on Microphone icon to enter its settings and choose your device from the list


This module allows you to select the sound source – microphone. Select the microphone from the list of available audio devices. Whether you need this module in your chain, or not, depends on the type of camera – usually USB cameras require the Microphone module to work with sound, while IP cameras usually have the sound stream embedded and don’t need a Microphone module. Note: microphone is not a video source and doesn’t require additional licenses.

Use this module to monitor your staff activity.

Xeoma file reading module

File reading

This module allows you to select JPEG or MJPEG files as image source. Name of the camera can be specified in Preview module settings (or Preview and Archive module). Specify the full path to JPEG or MJPEG file you want to use as a source.
Use this module to broadcast specialized advertisements in JPEG or MJPEG format, especially usefull for resellers to promote the program.

Xeoma screen capture module

Screen capture

This module allows you to record your screen(s) (only on Windows). As usual, you can give name to this source’s preview box in Preview module settings (or Preview and Archive module). In this module’s settings you can specify the frequency of shots and size relative to the original image size.

Used with motion detector, it can help you start recording as soon as there’s activity on the computer.

Use this module to monitor what your children or staff are doing on their computers.

Another Xeoma module, usually used in pair with the Web server module

Another Xeoma

The module allows you to receive audio / video stream that is transmitted by other copies of Xeoma over the network. To do this, specify the URL of the audio / video stream and access parameters, in ‘Another Xeoma’ settings. Name of the camera can be specified in Preview module settings (or Preview and Archive module). You can set image resolution and frame rate in the advanced settings.

More about Another Xeoma and Web Server connection

FTP receiver module helps you get image from camera in most challenging environment, even if has no IP address

FTP receiver

The module allows you to use an FTP server as a source or, simply put, stream your camera image to Xeoma via FTP. It’s convenient when you don’t want or cannot perform port-forwarding on your router at the place where camera is located, or when there’s no IP address that can be assigned to the camera (like when the camera is connected via the mobile Internet) thus no program can find it. Configure your camera so that it passes the image (JPEG) on to the FTP server via the IP address of your computer using the specified port, user name and password. You can assign this module a preview name in Preview module settings (or Preview and Archive module).

Detailed photo instruction on how to set this module up can be found here.

This module allows you to get video and audio over HTTP from another Xeoma server that has only a dynamic IP address

HTTP receiver

This module allows you to get video and audio from another Xeoma server. Enter port and path to access this Xeoma from other Xeoma copies.

To restrict access to this address, enter username and password. In the corresponding field you’ll see the address for access to video or images.

3.2. Destination settings

Alarm sound module will play a sound on the server

Alarm sound

This module allows the server to play the specified sound at image received. In Xeoma Pro the sound can be played on clients too. If you want the signal to be triggered when motion is detected, plug it after a motion detector. You can select a wav sound file from the list or specify the path to the file manually, specify the file playback interval (sound will be played with each incoming frame, but not more than the specified interval) and duration of play. Click ‘Test’ for verification of the settings.

Use this module to signal the guards that something is happening on the screen.

With this module, you can automatically launch a third-party application or script

Application runner

This module allows you to run the specified application. If you want the application runner to be triggered by detected motion, connect it after motion detector module. Specify the path to the program to run with the use of macros and interval (program will be run with each incoming frame, but not more than the specified interval). Click ‘Test’ for verification of the settings.
Use this module to run a third party application or script.

Upon receiving the signal, this module will automatically maximize Xeoma Client window if it was minimized (only on the Client side)

Pop-up window (in Client)

This module allows you to automatically restore Xeoma from the minimized state at received incoming frames.

Also acts as push notifications on Android client.

With this module, you can send automated SMS (text messages) with help of a GSM modem or service providers

Sms Sending

This module allows to set up the automated sending of text messages (SMS) to a cell phone. You can set the interval between messages sending, and use macros to specify which camera and at what time detected motion. Select one of the options to send messages: with use of or sites, or using a GSM modem.

If you choose, you will need to specify your login, password and API ID (or just API ID) received after registration on the site. In modem option, you only need to connect the modem. After that, enter phone number(s) to send messages to, message text and select sending frequency.

API ID (Api key) – This key is available on the site that you use.

In you need to go to the tab ‘Manage my product’, click ‘My Connections’ and select ‘XML’ in the drop down box ‘Add connection’, then click ‘Submit and Get API ID’ – your API ID will appear in the window.

In you will need only login and password you got during the registration. You can also get 5 free text messages for testing with this service.

Sender’s number or name: you can use any name, but you must be registered on the site, with which you are sending text messages. If you get an error after the test that warns you about the wrong sender, the name you specified is incorrect, or not consistent with the administration of the site. If you leave the sender field empty, number that you specified during registration will be used.

Recipients’ numbers: SMS can be sent to multiple numbers at the same time, just separate numbers by ‘;’ ‘,’ or space.

For more information, go to the site you are registered with.

After the module is set up, click ‘Test’ to test its work.

Use this module to send messages about emergency situations. Problems detector module plus sms sending can notify you about:
– RAM is running out;
– Disk space is running out;
– The server was restarted incorrectly;
– No audio stream;
– Picture became too dark;
– Picture became too bright;
– Camera turned or obscured;
– The server was restarted correctly;
– No access to database;
– Database errors;
– Camera image is missing or isn’t changing;
– The network resource is not available anymore.

With this module, you can send automated Emails with attached pictures or videos

Sending Email

This module allows you to set up automated e-mailing at event detection. You can set the interval between emails, and attach incoming video and images (specify maximum count of attached images, time between pictures captures, videos’ fps and duration, and maximum size of messages). Also use macros to work with the problems detector and motion detectors. Pictures that can be attached – up to is how many pictures you can have attached to each email message according to Max message size set up with the slider below.

For example, you don’t want each message to be bigger than 2 Mb. It means that each message can have up to 26 pictures (this number can vary depending on camera’s resolution & picture size – which in most cases can be configured in web admin of your camera).

Select your mail server from the list or specify your own. If your mail server is not listed, you can specify the settings manually. Enter SMTP-server address and port as well as the method for encrypting data. Enter username and password of your email. In ‘Recipient’ line specify recipient’s email (or emails separating them with space, comma or semicolon). You can send email to multiple addresses. Enter subject and message text (optional). Click ‘Test’ for verification of the settings.

Please note that if you connect email sending module after motion detector, it will certainly affect the result. For example, if you have a 1 minute interval between messages and set up the email sending module to attach 2 pictures to each message. This means that every 30 seconds the program will check motion detector if there is motion at THAT moment. If there is, the picture gets stored in temporary memory waiting for being sent. If not – it doesn’t. In the next 30 seconds the program checks again, to get another picture if there is motion this time. And at that instant it sends an email with all pictures that it stored during that time interval (during 1 minute in our example). If there are no pictures, no message is sent.

If you want to be able to view the attached videos on your mobile device, MP4 format of videos should probably be your choice for it is supported by most mobile devices.

Use this module to send emails about emergency situations. Problems detector module plus email sending can notify you about:
– RAM is running out;
– Disk space is running out;
– The server was restarted incorrectly;
– No audio stream;
– Picture became too dark;
– Picture became too bright;
– Camera turned or obscured;
– The server was restarted correctly;
– No access to database;
– Database errors;
– Camera image is missing or isn’t changing;
– The network resource is not available anymore.

This module allows you to save incoming frames in specified file using Xeoma video surveillance software

Save to file

This module allows you to save incoming frames in specified file. You can specify the path to store videos and images, name to be assigned to stored files and use macros therefor. For example, you want JPEG images to be saved on the C drive in the Public folder and subfolder Pictures with a core name img and added current date and time. Specify the full path to the file C:\Users\Public\Pictures\img_% ym-d_h-is%. jpg. You can specify the interval between frames saving.

Use this module to save different files to different discs and folders.

This module allows you to upload an image or video file to a specified FTP-server using Xeoma video surveillance software

FTP upload

This module allows you to upload an image or video file to a specified FTP (SFTP)-server. Specify server address, port, username and password and check the box for secure connection. Specify the path to the saved file using the offered macros. You can specify the interval and type of stored data. Click ‘Test’ for verification of the settings.

This module allows to send reports with recognized license plates to an FTP server as a TAR archive that includes a JPEG image and a text report

ANPR Sender to FTP

This module allows to send data from the Xeoma’s ANPR module to an FTP server. Data is sent as a tar archive that includes a JPEG image of the recognized license plate, and a text report. A text report can have information about this recognized plate number, its coordinates on the image, size of the image, and a timestamp. In corresponding fields please enter the server’s address, port and username of the FTP server. Using the available macros, set a path to the file to save, as well as the path to the report file example that should be sent to the server.

This module allows to generate and send HTTP requests using Xeoma video surveillance software

HTTP request sender

This module allows to generate and send HTTP requests. If you want to send motion-triggered requests, connect the module after the motion detector module. Check the box ‘Show all parameters’ to set request parameters. Use the {ID} macro while setting up parameters for module’s unique identificator. The resulting URL will be shown in ‘Resulting URL’ field.

Use this module to send HTTP request to a third party devices, for example to open the gate and etc.

See 3.14. HTTP request sender (integration with home automation)

This module allows to upload video and audio over HTTP to another Xeoma server

HTTP upload to other Xeoma

This module can transmit video and audio over the net to other copies of Xeoma. Enter port and path on a remote Xeoma server, to transmit audio and video to.

To restrict access on a remote server, enter username and password. In the corresponding field you will see the address that will be used to access video stream or images.

More in 3.15. HTTP Upload to Other Xeoma

You can transmit data over the network using rtsp broadcasting

RTSP Broadcasting

This module allows to transmit data over the network using rtsp broadcasting. Additional software ffmpeg is required for broadcasting in libx264. You can download it from our site or use your ffmpeg. By downloading ffmpeg from our site you accept terms of the GNU GPLv2+ license agreement. Additional software is not required for broadcasting in mjpeg or mpeg4, as it can use the embedded ffmpeg. You can also select the desired compression level for the resulting stream.

Use this module to emulate rtsp ip camera.

More in 3.16. RTSP Broadcasting

Multi-functional module, that can be used in Xeoma video surveillance software to reach different goals

Web server

More about web server here

Use this module to broadcast your camera on your site or to view your camera via browser.

This module allows you to store the incoming image to the archive for a later view and displays the image on the screen in Xeoma video surveillance software.


More about archive here

Use special option in this module to synchronize with SD cards.

3.3. Filters

Using this module in Xeoma video surveillance software you can filter frames in low (insufficient) light

Day Detector

This module automatically filters frames in low (insufficient) light. To disable the module, uncheck box in upper right corner. In this case all following modules will not receive image. If you want to disable the filter without disabling the whole chain, check ‘Hidden’ – the icon will have different color of the filter circuit then. To enable the module back, check the box.

Use this module if you want automatically record video at daytime.

Using this module in Xeoma video surveillance software you can set motion detection in a given area

Motion detector

More about motion detector here
Use this module to detect motion, absence of motion, to ignore cloud or shade movement. Combine this module with PTZ tracking to monitor moving objects. All these functions will help you to control your staff.

This module will be triggered when some object is in this zone the specified time.

Loitering Detector

This module will be triggered when some object is in this zone the specified time. Connect this module in a chain after the “Object Detector” module where you selected the detection zone, object size, etc. required settings. In Loitering Detector’s settings set triggered time.

Using this module in Xeoma video surveillance software you can set object detection in a given area

Object Detector

It’s an enhanced version of Motion Detector that will allow to follow objects around even if they are not moving, and distinguish separate objects from each other.

See 3.12. Object Detector

Using this module in Xeoma video surveillance software you can spot unattended items in a given area

Detector of Abandoned Objects

This module will determine if an object in camera’s field of view is left unattended for an unacceptable amount of time, and trigger pre-set reactions. To avoid false alarms, please set what minimal and maximum size can am object have to trigger the alarm. For example, it will allow the module to react to unattended luggage rather than people moving around the railway station.

Set up the zone of detection of any shape of size. Use brush to paint red an area or areas to be monitored. Leave transparent spots where objects will not be monitored. You can change brush size for filling or clearing zone of monitoring. In the ‘Auto’ mode automatically brush effect – filling or clearing – is selected automatically depending on the area under the brush.

You can set time after which an object is considered abandoned. For example, if you set 10 seconds, only items that were unattended for more than 10 seconds, will trigger the reaction(s).

“Continuous work to enable search by motion in the archive” option, if ticked, the Detector will be switched to the “Skipping” state (when archive is connected after the Detector, it will conduct continuous recording). The option is used when continuous recording is required but search of objects is also needed in the archive. This way the Detector in Xeoma security camera software will only collect data about unattended (abandoned) objects.

Using this module in Xeoma video surveillance software you can set the days and time when connected to scheduler modules will work


This module allows you to set the days and time when connected to scheduler modules will work. You can specify days and time of work, for example from 5 pm to 11:59 pm on weekdays (that is till 11:59:59 because the minute gets recorded to the end). You can also specify time for work days and set round-the-clock work on weekends. To disable the module, uncheck box in upper right corner. In this case all following modules will not receive image. If you want to disable the filter without disabling the whole chain, check ‘Hidden’ – the icon will have different color of the filter circuit then. To enable the module back, check the box.

Use this module to detect on schedule.

You can embed waterstamp of time and date, GPS coordinates or custom text into image from the camera using Marking module in Xeoma video surveillance software


This module helps embed waterstamp of time and date, GPS coordinates, custom text or image overlay into image from the camera or other video source. You can choose marking position, date/time format and set up desired font size.

See more about Marking here

Smoke Detector in Xeoma video surveillance software

Smoke Detector

This module detects smoke in the monitored area. Use sensitivity threshold scale to determine what level of smoke in the zone should trigger reactions. The 0 level denotes that any level of fogginess in the picture will be considered smoke. 100 means high sensitivity level, at this level only thick fogginess in the picture will trigger the alarm or any other action you specified.

Set up a zone or zones of detection of any shape of size. Use red color to define the area to be monitored for smoke. Leave transparent spots that shouldn’t be monitored for smoke. You can change brush size for filling or clearing zone of monitoring. In the ‘Auto’ mode the brush effect – filling or clearing – is selected automatically depending on the area under the brush.

To avoid false alarms use the “Ignore motion shorter than” option where you should set a specific time in seconds before fogginess is considered a smoke and triggers pre-set reactions.

“Continuous work to enable search in the archive”: if ticked, the Smoke Detector will be switched to the “Skipping” state (for example, if an archive is connected after the motion detector, it will conduct continuous recording). The option is used when continuous recording is required but so is all data about “smoke” events. With this option on, the Smoke Detector in Xeoma security camera software will only collect data about “smoke events”.

See 3.11. Smoke Detector

Using this module in Xeoma video surveillance software allows to filter out image if the sound threshold is not exceeded

Sound detector

This module allows to analyze audio streams and react to sounds that exceed a certain limit. If your camera has a built-in microphone, you can connect the detector directly to the “Universal camera”. If the microphone is installed separately, make sure to add the module “Microphone” and connect it to the detector.
The settings for the module include:
Continuous recording (search will be accessible through the menu of archive) – check this box, if you want the detector to record footage 24/7 and then review the archive for the results; with this you can go Archive menu → Show sound data from Sound Detector, Xeoma will mark the detected sounds with orange on the timeline.

Post-record – regulate how much footage you need to keep in the archive after the detector triggers.

Sound threshold, % – set the detector’s sensitivity, so that it triggers to specific sounds (e.g. loud crash of a window or a gunshot), ignoring the unnecessary noises (e.g. cars honking). N.B. The higher it goes, the more sounds will be ignored.

Current sound level, % – check what the detector can hear in real time; this is useful for initial setup when you need to adjust the threshold.

Using this module in Xeoma video surveillance software allows to detect human faces

Face detector

The module is meant for detection of human faces in the cameras’ field of view. It can be used to detect excessive presence of people where they are not supposed to be or, in reverse, detect if there are insufficient staff.

Face Recognition will help look for certain people in live view and archive. For face recognition to work, a training is required beforehand to add faces of people that will be recognized later on. You can add faces in two ways: in real time using image from camera or during playback of the archive. See ‘Help on faces recognition in Face Detector’s settings for more information.

In combination with the ‘Privacy Masking’ module, can dynamically blur people faces in camera’s view.

See more about Face Detector

Using this filter in Xeoma video surveillance software you will be notified whenever emergency situations arise

Problems Detector

Built-in tools for system self-test. This filter module notifies you whenever emergency situations arise: no image from camera, no sound, defocusing, image degradation detection, camera was turned, image is too dark, image is too bright, no free disk space left, RAM is running out or server is restarted. Archive’s timescale marks the intervals where a problem was detected or was no recording because of camera issues (camera “freezes”, etc.).

Use this module with sms or email sending modules to inform you about emergency situations. Problems detector module plus sms/email sending can notify you about:
– RAM is running out;
– Disk space is running out;
– The server was restarted incorrectly;
– No audio stream;
– Picture became too dark;
– Picture became too bright;
– Camera turned or obscured;
– The server was restarted correctly;
– No access to database;
– Database errors;
– Camera image is missing or isn’t changing;
– The network resource is not available anymore.

Also saves log files about arisen problems in CSV reports to disk. To enable logs, tick the “Save csv reports” box. The log file can then be retrieved from the Xeoma directory in /Xeoma/Logs/ProblemsDetector.log.

This module allows to reduce the size of incoming image using Xeoma video surveillance software

Image Resize

The Image Resize module allows to reduce the size of the incoming image.

Adjust the size of the result image in % of original’s size in the settings of the module.

This module allows to rotate and flip camera image in Xeoma video surveillance software

Image Rotate

The Image Rotate module allows to rotate and flip camera image.

Use slider to set the rotation angle. Untick the “90-degree pitch (rounded down)” option to use arbitrary rotation angle. Otherwise, when ticked, it will round down the value to 0, 90 or 180.

This module allows to crop camera image in Xeoma video surveillance software

Image Crop

The Image Crop module allows to dynamically crop the camera image. Paint the zone you want to keep in red in the module’s settings dialog. Unmarked pieces will be cropped.

This module allows automatic PTZ tracking of moving objects

PTZ tracking

This module allows to automatically move a PTZ camera in the direction of moving objects. For PTZ Tracking to work, the camera must support PTZ functions and the module should be connected in the chain after a Motion Detector module. You can set up sensitivity, detection method and other settings in ‘Motion detector’ module’s settings. This way ‘PTZ Tracking’ will be working accordingly.

You can set the speed of reaction to moving objects (the camera will move if the motion lasts longer than the selected length); time to return to the start position and wait until the next tracking; move and zoom limits for the camera; as well as step size for camera movement and zoom (affects speed/rotation angle).

This module automatically recognizes cars' license plates appearing in the field of view of the camera, and records them to a license plates database.

Automatic Number Plate Recognition (ANPR)

More about ANPR here

Switch streams with this module using Xeoma video surveillance software

Fisheye Dewarping

This module allows to dewarp image from fisheye cameras and get it in the regular format.

The Visitors Counter module allows to count how many visitors were detected in the field of view of the camera, and show this information on preview.

Visitors Counter

The Visitors Counter module allows to count how many visitors were detected in the field of view of the camera, and show this information on preview. For example, paint a line in Motion Detector’s settings of the monitored zone. Connect Visitors Counter after the detector. Everyone crossing this line will be counted as a visitor. You can use either of the two counting methods: 1-directional count is meant for when visitors only move in 1 direction – either enter or leave. With this method, each crossing of the line will add 1 to the counter. 2-directional counter should be used in environments where visitors can be both entering and leaving the place. With this method, every 2nd crossing of the line will be counted as 1 visitor. ‘Reset the counter every’ defines how often the counting will be started anew (for example, at the beginning of the day or a shift). You can also save reports in a CSV file.

Use this module to monitor your staff.

See more about Visitors Counter

The Cross-line Detector module is similar to Visitors Counter except it can also detect direction of movement

Cross-Line Detector

This module lets you draw a virtual line and is triggered if the drawn line is crossed. The modules is capable of detecting the direction of movement and counting how many times the line was crossed in certain direction.

Connect this module in a chain after the “Object Detector” module where you selected the detection zone, object size, etc. required settings. In Cross-line Detector’s settings start dragging a line in the camera preview box. Ends of the line will have green dots, click on one of these and drag the line to change its position. The line will also have a red triangle showing the direction the moving object should be moving in to trigger the alarm. Click “Toggle direction” to change this direction.

If you have several lines, you can select the needed one with the “Select line” dropdown list. Tick “Show count of visitors” to make Xeoma count how many times the lines were crossed in the chosen direction.

This module helps blur areas in view of camera

Privacy Masking

Privacy Masking module that allows to dynamically blur areas in view of camera that you are not allowed to record.

Use this module to hide private areas on your recordings. Can be used in combination with detector type filters to dynamically blur detected objects like faces, etc.

This module allows for quick turning on/off of the modules in the chain

Button Switcher

This module allows for quick turning on/off of the modules in the chain connected after this module with the help of the button in the lower panel or option in Main menu. Add the Button Switcher module into the chain and click the lower panel button or option in the Main Menu whenever you need, for example, to start or stop recording fast. You can set module’s name (ID). All modules with the same ID will be affected the same way (turned off or on).

Use this module to quickly start/stop recording.

This module helps combine output from two video sources into one in Xeoma video surveillance software


The Unitor module helps combine output from two video sources into one. Connect two cameras or other video sources to the Unitor and you will have a merged image as the result. Additionally, you can use 1 audio source.

You can select cameras’ position in relation to each other (horizontal or vertical combination), as well as change their order.

Please note that Unitor will give you only 1 audio stream in the result.

Use this module to combine two video streams in one.

For more information on this module, please read the Unitor article or view the Unitor video.

Switch streams with this module using Xeoma video surveillance software

Relay switch

This module is a streams switcher. When it receives a signal from a managing module, it closes the circuit and lets through the stream from the managed (secondary) chain.

For more information on this module and its settings see 3.9. Relay Switch.

Using this module in Xeoma video surveillance software you can set a logical condition for triggerring


This module is a kind of relay switch that works with the preset logical condition you choose. Another name for the module is Denial as, unlike other filters in Xeoma, it basically checks if the preceding modules (filters) are NOT triggered.

Connect Condition after detectors and before destination modules.
Choose type of work:
Logical AND – the module will push video on to following modules when ALL preceding modules are NOT triggered at the moment.
Logical OR – the module will push video on to following modules when at least ONE of the preceding modules is NOT triggered at the moment.
If you’d like to cancel this reverse for a module (i.e. make Condition work when the module is “triggered” rather than “NOT triggered”), tick a module’s name in the list (only modules connected to Condition are listed). Please pay attention that its mechanism of work is reverse to what you’d have if you connected modules without it.

Using this module in Xeoma video surveillance software you can switch on/off all following modules (the whole chain connected after the HTTP marking) and save meta information upon receiving an http-request

HTTP marking

This module is a combination of “HTTP switcher” and “Marking” modules. This module allows to switch on/off all following modules (the whole chain connected after the HTTP marking) and save meta information upon receiving an http-request. It works like a circuit breaker/closer and can receive commands to either break the circuit (with the URL for switching off) or close it (with the URL for switching on). It saves meta information about the command and the identifier (ID). With this ID, you can find an entry in the web archive and view it (Web Server module required in a scheme then). Upon receiving a command to continue, the module keeps the circuit closed. If a command to continue or switch off has not been received in a long time, the circuit will be broken automatically.

For example, you can connect HTTP marking in a chain before the Archive module, and send the switching off URL with the identifier (example: “id=123”). To continue recording, send the command to continue. To resume recording, send the switching on URL request.

Requests can be sent through home automation systems or simply via a web browser.

This module allows to switch on/off all following modules (the whole chain connected after the HTTP switcher) upon receiving an http-request in Xeoma video surveillance software

HTTP switcher

This module allows to switch on/off all following modules (the whole chain connected after the HTTP switcher) upon receiving an http-request. It works like a circuit breaker/closer and can receive commands to either break the circuit (with the URL for switching off) or close it (with the URL for switching on).

URL-path for switching off: send this http request to make HTTP switcher block video stream for the set period of time (or permanently, until the switching on URL is sent).

URL-path for switching on: send this URL to make HTTP switcher stop blocking the video stream (close the circuit). If there is a timeout specified, when it’s finished, the module will resume blocking the video stream.

For example, you can connect this module in a chain before the Archive module, and send the switching off URL when you need to stop recording. To resume recording, send the switching on URL request. Requests can be sent through home automation systems or simply via a web browser.

Use {ID} macro to get a unique name for this module. If macro is not used and the path is the same for all HTTP senders, upon receiving a request all modules of this kind will be switched on/off.

Use “timeout_seconds” parameter to set or change time of work (for example:

Use “show_status” parameter to get the module’s current state information (for example:

3.4. Motion detector

This module is very important in security camera software, as it allows you to set motion detection in the given area, motion cessation, penetration into the forbidden zone, detect staying in the zone, control the staff activity, distinguish between moving objects and the background.

Based on computer vision, this module detects pixel changing in the video stream. Fixing events in a searchable log. Integral search according to metadata and information from all systems.

Use sensitivity level scale to specify what data will be saved to archive. The 0 level denotes that the system will be very sensitive to any objects of any speed or size. 100 means high sensitivity level, at this level only major objects with unquestionable motion will trigger the alarm or any other action your specified. The scale of current sensitivity level lets you know what speed and rate of motion is needed to make your system react.

Masks: set up the zone of detection of any shape of size. Use red color to define the area where motion is to be monitored. Leave transparent spots where motion will be ignored. You can change brush size for filling or clearing zone of monitoring. In the ‘Auto’ mode automatically brush effect – filling or clearing – is selected automatically depending on the area under the brush. Only objects of bigger size than your ‘Object size’ will trigger the alarm, so please choose carefully.

The visualization of movement allows to trace the motion path of a moving object. So even if you weren’t there to catch the movement, you can always see where the moving object was coming from.

You can choose between two detection methods in Xeoma security camera software: by comparing adjacent frames (the so called frame differences method) or by comparing the accumulated background (the so called background subtraction method).

Additionally you can choose detection delay – motion lasting less than specified value (in seconds) will be ignored. Pre-record lets you store the events preceding the direct detection of movement to archive. Post-record option allows to save to archive frames after movement ended.

Settings can change the color they’re written in. If a setting is blocking video, it will be colored in yellow. If the setting starts to let the video through to following modules, it gets green.

With the “Detect only the absence of motion during” option you can make the motion detector work in reverse and detect only when motion in front of the camera stopped, for example, when counters or moving parts of equipment are being monitored. Use the slider to set time – if motion will be absent for more than this value, the following modules will be triggered.

“Continuous work to enable search by motion in the archive”: if ticked, the motion detector will be switched to the “Skipping” state (when archive is connected after the motion detector, it will conduct continuous recording). The option is used when continuous recording is required but search by motion is needed in the archive. This way the motion detector in Xeoma security camera software will only collect data about motion events.

For troubleshooting false positives read also: False Alarms Issues in CCTV Software Xeoma

3.5. Archive

Archive settings and saving

The “Preview and Archive” module allows you to store the incoming image to the archive for a later view and displays the image on the screen. Like Preview module, it allows you to view current image in real time mode. Interactive search in the archive, according to the given parameters. When the cursor is on the corresponding preview box, it gets a blue frame around it.

In its settings, you can give your camera a name to be displayed on main window in preview box for this camera (it will be used in Device List, eMap, and while assigning User access rights); and set a certain group or groups for this camera to belong to for further work with Device List. Also, in this module’s settings you can set storage time of records (meaning how long the records will be kept until they are over-written by more recent records); maximum archive size (the disc space that this camera take on your hard drive for archive); and frames saving frequency.

In the advanced settings (click to expand the advanced settings) you can reduce image resolution and quality of stored frames in % of the original (by default it’s the same as the original image); specify path to store archive files to, or set a global limitation (will be applied to all archives) of how much free space Xeoma should always leave free.

Note: thanks to loop recording, once the limit is exceeded Xeoma’s archive will start recording over oldest materials. You will never have to face the problem of the full disk or archive stopping recording if the place reserved for it comes to an end. But if the global disc limitation setting leaves Xeoma no place to store records to, it will not record. Under the path box there’s a Preview.Archive.{Number} name that will be useful should you decide to look for Xeoma records for this camera directly on disc.

Archive playback

All recordings from the camera(s) will be stored in default user catalog, unless you set another path, conveniently sorted in folders by date. Archive recordings can be watched in both online and offline mode. You can browse the archive, with Xeoma continuing to monitor and record.

Archive of Xeoma is equipped with a handy built-in media player. Timescale of the archive is adjustable (seconds to days) so you can easily and quickly find the required time period and begin playback from that point. Pull the timescale slider to the right or to the left to change timescale, or scroll your mouse wheel. Moreover, the Calendar lets you choose date and time for quick jump. Use arrows to navigate and choose the date and time. You can adjust the records playback speed, for example, to play fragments in the fast mode that are of little or no interest to you and focus on the parts worth more attention – pull the speed slider to the right or to the left to accelerate or slow down playback (by default set at usual speed). Pushing white arrows on the sides of timeline will make the slider bar jump to the next/previous event (if this is motion-triggered recording) or to the next/previous minute (if this is a continuous recording).

Archive interface of Xeoma Webcam Software

Archive player menu has Export, Start position, Delete and Search by motion options. Start position allows to set what part the archive will be opened at when you enter it next time – at the very first entry, at 5 minutes to end of the archive or at the moment where you left off (the latter being the default).

Export allows to save a certain extract from the archive in the format of your choice. This will come in handy if you usually store in MJPEG (.xem) and need to show an extract to the authorities and need it to be playable in most players. Or, you need to save just a screenshot from the archive. This all is done via the Export option. Click it once to get the white little triangles shown over the timeline. Move them to enframe the needed extract. Go to the menu and click Export once again. A prompt will be shown asking where to save this extract to and what format it should be converted to.

Even easier than that, to make a screenshot while viewing the Archive, simply click Screenshot in the Archive menu. After that you can Choose location for storing screenshots, which can be either Save on both client and server side or Save on client side only. To quickly access all the screenshots you have already made, select Open screenshots directory. Alternatively, you can either Print the screenshot or use Email to option to send it to a specified address.

With Delete option you can permanently delete fragments from the archive. It works similar to export – select the fragment with white markers and click the option again. Be careful, this action cannot be undone.

If a certain part of the footage is too small to discern, you can use digital zoom to take a better look. Choose Turn zoom mode on in the Archive menu. Now you can use the mouse-wheel to zoom in and out to where the cursor currently is. Also you can simply click the place you need enlarged. Finally, you can hold the left mouse button and drag a frame over an area to zoom in it.
If you want to expand your Archive using the footage that wasn’t recorded by Xeoma, you will need to make the Archive “see” the right files. To do that, choose Reindex the archive in the Archive menu.

Professional features in Archive (requires Pro license)

View of several archives simultaneously
If you’d like to view archived footage from several different cameras simultaneously, you can Select cameras to play in the Archive menu. After that click on the cameras you need to highlight them and press the Archive button. You will see all the cameras on screen and their footage will be marked with differently colored lines at the bottom.

Visualization of motion

Visualization of motion function doesn’t only detect moving objects, it also provides its tracing.

Visualization of motion in archive

Possibility to mark a piece of an archive as undeletable

Select a certain period of time in archive and mark it as a undeletable (Archive-> Main menu-> Delete interval-> Save selected interval as undeletable). This function allows you not to lose important segments of the recording and will reduce to the minimum the possibility of their removal by operators.

Possibility to mark a piece of an archive as undeletable

Search by motion

Search by motion function makes navigation in the Archive easier and more convenient. After you choose this option, select a rectangular area right over the camera view to search for motion events in. The found motion events will be showed on timeline in green color. You can have several search areas selected at the same time. To unselect an area, click inside it. To unselect all areas, use the option in the archive player menu.

Search by motion in archive

Search for recognized license plates
If you are using “ANPR” module, the Archive can help you view the results of its work. Select Search by license plates in the Archive menu to select any license number the camera detected. Xeoma will instantly jump to the right section of the Archive to show that particular vehicle. Alternatively, you can choose License plates log to access the full list of detected plates sorted by date (you can jump between different days using the calendar).

Addition of faces for recognition (training)
If you are using the module “Face Detector”, you can train Xeoma to recognize a certain face from the Archive. To do that, choose Select a face and add to the database in the Archive menu. You will need to input the person’s name and then drag a frame around their face.

NVR or DVR storages
Xeoma can work with surveillance video capture cards. It allows to utilize the existing analog cameras within IP network and perform central management over both analog and IP cameras.

Xeoma works both with NVR and DVR storages. There are some factors that affect the DVR / NVR storage capacity: video compression (codec), resolution, and motion detection recording, so Xeoma will easily help you to use the storage space effectively.

Using Xeoma you will be able to optimize the storage of almost any DVR or NVR.

Alternative option to reduce HDD space
Another option is to use Saving to File module to save videos with other codecs (for example, high compressive H.264) – this way videos won’t take so much space but will not be played with the built-in player of Xeoma either.

Or, if yours are rtsp (H264) cameras, you can use direct saving to archive without re-encoding.

You can estimate required disc space for archive storage with our minimum system requirements calculator.

3.6. Face Detector and Face Recognition

Among other features Xeoma enables your camera to detect people’s faces and recognize specific faces. It can also store a full list of people within its range. This comes especially useful in monitoring staff activity or creating automatic security systems preventing trespassing. It can be set to ignore low numbers of people or stop recording when a certain number is exceeded. Don’t want the camera to detect people that simply pass by? Want to make sure that Xeoma doesn’t mistake one person for another?

High recognition and identification accuracy is based on the use of several facial views for comparison. The system allows you to recognize the faces of people in motion.

Operational scheme : capture, recognition and saving biometric vectors of faces, when the person is in the frame, in the online mode. Combinations of proprietary algorithms and third-party algorithms are used.

You can do it via the module “Face Detector”. Put it in your chain and click it to access the settings. If you want it to simply detect all the faces that enter the camera’s field of view, choose “React to any faces” within “Reaction type” block. You can also set the minimum amount of faces for triggering with a slider (set it higher if you want to make sure that a certain place is never crowded). In detailed settings you can choose which area within the camera’s field of view is supposed to contain faces (much like “Motion Detector”). Also the range of face recognition can be altered, for example, if your camera is set in a narrow place, where people’s faces are always close to the camera, it is better to set the range to “Short” or “Medium”.

Face Recognition
If you need the camera to recognize a specific set of faces, Xeoma can be trained to do so. There are 2 ways to do it:

1) In “Face Detector” settings enter the person’s name (or any other ID) and click on “Train person recognition” when the face you need to save is within the camera’s field of view. Xeoma will add this face to the database and attach the name (or ID) to it.

2) If the person you want to add has already been recorded, you can access the archive and pick the right face from there. Click on the Archive button for the right camera, find the frame that contains the face you need (the bigger – the better) and go “Archive Menu” -> “Select a face and add to the database”. Now just type in the name and draw a square around the face. Done!

With a database for several faces you can now set “Face Detecor” to either react only to selected faces or to unknown or unselected faces. The latter one is useful for monitoring any unauthorized personnel. When you select either of these options, you will see your whole database below as a list of names (or ID) with boxes you can check or uncheck as you see fit. With this you can make Xeoma recognize only specific people and ignore the others or pay attention only to unknown persons.

Don’t forget to use the “Minimal recognition accuracy” slider. It allows you to adjust how close to the original the detected face should be. If you notice that your camera sometimes, for example, mistakes an unknown person for a listed person, set the slider higher.

Integration with automation systems

When a face is detected, Xeoma can send this information to automation systems with the “HTTP Request Sender” module. “PTZ Tracking” connected after the “Face Detector” will make your PTZ camera follow the person, and “Sound Alarm” will trigger the alarm.

3.7. Visitors Counter

“Visitors Counter” is a unique function that allows you to effectively analyze the footfall traffic for your shop, showroom or your office attendance. The modue allows to exclude the staff from the calculation data (when it is used together with the “Face recognition” module).

Start by inserting the module “Visitors Counter” after the “Motion Detector” in your chain.


Mark the entrance with a line (simply draw it with the brush tool), which visitors would have to cross in order to be counted.


You can adjust the module “Visitors Counter” in order to facilitate data collection. You can choose the counting method (1- or 2-directional) and the interval for the counter’s resetting. 1-directional method will count every single time the line is crossed (useful when people always move in the same direction). 2-directional method, on the other hand, only counts every second crossing of the line as 1 visitor (useful for keeping track of people exiting and entering through the same door).

Also you are free to save the data collected in a CSV report, which can show you what time the visitors entered or exited. This is especially useful for keeping statistical data and sending it to external software for detailed analysis.


To reach maximum efficiency in counting the visitors, we recommend installing the camera perpendicular to the floor, right over the entering or exiting people. This helps to avoid any false triggering of the counter due to image projection.

3.8. Marking module

If you have multiple cameras on a single server and, consequently, several video feeds on one screen, it is important to always keep track of every camera’s position, and date and time it shows. If you are a security guard, you need to know exactly where to go, when the camera detects something and there is precious little time to think.

Xeoma was made with this in mind. The module “Marking” is what serves all these functions. You simply add it to your chain (any position will do) and click it to access its settings.

First, you need to choose the “Type of marking” at the top of the window.

a) If you pick “Date and Time” you can also adjust the “Date/time format” you prefer in the drop-down menu below. The slider “Font size” is also worth paying attention to. One of the common problems for the new users is that they can’t see the marking on the main screen simply because it’s too small. Some cameras display date and time automatically, though.


b) If you pick “Custom text” you can input anything you want on display in the Text field below. One of the best ways to use it, is to indicate the place that the camera watches and its position on the video feed.


c) If you pick “GPS coordinates” you need to make sure that you have specialized GPS equipment connected both to your camera and to your machine. If it is connected properly, the video feed will now show the camera’s longitude and latitude, height and velocity (if any).


d) Picture-in-picture: If you pick “Image overlay” you can either input the full path to the image-file in the field “Path to the image to overlay” or click the button to the right and pick the file through explorer. Don’t forget to adjust “Scale (on sides)” and “Transparency” sliders to prevent the image from obstructing the view. For example, you can use this feature to put a map with the marked camera position on screen for easier navigation, or embed your logo to the camera video feed.


For all of the above you can pick the “Position” on screen (any of the 4 corners).

Do you need more than one marker on the same camera’s video feed? No problem! Simply put several “Marking” modules in your chain and set them to show what you require in different corners of the screen.


As you see, even with all the camera detectors, it is still very easy to put all the information you need right where it can be accessed with no difficulties whatsoever.

Marking in the archive

“Can I see my markings in the archive as well?” If you are using direct saving to the archive (the box “Enable H.264 recording to Archive without conversion” is CHECKED), then time and date will show up in the “Archive” as subtitles (very soon custom text will also be available). Otherwise, for .xem recordings, Marking of all types is available for the archive recordings.

3.9. Relay Switch

This module is a streams switcher. When it receives a signal from a managing module, it closes the circuit and lets through the stream from the managed (secondary) chain.

For example, connect two Universal cameras to the Relay Switch module. Put a Motion Detector after the first Universal camera but before the Relay Switch. This way, when motion is detected, the second camera will be turned on and start passing its video stream to the modules you connect after the Relay.

Depending on the selected mode of operation, the Relay Switch offers various types of behavior after the motion from the first camera is over.

“On as long as there’s signal” – the secondary chain will be turned on and working as long as the managing module keeps sending the signal, and turned off when it stops.

“On with the 1st signal, off with the 2nd” – the secondary chain will be turned on when the first signal comes, and turned off when the next signal comes.

“On just once, during the time selected below:” – the secondary chain will be turned on just one time when the signal comes, and turn off automatically after the time you specify below with the slider.

Relay in action

If you need to protect a certain spacious area (e.g. a warehouse) with only a couple of cameras, here is how to do it. You’ll need one camera with a narrow field of view and another one with a wider field of view. The first one should control only the entrance to the facility. The second one should be able to oversee most of the interior. The entrance, of course, needs to be under surveillance 24/7, however, the interior doesn’t have to be monitored unless the first camera detects something.

Relay Switch module in Xeoma is a streams switcher

Here the first camera is connected to the “Motion Detector” and records all motion using “Preview and archive” module. However, the “Motion Detector” is also connected to the “Relay Switch”. This module ensures that the second camera doesn’t record anything on its own.

Add two cameras and connect them to a Relay Switch module for an automated switch between these cameras in your video surveillance system

Now alter the “Relay Switch” settings like this:

Settings in your Relay Switch module are easy and aim to automate your video surveillance system to the maximum

With this, once the first camera detects motion at the door, the second camera begins continuous recording of the interior, so that you can keep an eye on whoever entered. When the first camera detects motion again (the person leaves), the second one stops recording. A great way to save both disk space and bandwidth without decreasing security.

If the second camera has PTZ-functions, you can make it “follow” the visitor. All the filters you want to append to the second camera can be put AFTER the “Relay Switch”. The chain should look something like this:

Automated switch to another camera in video surveillance system  with the Relay Switch module

This will provide decent security for a building for a very moderate price.


Privacy Masking module allows to dynamically blur the areas that you are not allowed to record. It will especially help if your camera’s view is catching private property of someone (your neighbors house, for example).

Combined with filter modules it can dynamically blur detected objects (for example, faces or license plates).

It can be used on its own for uninterrupted blurring of static objects (for example, neighbors’ windows). In this case, in the module’s settings you should untick the detector box and select the detection zone to blur.



Alternatively, you can connect the Privacy Masking after detectors – Motion Detector, ANPR, Face Detector depending on what you need to blur (tick the detector box and select the detection zone in the corresponding detector’s settings).

Masking will be applied to the camera image in real time and in recordings, also in browser interface (except when direct saving to archive is used any filters that modify the stream including Privacy Masking).

3.11.Smoke Detector

One of the new features of Xeoma is a “Smoke Detector”. With this you can be sure that you are the first to know if any fire breaks out. Let us look at the module’s functions.


Smoke detector cameras in Xeoma

If we enable Continuous operation, the module won’t prevent the stream from being recorded in the Archive. This will allow us to search for the detected smoke in the Archive later. The Sensitivity threshold helps to make sure that the detector is not triggered under normal circumstances (e.g. when somebody simply lights a match or a cigarette). However, if the place the camera monitors is supposed to be completely smoke-free, you can set the threshold very low. Sometimes there can be a momentary gust of smoke or steam that you don’t want to detect either. This is where the slider Ignore motion shorter than steps in. Set it to a couple of seconds to filter these out.

Here is a chain you can use in a warehouse:

Detecting the fires in warehouses

The Motion Detector puts all the movement it detects in the “Preview and Archive”. This includes all visitors and the smoke too. At the same time, the “Smoke Detector” informs the owner of any smoke via “SMS Sending” and trips an alarm (“Sound Alarm”).

Such smoke detector cameras ensure the earliest possible detection of the fires and, most importantly, safety for both you and your property.

3.12. Object Detector

Xeoma's object detection
The main principle behind this module is very simple: as long as it detects an object – it will skip the video to the next module in the chain. When there is no object on screen – the detector won’t skip anything. The devil, as usual, is in the details. To make sure that the “Object Detector” pays attention only to the objects you need, it requires some fine-tuning. First and foremost, you need to determine the size of the object(s). The sliders Minimum size of object and Maximum size of object will help you with that. Now mark the area containing the object(s) with a brush. To facilitate the whole process, just put the desirable object(s) somewhere where the video system can see them and fiddle with both sliders until the module consistently shows Skipping in the top right corner. Then let a person pass between the camera and the object(s). Did the Skipping sign turn into Not skipping during that? If so, then everything is set correctly. If not – try raising the Maximum size of object.

Now, how can we apply this? As previously has been mentioned, the vague name of this feature covers an impressive range of possibilities. Let’s take a few examples.

Store. How does one measure the popularity of a given item in a shop? The obvious answer is “by how often customers buy it”. But this would be a rather superficial, one-sided analysis. A more complete answer is “by how often it catches somebody’s eye”. This is where the “Object Detector” works its magic. Set the camera to view the item in question, make a simple chain of “Universal camera”“Object Detector”“Preview and Archive”. Now, in a few days, you can look at the Archive and check the gaps in the recording – these are periods when a customer took the item from its place for a closer look. The more of those – the better.

Warehouse. Stolen objects detection. Let’s say you have an item stored you don’t want moved or touched. Naturally, you want to make sure that the workers attending the warehouse follow this rule. Set the camera to view the item in question, make a simple chain of “Universal camera”“Object Detector”“Preview and Archive”. Now, if the archive is incomplete – you know exactly when the item was moved.

These are but a few examples of what object detection is capable of, teamed up with a decent video system and a flexible mind. VCA grows rapidly and Xeoma never falls behind.

3.13. HTTP Marking And Integration With POS:

You can add dynamic text overlay from your POS (point of sale) device on recorded files with Xeoma’s module HTTP Marking:

Work with POS-terminals, cash systems, cash machines (or any other source of data – ATM, scales, barcode reader, etc.). The cash management system is designed for trading enterprises. The system accepts text data, generates events, stores them in the archive with reference to the video recordings.

Text search in the archive by title, request (based on the receipt, on the number of goods in the receipt, on refunds, on the size of discounts, etc.) – allows you to identify thefts and other economic violations by staff or store visitors, as well as find operational errors and cash discipline violations. The module allows to display data in the camera’s overlay.

Your cashier register needs to send such information as:
Xeoma’s machine IP address and port
“id” = ID of operation or number of the check
“start” = start check and start recording
“stop” = finish check and stop recording
“continue” = if your cashier register is set to stop recording automatically after, say, 5 seconds yet check is taking more time this time, you can send this command to not finish the check yet.

So, here’s what you need to do in Xeoma:

1. Connect the HTTP Marking module to the chain after the needed module, usually simply after camera and before archive. For example:


2. No special setup is needed. Set your cashier register up in accordance with the information in HTTP Marking settings. Mostly it’s information on how to use this module and this field (not editable):


3. When event starts (for example, check begins) your cashier register will send command like

Where will be replaced with your Xeoma server machine’s IP address
10090 – with port you will use
id=4 with whatever ID your register sends
HttpMarking.60 with your HTTP Marking number is Xeoma (if you have several modules of this type, they will differ through this number)
cmd=stop – command
start – to start recording
continue – to continue recording (if auto-stop is enabled)
stop – to stop recording

You can test it without cashier register simply by sending the HTTP commands (start and stop) in a browser address bar like
and then

4: Search for needed episode the archive by ID.

Go to web interface with a link like
(where localhost can be replaced with your Xeoma server machine’s IP address)

Click Archive link (it only appears if you already have at least one video recording)


Choose a camera that you would like to view archive for, by clicking on its image:


You will see a search box to the right. Enter any of the used ID there and click the search button or hit Enter


You will see a list of events with this ID. Click on the needed to view it.


In order to start an event, you will need to put this URL in your browser’s address bar:


You should put your IP address instead of localhost (e.g. Now you can type in actual parameters (instead of param1, param2, etc.) and their values (instead of value1, value2, etc.). The separator is “|”, you can use any letters, e.g. Work Day Start, WORK DAY START, work day start or Work_day_start. You can send a command to multiple markers like this: HttpMarking.1|HttpMarking.2. The command should look something like this (all spaces will be autamically converted to %20):


To end an event, send this command to the right “HTTP Marker” (or several):

http_marking_ 2

With that, you can access the archive and start the Search by HTTP Marking. The dialogue window will ask you for the parameters’ values (or you can search for all the values simultaneously) and the interval within which to conduct a search. The timescale should look like this:


The green parts indicate the events the search has discovered, while the counter called Currently displayed shows you how many of those events were found and which of them you are currently viewing.

If there are multiple parameters, Xeoma will put them one under another, you can have as many as you’d like:


3.14.HTTP Request Sender (integration with home automation)

This module allows to generate and send HTTP requests. Integration with third-party solutions (from “smart home” to banking sector) via the accessible REST HTTP API and SDK, as well as with any external system that can run an executable file.

It will also perfectly work with the smart home systems or supplement your home security system. If you want to send motion-triggered requests, connect the module after the motion detector. The module will send HTTP request with configurable parameters to the specified address when it receives image. For example, when the motion is detected, the module will send HTTP request to the “HTTP switcher” module and it will enable other modules, for example:

The module will send HTTP request after motion is detected

Here we see that “HTTP Request Sender” sends requests to enable sound alarm and archive recording when motion is detected, and disables it when the motion ends. Please pay attention to the sensitivity level and the object size settings of the motion detector.

Let’s have more precise look at the “HTTP request sender” settings:

IP and port settings of HTTP request sender in Xeoma IP security cameras software

Enter the URL and port of the HTTP server in boxes marked with red.

So it will look like this:

IP and port settings of the HTTP request sender module

When we entered the URL and port of the HTTP server, it appeared in the Resulting URL.

In the detailed settings, set up the sending interval and time when you want the request to be sent.

Interval of how often to send HTTP request in HTTP request sender of Xeoma IP security cameras software

When you set up the HTTP Request Sender module properly and want to save changes, click on «OK». The module is set up easily and working with it is pretty simple since all the settings are comprised in one menu of Xeoma IP security cameras software.

3.15. HTTP upload to other Xeoma

The module’s functions are simple: send the image received over the chain of modules to the module “HTTP Receiver” wherever it is over http protocol. The settings for it look like this:


The Address is [receiver’s IP]/[module’s unique name]. It can look like this: or
The Port can be anything that is currently not occupied by some other process. By default it’s 10090.
Username and Password can be set to make sure that no one else can view that stream. However, it won’t be possible without using Xeoma and knowing both the IP and the module’s unique name, so those are optional.
What makes this particular pair of modules stand out is the ability to relay more than just the image – the sound is transferred as well. “HTTP upload to other Xeoma” looks for the machine with the designated IP, checks if it has the “HTTP Receiver” with the same unique name (and username/password if any) and sends the stream to it. This creates a secure transmission of both video and audio between 2 machines.
Among others, it is used in Xeoma’s new version (17.3.30) to enable the 1-click Cloud mode: modules “HTTP upload to other Xeoma” connect to all your local cameras while Xeoma Cloud creates “HTTP Receivers” with all the necessary information already inside.
It is possible to transfer streams from one Xeoma’s server to another using other methods. One of them is FTP. Connect “FTP Upload” to the camera and create a chain with “FTP Receiver” on the second machine. This won’t work as a solution for this situation, however, as the result will be only the visuals, no audio. FTP is capable of transferring sound only when the stream’s format is H.264, which is native to IP cameras only.
Another option is transfer through the web. Connect the “Web Server” to the camera, while using “Another Xeoma” on the second machine. This won’t fit our specific needs either for the same reason – plenty of video, no audio.

However, these examples work only within the same local network. And what if the two computers are in different blocks or even cities? In that case, the first computer requires an external static IP address. Then you can put the second computer’s public IP in the “HTTP upload to other Xeoma”.

Another part of our example was secrecy: Xeoma’s work on the main computer should be hidden from the operator. This is easily accomplished by Xeoma’s Hidden mode – one of the installation modes. It will keep Xeoma working on that machine in foreground without alerting the operator while still sending video and audio from the camera on the other computer. The principles of remote software are followed fully.

To sum up, the solution looks like this:

  1. Launch Xeoma on the first computer and add “HTTP upload to other Xeoma” to the chain for the USB-camera.
  2. http2

  3. Access its settings and indicate the second computer’s IP along with the name for the module and username/password if necessary.
  4. http3

  5. This concludes the work on that computer, we can close Xeoma’s window here. Now launch Xeoma on the second computer and make a chain with the “HTTP Receiver”.
  6. http5

  7. Access its settings and indicate the unique name and username/password.
  8. http6

3.16. RTSP Broadcasting

Enter Xeoma’s “RTSP Broadcasting” module – it allows to convert any stream into RTSP (including H.264), be it analog, USB or IP camera. First of all, let’s add it to the chain:

Simple chain with RTSP Broadcasting

The broadcast is almost ready to start, now to configure the module:

Settings for the module

If we use mpeg4 or mjpeg, everything is ready – copy-paste the path (sometimes it will include the port: rtsp://localhost:30001/RtspTranslator.10) to a “Universal camera” on another Xeoma and swap “localhost” for the first machine’s IP – you are ready to broadcast now:

Data transmission in action

If the second machine is located within a different network, the first one will require a static external IP (or its alternatives) with the right port forwarded (if no port is present in the path, forward 554 – this is the default RTSP-port).

However, both mpeg4 and mjpeg are quite “heavy” for the network. If you’d like to stream in H.264 and reduce the network load, choose libx264 as Encoder type. You will also need a specific version of ffmpeg for this to work properly, downloadable here:
Please note that this option is unavailable for Mac OS, as there are no ffmpeg versions for it. Indicate the path to that file on your machine:

H.264 in RTSP broadcasting

To minimize the bitrate choose High compression rate. As a result, you will get a compressed broadcast now with a significantly lowered bitrate without losing the quality.

This method does have a downside – compressing and encoding a stream is a task meant for the CPU, one that has to be performed continuously. As such, the server’s CPU load is going to rise the higher the compression.
This showcases the underlying choice a video surveillance administrator needs to make: CPU load or network load? This in turn boils down to: powerful server or powerful network? With only a few cameras there is little to consider, as even ancient technology will be able to handle that much, but the higher grows the scale (50-80 cameras per server) the more substantial become the requirements. The most common solution to this is, naturally, the middle ground: MJPEG stream for the preview and H.264 stream for the archive – this way the server won’t have to decode the image in real time, while the network will hold only 1 unencoded stream per camera.


4.1. Xeoma Client-Server Architecture

Xeoma is based on Client-Server architecture. It means that there are 2 parts of Xeoma – Xeoma Server and Xeoma Client – that build its architecture. Server is processing cameras and other sources and basically does all the automated work while Client is used for viewing and interacting with server. Client can be on the same or on a remote machine, including mobile phones.

When you first download Xeoma, you get it in an executable file form. When you run Xeoma IP camera software with this launcher, you run both Server part and Client part. Server is working in background and Client is what you see as main Xeoma window.

Connection dialog of Xeoma IP camera software demonstrates its client-server connection

Later on, when you use remote access, you will use the benefits of this client-server architecture to connect with the client part on one computer to the server part on another (you can connect multiple clients to the same server). It’s done via Main menu -> Remote access -> Connect to Connection dialog, where you need to replace ‘local’ IP address (address of the computer you run Xeoma on) with ‘remote’ IP address or Repeater location, see remote access info.

No matter in what mode you use your Xeoma, it can work either with or without being installed on your PC. The difference is that if you need Xeoma to start automatically at your PC’s every restart, you need to set it to autostart – either server alone or with client part. To do that, just check boxes in installation menu.

Licenses are only for the server part. This is a great news for those who are planning to use remote access feature – no matter how many clients connect to the server, you only buy license for the server. Check the most economical offers for Xeoma licenses at our purchase page.

4.2. Program installation

Xeoma doesn’t require installation and can start working right after being downloaded. You may want to install Xeoma to make it start with your OS automatically.

Launcher for Xeoma IP camera software under Windows

Please note: Xeoma doesn’t install anything without user’s consent. Installation is user-definable.

Xeoma software installation

Go to Main Menu -> Install -> Install. You will get a prompt asking what type of installation you prefer and what folder would you like to choose for the software installation.

Autorun the server: Xeoma Server will start automatically with your OS’s each start. This is a good thing for example when you need server to process cameras all the time while you only will connect to it with Xeoma Client from time to time. To do that, launch the created Xeoma shortcut on your desktop.

Autorun the client: Xeoma Client (visual part) will be started automatically with your OS’s each start, for example it can be a good idea if you have server somewhere else and would like to connect to it automatically remotely.

Note: ‘Hidden mode’ and ‘Client autostart’ are mutually excluding options because when you need stealth surveillance you wouldn’t want Client part to open up automatically at each PC’s start, completely ruining all of the conspiracy you’ve created, would you? Then choose one – either client autostart or hidden mode, or none – if you don’t need it all (for example, if you are not going to work with cameras or recording on this PC like when you are broadcasting some footage continuously to a site or FTP server). If you choose Autorun to server and Hidden Mode, Xeoma will work in stealth mode. Launcher for Xeoma will not be created on desktop (and if it was previously, it will be removed). Xeoma Server will start automatically every time OS is started but will not be shown in running processes.

When you ticked desired installation boxes and clicked OK button, the part or parts you chose will be installed on your local PC and restarted. Please pay attention: your settings will not be saved if you are using Xeoma in trial mode (for more on Xeoma modes and their limitations, please see here).

Important: installed server works as service. It can be stopped in Services folder of your task manager, or uninstalled (and thus stopped) with a client.

Below the software installation options there is your password for remote access displayed in the box (non-editable). Tick the check box to set this password for local access as well (so, anyone accessing Xeoma even on this very computer, ‘locally’, will have to enter a password. This password can be changed in User rights dialog.

4.3. Licensing

Licenses can be purchased online on Buy page. Once you activate a Xeoma license for any amount of cameras, you get your version upgraded to the Standard edition with unlimited possibilities, full remote access, and more. You can use it as long as you want and/or need to. Licenses are for lifetime with free updates included for 12 months since purchase date.

The number of licenses can be increased gradually. You can add unlimited number of licenses to the ones you already use and thus use as many cameras as all of your activated licenses allow in total. Buying licenses is a one-time payment: no monthly or yearly fees required. However, Repeater and Cloud subscriptions are not included in regular Xeoma licenses.

In most cases you will receive license immediately after payment. If you’re purchasing the license via PayPal or swift bank transfer, it may take a couple of business days for the payment to reach us. License activation takes just a few seconds.

License is universal for Windows, Linux, Mac OS or Android. You need the Internet connection to activate a license. Any license can be activated only on 1 device! The license is connected to the unique server ID, it is hardware dependent but survives OS reinstalls. Moving licenses is only allowed in exceptional cases. To do that, please go to the license reset page.

Connection to the activated Xeoma from Xeoma-Client is free, no matter how many clients are connected.

Licenses are bought on a ‘per cameras/video sources per server’ basis meaning that you need a license for as many cameras (video sources) as are used on one server. You will need separate licenses for each of such servers. Please contact us to ask for a quote for your installation. Camera/video source is any video source of signal (camera, Another Xeoma, screen capture, file reading).

You can see the information about your licenses in Xeoma (Main Menu –> Information –> Active licenses). You can move the cameras between the servers by yourself, without stopping the system’s work. It’s necessary to take into account the functions, which are included in the price of a channel, as well as the total cost of the software and the whole product, as the total cost depends on several factors: productivity, licensing etc.

ATTENTION: If you have difficulties with your license, or did not receive your license right after purchase had been confirmed, please contact us!

4.4. Program activation

After you have bought a license, you will get an alphanumeric serial number. Use one of the methods to activate your license and switch your Xeoma to a commercial version of your choice or add renewal(s) to existing license(s) already activated on this machine.

To activate Xeoma Pro Cloud licenses, please follow the instruction.

4.4.1. Online Activation:

Internet access required. Can also be used behind proxy. Simple type of activation. Simply paste the license (serial number) into the Online Activation field (Main Menu –> Registration –> Activate) and click OK button. After the activation is completed successfully, a message will appear with indication how many video sources you are able to use now.

Paste you serial number and click OK to activate Xeoma

Or, if required, click on Offline activation.

4.4.2. Offline activation:

If your PC is not connected to the Internet, or using Internet connection is undesirable, use Offline activation (Main Menu –> Registration –> Activate –> Offline activation link or Main Menu –> Information –> Activate –> Offline activation link). On your computer that you want to activate Xeoma on (that is on the one with no Internet connection) paste your serial number into the field, and copy the link that appears below.

If Offline activation should be used, paste the serial number into the first field

Paste this link into any web browser on another PC or any other device that has Internet connection and get an activation code from the site. This code should be entered in the field ‘Enter activation code…’ on that PC you’d like to use Xeoma on (the one with no Internet connection), then click OK.

Paste the activation code from the site into the corresponding field on the very machine you would like to activate Xeoma on

In both cases, if the activation was successful you will get the ‘Activation successful’ message:

The message you will see if the activation is successful

If you already have licenses activated on that machine and would like to add more, you can simply activate the new serial numbers the same way you did the original ones. Licenses will cumulate (N.B. Lite licenses cumulate only up to 4 cameras per server and only among themselves).

If you have an Upgrade from Standard to Pro, you can activate it by indicating the original license’s serial number, semi-colon, the upgrade’s serial number (no spaces). For example, XXXXX-XXXXX-XXXXX-XXXXX-XXXXX;YYYYY-YYYYY-YYYYY-YYYYY-YYYYY. As a result, you will get access to Pro features for that number of cameras. If the Standard license had more cameras than the upgrade, only a part of it will be affected.

No matter what way to activate your license you choose, with Xeoma commercial edition you will get unlimited possibilities and activated benefits.

For information on activation Xeoma using a proxy server, please see this section.

4.4.3. Activation on virtual machines:

Starting from version 16.12.26:

Activation is possible on any type of virtual machines for Xeoma (Xeoma Standard), Xeoma Pro, Xeoma Standard upgrade to Xeoma Pro and renewals.
For that, permanent access to the Internet is required on the virtual machine, or you will need to arrange your own license server on another computer in the network where the Internet is available and choose this license server during activation. See 4.4.4. for more information about license server.

When Internet connection is lost, the license might be deactivated but will be back after the Internet connection is restored.

Activation of Lite licenses is prohibited on virtual machines.

xeoma_software_advices Tip: if you need to use Xeoma on virtual machines without Internet access, we recommend to use a license server or purchase hardware keys

Xeoma up to version 16.12.26:
Activation is possible on these virtual machines:
1) Hyper-V
2) KVM
3) LXC
4) VMWare
5) Virtual Box

If you have another type of virtual machine, please use one from the list instead, or use a physical machine.

4.4.4. Activation on virtual machines with license server
If you have a virtual machine that doesn’t have Internet access, to make licenses work on this virtual machine, starting from Xeoma 16.12.26 you will need a dedicated license server in your network.

If you update to 16.12.26 you might get this type of message:

Activation of Xeoma video surveillance for IP cameras on virtual machines with license server

You will also get a reminder if you go to the Activate window:

How to activate Xeoma video surveillance for IP cameras on virtual machines with license server

What you need to do is as follows:

On another machine in the network that has Internet access go to Main menu -> Install -> Install license server to make this machine a dedicated license server.

Activate Xeoma video surveillance for IP cameras on virtual machines with license server

If you want the connection to be secure in your local network, tick the “Use password for localhost access” option:

Activate Xeoma video surveillance for IP cameras on virtual machines using license server

Please wait while Xeoma is installing the license server.

Guide how to activate Xeoma video surveillance for IP cameras on virtual machines with license server

After it’s done, you’ll see a desktop shortcut.

Guide how to activate Xeoma video surveillance for IP cameras on virtual machines using license server

On your vurtual machine in the Activation window, you’ll need to select the license server rather than usual activation server:

Select license server to activate Xeoma video surveillance for IP cameras on virtual machines

After that, you will be able to activate the license on your virtual machine.

Successful activation of Xeoma video surveillance for IP cameras on virtual machines

Please note that the license server machine should be running and have Internet access all the time you want licenses to work.
When Internet connection is lost, the license might be deactivated but will be back after the Internet connection is restored.

4.4.5. Hardware keys (USB flash drive)
Xeoma licenses can used as hardware keys tied to USB flash drives. You can choose necessary Xeoma license that you want to purchase at our website and contact us.

Hardware key with Xeoma license works as a plug-n-play device, i.e. you can insert USB flash device into USB port and use Xeoma in Commercial mode. This way you can use activated Xeoma version on any device with USB port including virtual machines with no internet connection.

You can also purchase additional hardware keys with Xeoma licenses and insert them into other/different USB ports to expand your video surveillance system.
Please note that older licenses cannot be used as a hardware key. Hardware keys are only available for new licenses that will be assigned to the USB-device.

Videosurveillance program Xeoma offers soft and hardware keys

4.5. Updating Xeoma

The process may vary depending on what version of webcam software Xeoma you have and whether you have installed Xeoma (through Main Menu –> Install –> Install) or not.

In all current versions of Xeoma you can use all benefits of auto-update check and notification, and easy 1-click update:

Webcam software Xeoma now offers automated check for updates, notifications about new updates and 1-click easy updates

You can check if there are any updates available through Main Menu -> Information -> Check for updates. If you chose auto-search for updates you will get a notification about available updates at program start!

If your Xeoma is 13.3.7 or older:

a) If Xeoma is not installed, there should be no difficulties – just run the newer file downloaded from our site or any other resource.

b) If Xeoma is installed, you need to launch the older version, go to Installation Options and click Uninstall all except for archive and settings (please be careful, this is important to keep your current settings and transfer them to the newer version). Then, you can run the newer Xeoma and install it if needed.

Automatic updates are available for both beta and release versions of Xeoma.

Also, important is to remember when you bought your license. Free updates are only included for the first 12 months since purchase date. After that you will have a choice of whether to continue on using the latest available version by the time the free updates period expires; update Xeoma to the newest version and therefore give up on using the license; or buy a new license and get more 12 months of free updates.
For information on your activated licenses, go to Main Menu -> Registration -> Active licenses. For information on all licenses registered, please fill in the online form at web site.

Note: to update to beta versions as well please tick the corresponding option in the Check for updates window.

For information on updates using a proxy server, please see this section.

4.6. Operators and user access rights

4.6.1. User access rights (user permissions)

In user rights dialog (Main Menu -> Remote access -> Users) you can create user profiles with multi-layered access rights and permissions. In this dialog you can restrict or allow access to view of cameras (real-time and archives), PTZ control, settings, for all or certain cameras.

Click ‘Add’ to add a new user. To edit a profile’s password or rights, select the profile and apply changes; then click the OK button. The ‘Duplicate’ option copies the assigned rights for the follow-up user. Please note that all user names and passwords must be unique.

The created password, along with the server’s IP address, should be used in the Xeoma’s Connection Dialog to login under this user profile. Pay attention that user profile’s name is just for information and is not used in the Connection Dialog.

Check the ‘Multiple access under a user’ option to allow this profile to be used on several machines simultaneously. If it’s not checked, only one connection with this data will be accepted at a time.

When administrator profile is selected, you can change your local and remote access password that was originally generated by the program (simply type it in the field instead of the currently used). For security reasons, this password is impossible to retrieve so make sure you remember the password, or save it to a safe place.

Also, when under administrator, you can allow or restrict access to Layout and Main Menu. If those options are ticked, all users will need to enter a password to access any or both of the menus (won’t work if the password box is empty).

Please note that there can be only 1 administrator profile and multiple access is automatically allowed for this one.

Operation management in Xeoma

4.6.2. PTZ blocking

You can block PTZ for operators. To do this you need to go to Main Menu -> Remote Access -> Users

If you want to completely block PTZ usage of any camera, you can remove the tick from the check box next to the desired camera. Thus, we have completely blocked the use of PTZ of the selected camera for the specified user.

Completely block PTZ for this user

If you want to allow your operators to use PTZ of a camera, but you need to set some restrictions, you should use the Priority levels.

What does it mean?

Imagine a big factory where there are a lot of cameras. Most likely, this factory will be monitored on several levels of management, from security guards to CEOs. Priority levels will help the upstream user to block the downstream. So, the Administrator with a 10 priority level blocks downstream users from 1 to 9. Users with priority from 11 to 15, can block both the Administrator and downstream users, etc.

4.7. Settings restore

In Xeoma you can save a copy of your configuration to use it as a backup and get back to it later in case of necessity. You can do it in Main Menu -> Install -> Restore (not available in the trial mode of Xeoma).

Also, there is a SettingsBackupDir folder in Xeoma directory on server. Backup copies of settings are stored there according to this schedule:
1) Current day: backup copy of settings is stored after every change of settings you make.
2) Previous day: backup copies of settings are left for every hour.
3) From 2 to 10 days before that: only first and last copies are left.
Backup copies of settings older than that get deleted.

A backup copy from that folder can be used to restore Xeoma settings. To do that, rename the backup file to settings.dat and replace the current settings.dat file with it (Xeoma should be turned off at the moment).

4.8. The visualization of movement (motion tracking)

Xeoma supports visualization of movement and motion tracking. After activating this option all objects that are moving will be enframed and you will be able to see the “track” – green dots – the moving object has left in course of its movement.

To turn on/off the visualization of movement go to Layouts and choose there “Turn on the visualization of movement”/”Turn off the visualization of movement”.

Motion tracking

4.9. Heatmap

Heatmap is one of the most efficient tools in video surveillance. With its help, you can get a quick glance at motion dynamics in camera’s field of view.

The way Xeoma’s heatmap works is somewhat different from how heat cameras work. The latter is all about an object’s temperature. “Warm” or “hot” objects are shown as an area in the warm color spectre (red hues), and the is colder the object the deepest blue color it is in camera image.

Xeoma uses similar “warm-cold” color gradation, but relies on the motion frequency in a certain area rather than temperature of it.

From theory to practice
As the heatmap is based on information from the Motion Detector, it’s only logical that the scheme requires a Motion Detector module. Thus, make sure that you have it in your scheme along with a Universal Camera and Preview and Archive. Set the Motion Detector up the way you need and make sure it passes image down along the scheme.


Go to the Archive Viewer (Play button in the lower panelor camera box corner). In Archive Viewer’s menu select the “Create heatmap”.


In the new prompt select a time range you need the heatmap for. It could be for example, a week’s time, 24 hours or 15 minutes. By default, all time that you have records for is selected. Attention! You must have at least 5-minutes worth of records in a certain archive for Xeoma to be able to create a heatmap for this archive for any of available period of time you select.


You can save the heatmap you got with the corresponding option in Archive Viewer’s menu.

4.10. Secure TLS Connection

Now we can focus on actually using this in Xeoma. First things first, we need to generate a security certificate on the server. The best software for that is OpenSSL: However, it seems to provide stable operation only for Linux-based systems. The created certificates are valid on any system, though, so, if you are running Windows or Mac OS, you can either ask a Linux-using friend for help or use a virtual machine to get access to Linux. There are various commands you can use in the terminal to generate a certificate with this, but please make sure that the resulting files are named either PublicCertificate.pem and PrivateKey.pem or PublicCertificate.der and PrivateKey.der. The quickest way is to copy-paste this command:

openssl req -x509 -sha256 -new -days 3650 -newkey rsa:2048 -nodes -out PublicCertificate.pem -keyout PrivateKey.pem -subj “/C=Co/S=SN/L=Lo/O=Or/OU=OU/CN=CN”

A security certificate for Xeoma is ready

Now you have both freshly-generated files in your OpenSSL directory:

The folder with certificates for TLS connection

The only thing left to do is to move them to Xeoma’s main directory, in Xeoma → Security → Certificate:

Security certificate is now ready to be used with Xeoma

Put both PublicCertificate.pem and PrivateKey.pem in the Server folder (they will replace the files already inside). Please note that PrivateKey.pem is particularly important, no one should have access to it other than you. Otherwise, your security may be compromised. Now all the clients need to put the PublicCertificate.pem in the Client folder and the secure connection is guaranteed. If you need a single client to connect to several different servers via different certificates, you can put them all in the Client folder (under names PublicCertificate1.pem, PublicCertificate2.pem, etc., but make sure that the names coincide with those on the servers).

4.11. Backup of recordings

One of the most efficient way to save the data is to have backups, preferably far away from the main server. This is where FTP upload comes to save the day.

The server, which is going to house your backup archive, needs an FTP utility installed. One of the most popular among them is FileZilla. It’s free, so you can download and install it easily.

So, how does one implement this in Xeoma? There is a module made specifically for that – “FTP Upload”. All you need to do is set it up correctly.

Setting up FTP upload in Xeoma

First, we need to type in the FTP server’s address and the port (the default one is 21, but you can specify a different one on the FTP server). If you want the transfer to be securely encrypted, CHECK the box SFTP (SSH File Transfer Protocol). Don’t forget to click the Test button! If something’s set up incorrectly, the message at the top will show you exactly what it is. If everything is OK, the message will say Test successful.

A backup archive doesn’t have to be quite as tidy as the main one. However, if we ever wish to actually navigate through it, it needs to be arranged in an understandable way. By far the easiest way to do so is to insert date and time into every filename. The macros are made with this in mind. All you need to do is put these symbols between two % (percent signs). The line under the input box shows exactly how the filenames will look. In our example the line %y-m-d h-i% is transformed into 2016-12-06 13-47. With this navigating the backup archive should be simple.

To make sure that we don’t miss anything, we can set the Prerecord for a few seconds and an Interval in saving images/videos. Finally, we need to choose the Type of saved data: JPEG, MJPEG, WEBM, AVI or WMV.

That’s it! The backup archive on the server with an FTP utility is ready and waiting.

4.12. Failover

Xeoma is video surveillance software of the new generation. Following the latest demands of contemporary art of video surveillance Xeoma now has support for Failover.

If one of main servers is down, a designated backup server will come in place of it automatically. When the malfunctioning main server is back up, work will be continued on it.


The feature is available for Xeoma Standard and Xeoma Pro editions.

It is set up in Main menu → Install → Failover where a system administrator can assign Backup servers to corresponding Main servers.


Attention! Backup servers require licenses of the same type as on corresponding Main servers they serve as Failover for.

4.13. Hardware acceleration

4.13.1. Server

If a single server needs to handle a lot of cameras (e.g. 50), powerful CPUs are required to process the live streams. However, graphics cards (GPUs) can take at least part of this load by employing hardware acceleration of decoding. In particular, modern Nvidia cards support CUDA (Compute Unified Device Architecture), while Intel’s integrated GPUs support Quick Sync. Xeoma allows to take advantage of either of these methods.

To enable this option, access the “Universal camera” settings and tick the corresponding box:

There are 2 conditions for hardware acceleration to work:

  1. the preview stream (the first URL in the module) needs to be of at least HD quality (720p or 1280×720) – otherwise, acceleration is counter-productive;
  2. the GPU itself should be at least Nvidia GeForce 400 series or higher.

The GPU’s power corresponds with the number of cameras it needs to work with. For example, GeForce GT 730 can handle 4-6 cameras, while GTX 1060 can process tens of cameras.

4.13.2. Client

If the client machines have enough capacity to decode the streams, the server’s load can be reduced considerably. Hardware acceleration can be used in this situation as well – the server can be set to move the decoding to the client side (remote workstation). Go Layouts menu → Client decoding settings and choose the necessary options in the drop-down menus:


5.1. Work with proxy servers

You can make Xeoma work with a certain proxy server. Use the -proxy command while launching Xeoma via command line or Terminal, followed by the proxy server’s address. For example:

The command will help you use connection via a proxy server

If you don’t need to use proxy server anymore, you can disable this option with the -proxyclear command.

5.2. Remote access options

Xeoma offers a variety of options to establish remote connection of various types and for various purposes – client-server connection, multi-server connection, ‘Web server’-‘Another Xeoma’ pair of modules, and browser remote view. Let’s get deeper into what they are for and how to use them.

Remote connection to Xeoma video surveillance solution server dialog1) Client-Server connection.

Used to: view all cameras, access (view and change) settings for cameras and other modules, view real-time and recorded footage.

How to: Run / install Xeoma on machine #1 and use this computer’s external IP address, available from the Internet, to connect to the machine #1 from other machines – their total number is not limited. Just run Xeoma on those other machines (they can be under an OS other than machine #1’s), go to Remote Access menu and specify machine #1’s IP and password.

More about connection without a static external IP address in our article How-to: Using of remote access in video surveillance

Multi-Server Mode in Xeoma video surveillance solution 2) Multi-server connection. This is just another type of client-server connection.

Used to: view cameras in real-time and archive recordings from several Xeomas at the same time.

You can find full instruction on how to set up the Multi-server connection here.

3) ‘Web Server’-‘Another Xeoma‘.

Used to: view a certain camera of machine #1 in real-time and record footage from this camera on machines other than machine #1.

How to: Run Xeoma on machine #1, connect ‘Web server’ module to a camera and set the module up. On another machine run Xeoma and use not a universal camera but ‘Another Xeoma’ as a source. In settings of the module you need to specify machine #1’s available from the Internet IP address and stream info.

*you will need as many ‘Web server’-‘Another Xeoma’ junctions as cameras you want to see.

More on topic in our Xeoma Web Server section

Chain with Web Server module in Xeoma video surveillance solution Chain with Another Xeoma module used as a camera in video surveillance solution Xeoma

4) Browser View.

View from any location via web browsers is easy with Xeoma video surveillance solution Used to: view a certain camera in real-time in a web browser, for example through mobile devices.

How to: Run Xeoma on machine #1, connect ‘Web server’ module to the camera and set the module up. In the module’s settings you will find a link to paste into web browser.

*you will need as many ‘Web server’ modules as cameras that you want to view in a browser.

More on topic in our Xeoma Web Server section

5.3. Repeater service – access your computer everywhere even without a real Internet address

See also Repeater video

Repeater is a service similar to but more powerful than dynamic DNS. It gives you an opportunity to access your computer with Xeoma program even if it is not available from Internet, i.e. inside firewall, at private IP address space, at mobile network, or in some Asian countries where no real IP addresses are available.

With Repeater service enabled in Xeoma you can access your cameras, archive or settings even if your computer is not accessible from Internet.

All you need is to enable this service in Xeoma via Main Menu -> Remote access -> Repeater setup. You will get Repeater connection data that you will then be able to use to connect to this server from a client (specify this data in Connection dialog).

You don’t need Repeater if your server has a static public IP address or if Xeoma Cloud is used.

If you have difficulties with repeater activation please try temporary turn off or uninstall your antivirus. Then activate repeater and turn on (or install) antivirus.

If you have low framerate when connected through Repeater, please check your network for bottlenecks. Increase bandwidth capacity on server or client side, or request higher Internet speed from your provider.

Also see: instruction on remote access using the Repeater service.

5.4. Xeoma Web server module

You can also view Xeoma Web server video

Xeoma Web server module differs from most of the modules because of its multi-functional nature. For example, compared to the Scheduler module, that can only be used in one way – to turn the system on or off – the Web server module can be used in various ways to reach various goals.

Part 1. Remote view of cameras via browser

The most popular purpose of Xeoma Web server is to enable live view of a camera or cameras from almost any device with access to the Internet and webcam streaming, even on a non-supported operating system. After you connect this module to the camera, you will be able to view the camera remotely in a browser (for access from outside of local network, you will need to have static real IP address.

Simply connect the Web server module to the camera in chain.

Xeoma chain containing a camera and a web server module for webcam streaming

The same rules of module connection applies here: if you connect the Web Server after a filtering module like Motion Detector, the image will get to be displayed in a browser only when the module will let it through. As permanent access is usually required for browser view, you are advised to connect the Web Server straight to the camera.

Tip: if you’ll need to view archive recordings in a browser as well, please make sure that there is a Preview and Archive module connected, and that has recordings.

Enter its settings, where you will find the links (URLs) to access various streams – JPEG images, MJPEG video, Flash video with sound, web server general page to view all cameras that have a Web server module connected to them on this computer.

If authorization is required for web browser access, set the username and password here.

Please note that by default the links are for view from within the same network; that’s why they contain the localhost word. For remote view from outside of this network you need to replace ‘localhost’ with the computer’s real static IP address. The links can be edited outside of Xeoma. Copy the link and paste it into a browser.

Xeoma Web server settings - MJPEG and JPEG streams

Tip: Pay attention to the name in the Path to access… boxes. Images from cameras in browser page follow in alphabetical order according to those names. For example, if one camera has “image1”, and another has “image 99”, first in web browser page will be the one with “image1”.

Attention! If you’re using direct saving to the archive in your Universal camera module, please note that Web Server gets and displays the preview stream only.

Attention! Not all browsers support live view of MJPEG streams.

If your browser doesn’t support MJPEG, you can either use another browser or use dynamically updated JPEG pictures instead of actual MJPEG videos.

Multi-camera web page. With http://IP:10090/ you can access web server main page and view all cameras altogether that have a Web server module connected to them on this computer.

Attention: if a camera is unavailable or stopped working for some reason, you’ll see an empty box instead of camera image in web browser.

With Xeoma web camera software you can view all your cameras in one place

In the browser you can view cameras that have Web Server modules connected and turned on live, their archived recordings, and control PTZ functions (if cameras have PTZ functions and they were detected in Xeoma). The PTZ control will appear in the Single Camera View Screen of web interface (PRO license is required to enable PTZ in browser).

You will see the following tabs in the web page: Camera View (the default landing page), Archive, Preferences, Framerate.
Camera view is the page for view of multiple cameras you have Web Server connected to on this server (default landing page, also called Multi-Camera View page), or view of a single selected camera (also called Single Camera View page).
Archive is the page where you can view archive recordings for a camera. If you got to this page from the Multi-Camera view, you will need to select a camera to view archive for.
Preferences is a dropdown list with 2 options: adding/removing a camera, or auto search for cameras (see details here).
Framerate is a dropdown slider with which you can reduce the maximum refreshing speed of all camera images in web page. This option is applied solely to the browser view and does not affect framerate in Xeoma server part. Framerate cannot be higher than that of a camera stream.

Single-Camera View. While in Multi-Camera View page, click on a selected camera image, and you’ll get to the Single-Camera View page of this camera. If you only have 1 camera, click on it to open it in Single-Camera, for larger view.

In Single Camera View page’s top panel you’ll see the same tabs except for Framerate which here is replaced with Fullscreen View option.
Framerate and image quality can be selected below the image instead (both parameters are applied solely to the browser view and do not affect framerate in Xeoma server part).

The “Preferences” tab has also the setting to configure the camera’s Motion Detector module. Almost all features from the client version are available:

Archive. To view a camera’s recordings go to the Archive tab.


Here you will see name of folder for this archive in Xeoma, and timeline where you can select a certain piece of archive with a slider or with the list of time and date.

You can change playback speed and reduce video’s quality to reduce network bandwidth load, in the View Preferences box. Again, this parameter is applied solely to the browser view and does not affect framerate in Xeoma server part.


Export. In web page you can also download a piece of archive records onto this machine. To do that, click the Download button, and select the needed piece’s start and end date and time.


Browser view of camera stream with sound.

To watch Flash video with sound via an Internet browser, tick the box and use the corresponding link (or go to Flash video broadcasting right from the web server general page):

+ Unlike client-to-server connection, browser view of cameras can be performed from any device with access to the Internet, including tablet, cell phones, even those with non-supported operating system.
– But then again, unlike client-to-server connection, browser view is not available if the computer with Xeoma and cameras does not have static public IP address.

Part 2. Saving footage to another computer

Web server module will be also of help if the objective is to save video surveillance footage to another computer, for example, to create backup footage on a central monitoring station.

In this case you will need to connect the Web server to the cameras. On another computer, where you need to store footage (in our example, that is the central monitoring station) you will need to use Another Xeoma instead of the camera module:

+ On both computers you will be able to store footage and work with camera.
– You might need an additional license (if total of modules in use on either of the computers is higher than 3).

Tip: you can use the combination of HTTP Upload to other Xeoma and HTTP Receiver to transfer not just video, but also sound and all meta data. See the HTTP upload to other Xeoma article for details.

Part 3. IP camera emulation

If you’d like to transform your web camera (USB camera) into an IP camera that will be accessible to other computers and Xeoma Cloud. In this case, you need to connect the Web server to the camera. Other computers will ‘see’ it as an IP camera.

Part 4. Having live broadcasting on your site

You can broadcast your camera to your site or blog. Embed the link from web server’s settings into your page’s code to put a weather radar or traffic demonstration on your site or blog without installing Xeoma client. Broadcasting dynamically updated images or video streams – up-to-date and high-quality snapshots and videos (weather radar emulation, useful traffic information) – will make it more attractive and useful to your site’s guests.

If ‘flv broadcasting (with sound)’ option is on in the Web Server module settings, you will also see a link to view Flash stream. Click the link and then click the camera image of camera you’d like to view in Flash (with sound).


In the Flash view window you can use buttons as follows:


A – to select different stream resolution;
B – to start/pause playback;
C – to change sound volume;
D – to open stream in full screen.

Attention! Mozilla browser might ask to install Flash player to playbcak Flash streams.

You can control your web server using http-commands as well. Here are all of them:

http://IP:10090/video0.mjpg?resolution=1027×768&oneframe=0&waitTimeoutMs=1000&login=USERNAME&password=PASSWORD returns a real time video or a single frame in MJPEG
video0.mjpg is the URL for the MJPEG-stream in the “Universal camera”
resolution is the resolution for the frame (not necessary, doesn’t work with the video)
oneframe is whether you need a video (0) or a single frame (1)
waitTimeoutMs is the waiting time for the server’s response (usually between 100 and 1000)
login is the username (not necessary)
password is the password (not necessary)

http://IP:10090/image0.jpg?resolution=1024×768&login=USERNAME&password=PASSWORD returns a single frame in JPEG
image0.jpg is the URL for the JPEG in the “Universal camera”
resolution is the resolution for the frame (not necessary)
login is the username (not necessary)
password is the password (not necessary)

http://IP:10090/?archive_minutes=&archive_date=2015-11-26&archive=PreviewArchive.9 returns a list of time codes for the specified date, format hh:mm, each one on a new line
archive_date is the date, format year-month-day
archive is the name for that archive in the module “Preview and Archive”

http://IP:10090/?archive_frame=&archive=Preview+Archive.9&archive_date=2015-11-26&archive_minute=13:19&archive_millis=45435&maxResolution=&scaleFactor=100 returns a single frame for the specified time and date in JSON
archive is the name for that archive in the module “Preview and Archive”
archive_date is the date, format year-month-day
archive_minute is the minute, format hh:mm
archive_millis is the milliseconds (between 0 and 59999)
maxResolution is the frame’s resolution, format widthxheight
scaleFactor is the compaction scale (between 0 and 100, where 100 is the highest quality, less than 80 is not recommended)

http://IP:10090/?archive_start_export=&archive_id=Preview%2BArchive.24&start_date=2017-03-09&start_hour_minute=13%3A00&end_date=2017-03-09&end_hour_minute=13%3A02 exports the specified interval from the archive
archive_id is the name for that archive in the module “Preview and Archive”
start_date is the date for the beginning of the interval
start_hour_minute is the time for the beginning of the interval
end_date is the date for the end of the interval
end_hour_minute is the time for the end of the interval

http://IP:10090/?login=LOGIN&password=PASSWORD&getsessionkey= quick authorization
login is the username
password is the password

http://IP:10090/?addchain=&cameraSettings=&cameraLogin=LOGIN&cameraPassword=PASSWORD&previewUrl=PREVIEWURL&archiveUrl=ARCHIVEURL&enableH264ArchiveId=false adds a camera
cameraLogin is the username for the camera
cameraPassword is the password for the camera
previewUrl is the preview stream’s URL
archiveUrl is the archive stream’s URL
enableH264ArchiveId is direct H.264 recording without conversion (true enabled, false disabled)

http://IP:10090/?addchain=&ftpReceiverSettings=&ftpReceiverServerAddress=ADDRESS&ftpReceiverServerPort=FTPPORT&ftpReceiverLogin=LOGIN&ftpReceiverPassword=PASSWORD adds “FTP Receiver”
ftpReceiverServerAddress is the address for the server
ftpReceiverServerPort is the FTP port
ftpReceiverServerLogin is the username
ftpReceiverServerPassword is the password

Now you can customize the web server pages! Learn how to do that in our article Web server customization!

5.5. Web server customization for online view of cameras in Xeoma

Starting with Xeoma 13.9.30, along with rebranding opportunities, Xeoma offers you to customize its web server pages to make them look the way you want.

To do that, you will need to Web server module to the cameras you’d like to view in web server. Enter the Web server module settings and visit the pages in a browser that you’d like to customize. A XeomaWeb folder will appear in Xeoma directory. That’s where you will see the needed html pages. Place all resources you are going to use (icons, pictures, other pages) here.

To access the graphic files, you will need to use a path like img src=”?obj=PictureName.png”. Open and edit the needed html pages (even Notepad will do). You can also access other pages from the directory.

Full photo instruction on web server customization can be found in our Articles section.

5.6. Mobile video surveillance with Xeoma Android app

Basically, what remote video surveillance offers is the ability to check in several, perhaps even hundreds, locations so spread out geographically that it would be next to impossible to visit them with so little time loss otherwise.

Xeoma free Android app cctv viewer for mobile video surveillance on Nexus device Xeoma Android app differs from desktop versions because due to Android regulations the app has to be installed before it can be launched. Apart from that, the app is almost an exact copy of desktop Xeoma. Just client part will be launched by default. The Android app will auto detect your cameras (including the built-in camera if it’s available) and connect them. You can use Xeoma in the regular editions – free, trial and commercial, enjoy automatic updates, connect cameras, etc.

Xeoma can be used as a client part or as cctv viewer to connect to Xeoma server on another device (desktop or mobile). Fill in the fields in Connection Dialog (Main Menu -> Remote Access -> Connect to) to connect to that machine and be able to view cameras live and recorded archives, apply changes to settings.

Or, with the app, your Android-based device can become a surveillance system itself. Connect the cameras, set events and reactions up, assign user rights and much more for your new mobile video security system.

Detailed settings window for visual and flexible configuration. Click on module to open its settings

Push notifications

With the “Window Popup (on Client)” module (Destination tab in Xeoma’s upper bar of modules) you can receive push notifications on your Android, for example when there is motion detected in the field of view of the camera. Unlike regular desktop versions of Xeoma, where this module simply deminimizes the minimized Xeoma client window, the Window Popup module on Android will, when triggered, make a notification sound, flash LED lights and show Xeoma icon on notification bar of your device.

You can view this notifications’ info and find out when motion was detected. Clicking on this notification will take you to Xeoma where you can view the motion event or take other necessary actions. The icon will be shown in the notification bar until you open Xeoma, so even if you were away at the time of detection, you will not miss it.

5.7. Application for iPhone/iPad

New Xeoma app cctv viewer for remote video surveillance from iPhone or iPad is already available on App Store

New Xeoma app for remote video surveillance from iPhone or iPad allows view archived and live cameras

New Xeoma app for remote video surveillance from iPhone or iPad detailed instruction

New Xeoma for iPhone and iPad is perfect for remote view of your cameras. It can be used as cctv viewer to connect to Xeoma Cloud or Xeoma server on your desktop or tablet, even with behind firewalls (with the help of Repeater service).

With this iOS client you can connect to your Xeoma to view camera’s live feeds and archived recordings, with sound, and ability to zoom the picture digitally in/out, from wherever you are!

Take it with you to vacation, business trip, to the place of work. Peek in when you have time at your babysitter or seniors or make sure those you care about are safe in hospital.

Connection instructions

1. Go to App Store and download Xeoma from there.

2. Once it’s downloaded, it will be launched and ask to install.

3. When it’s completed, a prompt will appear asking for connection data. These you can get from your Xeoma server or Xeoma Cloud subscription:

Connection dialog in Xeoma app for remote video surveillance from iPhone or iPad
4. If the data is correct and the server part is available, you will be connected, and will be able to view your cameras and their archives.

5. You can go back to the connection dialog window to connect to another server. Click the connection button below.

That’s it! Now you can enjoy remote access to your Xeoma from anywhere at any time!

5.8. Connecting Xeoma via VPN

First of all, you need to understand whether you need a server or a client on your machine. If you want your computer to serve as a hub for other machines that would connect to it in order to view cameras, then it’s a server. If you simply want to connect to something else that holds the info on the cameras, then it’s a client.


In order to establish a functional server via VPN, you will need to configure it properly. You can do it by following these steps:

1. Download free OpenVPN software that corresponds with your OS from
2. Install it (checking ALL the parts) in C:\OpenVPN
3. Time to make a valid Certificate Authority (CA) file for your server. To do that, open the console:
1) Enter the folder by typing: cd C:\OpenVPN\easy-rsa
2) Run the configuring file by typing: init-config.bat


3) Go to C:\OpenVPN\easy-rsa and edit vars.bat (simple notepad will do). Within you will find:
set KEY_CITY=SanFrancisco
set KEY_EMAIL=mail@host.domain
Edit these values to correspond with your country, province, city, organization and e-mail respectively.


4) Run vars.bat by typing in the console: vars.bat
5) Now run 2 more files by typing:

6) Press ENTER for all the values, except Common Name, here type:


7) That’s it! Now you have generated a valid Certificate Authority file called ca.crt that you can find in C:\OpenVPN\easy-rsa\keys.


4. Time to make an actual certificate and a key for the server:
1) Type: build-key-server.bat server
2) Press ENTER for all the values, except Common Name, here type: server
3) The console will ask you: “Sign the certificate?” Type: y
4) The console will ask you: “1 out of 1 certificate requests certified, commit?” Type: y


5) That’s it! You have generated the files server.crt and server.key that you can find in C:\OpenVPN\easy-rsa\keys.


5. Time to set the Diffie-Hellman parameters (basically, the defense for your keys). Type: build-dh.bat
Now you have generated the file dh1024.pem that you can find in C:\OpenVPN\easy-rsa\keys.


6. Now copy the files ca.crt, server.crt, server.key and dh1024.pem in C:\OpenVPN\easy-rsa\keys and paste them in C:\OpenVPN\config. You will also need to create a file server.ovpn in this folder. Use the notepad for that and put this information in the file:
port 1194
proto tcp
dev tun

ca ca.crt
cert server.crt
key server.key
dh dh1024.pem

topology subnet


keepalive 10 120

cipher AES-128-CBC



verb 3


7. You can now set users for your server:
1) The users require logins and passwords in order to access your server. Add this information to the server.ovpn file (use the notepad):
# Path to the folder with config files
client-config-dir C:\\OpenVPN\\ccd
# Verification of the authentication data via verify.bat
auth-user-pass-verify C:\\OpenVPN\\verify.bat via-file
# When username and password are checked, don’t ask for the certificate
# Username for further authentication
# Allow external scripts
script-security 2

2) Create the folder ccd in C:\OpenVPN, it is needed for the users’ configuration files.
3) Every user requires a separate file in this folder. The filenames should be ‹User_Login›.config (so every filename contains the login of the user). Within the file type the IP-address you want to give to that user like this:
ifconfig-push ‹IP_address› ‹Mask› (where ‹IP_address› is between and according to the server.ovpn file and ‹Mask› is


4) Create the file verify.bat in the folder C:\OpenVPN (use the notepad). This is going to be the file the server will use to check your users’ logins and passwords. Within the file just type the logins and passwords for your users separating them with a space.


8. Finally, you are ready to launch the server. Click the OpenVPN GUI icon. Now your system tray (lower right corner of the screen) holds the OpenVPN GUI icon, right-click on it and choose Connect. Wait a few seconds and the icon will become green and display the IP-address of your server.


All set to go!

Client for Windows

To configure a client connection properly, follow these steps:

1. Follow the steps 1 and 2 for the server instruction.
2. Follow this link: to download a valid certificate.
3. Follow this link: to download a configuration file.
4. Now copy-paste both and client.ovpn in C:\OpenVPN\config.


5. Within the same folder create authentication.txt. It should contain logins and passwords, each in its own line.


6. Now launch OpenVPN GUI and wait until its icon appears in the system tray. Right-click on it and choose Connect. Wait a few seconds and the icon will become green and display the assigned IP-address.

All done!

Now there is one last thing to make sure that you can view the cameras remotely. The cameras’ IP-addresses need to be forwarded. To do that, open the console (make sure that you use the Administrator):

1. Type in: netsh
2. Type in: interface
3. Type in: portproxy
4. You’ll need to choose a port for your camera. In this article we’ll use 12345 and camera’s IP as an example. Keep in mind that you will need different ports for different cameras. Also, you will need the camera’s current port.
5. Type in: add v4tov4 listenport=12345 connectaddress= connectport=22 listenaddress= (all in one line)
This will forward the port 12345 to
All set!

Client for Linux

To configure a client connection properly, follow these steps:

1. Install OpenVPN using this command: sudo apt-get install openvpn
2. Follow this link: to download a valid certificate.
3. Follow this link: to download a configuration file.
4. Now copy-paste both and client.conf in /etc/openvpn/


5. Within the same folder create authentication.txt. It should contain logins and passwords, each in its own line.


6. Now simply launch OpenVPN by typing: sudo openvpn /etc/openvpn/client.conf


All done!

Now there is one last thing to make sure that you can view the cameras remotely. The cameras’ IP-addresses need to be forwarded.

1. Type in: iptables -t nat -A PREROUTING -p tcp -d –dport 554 -j DNAT –to-destination (here with port 554 is the camera’s IP, which is substituted by
2. Type in: iptables -t nat -A POSTROUTING -p tcp –dst –dport 554 -j SNAT –to-source (here with port 554 is substituted back with
All set!


6.1. Xeoma Pro – your own cloud service and pro surveillance system!

Xeoma Pro - your own pro surveillance system with cloud service See also Xeoma Pro video

Xeoma video surveillance software has proved to be an efficient, easy to handle, and flexible solution for both businesses and individuals that eager to use pro surveillance system.

Going beyond the borders of even such flexible software, Xeoma Pro now offers you an incredible opportunity to have your own cloud video surveillance server and offer it to your clients.

How it works:

Download Xeoma for your operating system, run and set up Xeoma Pro Cloud.
– Buy Xeoma Pro licenses for as many cameras as you need.
– Activate Xeoma Pro licenses the way you activate Xeoma regular licenses. You will be able to add as many cameras to your cloud service as your Pro license allows for.

It’s your cloud service now, and you decide on the terms of offering it to your customers – whether it will be a ‘per month’, ‘per year’ or ‘lifetime’ subscription and how much it will cost, total disk space assigned to each camera, and so on.

And with our free rebranding tool you can provide this service of yours under the name of your choice!

6.2. Xeoma Cloud Service

XEOMA CLOUD is video surveillance as a service. It means that we have Xeoma running on our cloud server and you can connect your cameras there.

Why is it great?

The server will take up all load, maintainence and update, while you can connect to it at any time to view your cameras, their archives, download records of interest and use all the usual features of Xeoma you might need in the cloud!

You don’t need to buy or maintain expensive video surveillance equipment. Just a camera and Internet connection is what is required.


How Xeoma Cloud is better than other cloud services?

With a lot of cloud services nowadays, here’s why you should choose Xeoma Cloud:

Quick start

Minimum requirements to start working with Xeoma Cloud – just a camera and Internet connection. No special knowledge required. Easy connection with step-by-step instructions and videos.

Cost-efficient and trouble-free

No need to buy a sophisticated up-to-date computer. Forget about maintenance costs and huge electricity bills for servers running 24/7. Xeoma Cloud servers are set up by our team of experts and is overall cheaper and easier than regular on-site video surveillance!

Stable and secure work

Your footage is safe in Xeoma Cloud video surveillance system – only authorized users have access to cameras, both in real-time and archive. Even if the camera is vandalized, they will never get the footage.

Sophisticated features

Unlike other cloud surveillance services that offer only motion detector and record (at best), Xeoma Cloud offers almost all of its regular features, including PRO features: emap, object tracking and visualization, integration with cashier registers and home automation systems, privacy masking, synchronized view of multiple archives, and much more!

Flexible pricing and NO hidden fees

Different, flexible types of subscriptions with What-You-See-Is-What-You-Get conditions allow you to find the right one just for you.

No ads, no logo watermarks

even in the free version!


Every subscription has:
No advertisements or logo watermarks in camera live view or in archive.
Unlimited live and recorded view.
Unlimited download of videos.
Any image resolution.
Unlimited fps.


How to use Xeoma Cloud

4 easy steps:

1. Get a subscription.

2. After having purchased a subscription, a letter will arrive to your email with the connection data and password. You will need to enter these data into Xeoma Client.

3. Download Xeoma Client from the download page.

4. Run it and enter connection data from the letter into the Connection dialog.

Cloud CCTV with XeomaCloud CCTV based on IP cam software XeomaCloud CCTV with Xeoma video cloud surveillance software


Why is cloud-based video surveillance better than regular PC-based installation?

  • saves you efforts, time and money
  • great for locations where 24/7 running of server is not possible or desirable
  • saves electricity
  • no equipment except for cameras is needed
  • perfect for cameras positioned in many locations
  • your records are not subject to theft, safe on our cloud server

If you want to have cloud cctv running on your server use Xeoma Pro Your Cloud


Xeoma, Xeoma Pro, Xeoma Pro Your Cloud and Xeoma Cloud comparison table

Get to know how Xeoma Cloud will help your business!

Try Xeoma Cloud now for free! Just contact us and request 1 day of free access to Xeoma Cloud!


Xeoma Cloud subscription Average time of storage* (1 camera, only motion) Average time of storage* (maximum cameras, continuous recording) Simultaneous viewers (via client / via web browser)
1 camera (maximum 1 GB) 5 days 12 hours 1
up to 2 cameras (maximum 5 GB) 24 days 2 days 2
up to 4 cameras (maximum 50 GB) 8 months 6 days 4
up to 8 cameras (maximum 100 GB) 16 months 6 days 8
up to 16 cameras (maximum 200 GB) 32 months 6 days 16
up to 32 cameras (maximum 400 GB) 64 months 6 days 32
up to 64 cameras (maximum 800 GB) 128 months 6 days 64

Buy Xeoma Cloud

*Storage time is unlimited, it depends on camera specifications and storage space provided by the subscription.
Average storage time in the table is just an approximate calculation of how long video can be retained before overwriting starts if the camera has 0.3 Mpix resolution (640 x 480 px) with 1 frame in 2 seconds refresh rate.
You can calculate your average storage time based on this information, or ask us.
Overwriting will write newest entries over your oldest ones.



You think you have an economical and easy cloud service. Not unless you tried Xeoma. Other cloud services trick you into buying their seemingly economical subscriptions by adding hidden costs for nearly every feature you want to add or disable (like watermarks). Also, they set very strict restriction on what cameras you can or cannot connect while with Xeoma Cloud you can use cameras of any resolution and refresh speed.

Possibilities Xeoma Cloud Traditional cloud services
No advertisements . .
No watermarks . .
Unlimited view time
(online and archives)
. .
Unlimited download of videos . .
Camera of any resolution . .
Any fps
(frames per second rate)
. .
Sophisticated features available . .
Flexibility of subscription . .
Clear conditions without extra fees . .
Continuous OR motion-triggered recording . .



The solution is ideal for cameras in single or multiple locations, such as shops, parking lots, schools and etc.!

  • Easy start – connect in 1, 2, 3!
  • There is no need to set up your own IT infrastructure;
  • When the purchased storage limit is reached, loop recording will overwrite old videos with new ones;
  • You can monitor how many subscription days are left;
  • You can use all modules of the regular version of Xeoma – detectors, sms or email sending, ftp upload, etc.;
  • Not available are only modules that cannot work in the cloud (screen capture, local USB cameras, local microphone, file reading, etc.)
  • Camera requirements: JPEG, MJPEG, H264, H264+, H265+, H265 or MPEG-4 stream with static public IP address that you can view from the outside Internet (or, if the address is dynamic, you can use any free DDNS service), router port-forwarding of the 80 port of the camera (you can consult this resource to learn how to do it:
  • Network requirements: depends on camera image resolutions and fps (for example, 2.2 Mbit Internet connection per 1 Full-HD camera with 2 fps, or 128 Kbit per 1 camera with 800×450 image resolution and 0.5 fps, besides the load of all other users in the network). Please pay attention that as the camera broadcasts the stream constantly, unlimited traffic Internet connection is preferred;
  • You can extend your subscription as your business grows – buy more storage space or connect more cameras.


SPECIAL OFFER! Contact us and request the free Xeoma Cloud test period!


If the camera has external static public IP address:
1. Connect to Xeoma Cloud using received connection data.
2. Run the advanced search by IP/password in “+” menu in the panel below.
3. Your camera will be found and added automatically.

If the camera doesn’t have an external static public IP address:
Get dynDNS or other substitutes of a static public IP address for the camera. Search the Internet for instructions and free or paid dynDNS services.

If you can’t get a static public IP address or dynDNS address for camera
See this article for workarounds for cameras without static public IP addresses.

1. Connect to Xeoma Cloud using received connection data.
2. Add a new chain (“Add new camera” option in “+” menu in the panel below) but connect the “FTP receiver*” module instead of the camera module.
3. Set up your camera’s FTP upload to upload to Xeoma as described in this article. Please note that in “Server address” in camera’s settings you need to specify*

*ATTENTION! If you’d like to use this method, make sure your camera supports FTP upload of pictures, before you buy Xeoma Cloud subscriptions. Contact us to request a free test period to try it.

If neither of the options works for your cameras, you are advised to have a Raspberry Pi or other simple and cheap micro computer ($50) on site where your cameras are, install regular Xeoma there and use the FTP Upload option to upload footage to Xeoma Cloud. See more about Raspberry Pi and FTP Upload.

How does the cloud work for your business


6.3. Customizing Xeoma video surveillance software

This is a unique special offer for installers and resellers!

If you resell or plan to resell Xeoma video surveillance software, why not add some info about your company into it?

Customizing Xeoma is easy with our free of charge utility. This utility can be used for rebranding of Xeoma to have a different name, customizing it to have your company’s name, address, support business hours, links to your site, add splashscreen, change Xeoma’s icon, etc.

Seize this opportunity for rebranding Xeoma totally free! Thanks to customizing, Xeoma will not just be a program that is tailored for your customers’ needs but also reminds them about your company!

You can download the rebranding utility for customizing Xeoma here.

This is a Windows .exe file that will let you customize Xeoma for Windows, Linux, Android and Mac OSs. You are free to use any or all of the options.

Having troubles trying to make it work? Check out our new step-by-step guide on using the free rebranding utility in our Photo instructions section.


7.1. Uninstallation of the program

Uninstallation of the program is easy.

If you haven’t installed Xeoma manually, you can just delete the launching file and that’s it.

If you have installed Xeoma, just go to the installation menu in the program and choose Uninstall ALL.

In case you only want to re-install the program, choose Uninstall except for archive and settings. Your server and/or client will be deleted from the autostart but settings (including passwords, license information and modules’ settings) will remain the same.

7.2. Tips how to reduce CPU usage, memory load and required disc space

CPU usage will be significantly lower if you use MJPEG stream for view and storing to the archive (or just viewing). Learn how to reduce CPU load in this article.

RAM usage can be great if per-record option in Motion Detector is used. If the load is too high for the machine, turn the option off.

HDD space: storage capacity depends on many factors in the field of the view, but remember that required disc space can be reduced by setting up motion and day detectors, or with scheduled recording. Another option is to use Saving to File module to save videos with other codecs (for example, highly compressive H.264) – this way videos won’t take so much space but will not be played with the built-in player of Xeoma either. Or, if yours are rtsp (H264) cameras, you can use direct saving to archive without re-encoding.


Typical applications. Scenarios.

Xeoma for CCTV operator

Xeoma for CCTV operator

Xeoma for CCTV operator

Aim of video surveillance for CCTV operator: to make live monitoring easier for surveillance officers despite natural challenges like distraction, fatigue and loss of concentration in proportion to time and amount of cameras to monitor.
Solutions from Xeoma:
User profiles with ability to restrict/allow access to certain cameras, archives and functions. Create specific user profile and let the CCTV operator know his/her password to connect to Xeoma server.

Managing large amounts of cameras:
-In the “Layouts” menu you can divide cameras into groups and set up automatic scrolling to view cameras one by one or by groups. Watch video about Layouts
Support for multiple monitors. Divide cameras into groups in Layouts menu. Run several Xeoma Clients. Log in with the operator’s user profile password. In each Client select to show different groups of cameras. Drag Clients to separate monitors. Each monitor will show a certain group of cameras.
Enlarge triggered camera: Go to Layouts -> Larger grid -> Form by detectors to make Xeoma automatically put camera that detected motion into bigger slot thus calling for CCTV operator’s attention.
Show red cross option in Layouts will indicate when a camera froze with a big cross over its image. It’s especially useful when large amount of cameras are monitored and camera preview boxes are thus too small to tell instantly if a camera is no longer working (probably, tampered with).
eMap (interactive map of the surveillance object) and Device List (list of cameras divided into groups with quick jump to the needed camera)

Enabling CCTV operator to work with other tasks while monitoring.
Transparency (Layouts menu -> Window settings): make Xeoma window half-transparent to allow operator do other work and still be in tune with what is going on (for Windows).
Pop-up Window module will un-minimize Xeoma window when triggered (for example, when motion is detected). At other times, Xeoma window can be minimized and you will still not miss what’s important.

Remember that Client parts are free of charge. License is only needed for the server.

Recommended products – Xeoma or Xeoma Pro when needed

Xeoma for security administrator

Xeoma for security administrator

Aim of video surveillance system for security administrator: to create a video surveillance system flawlessly running without human supervision.
Solutions from Xeoma:
-Work on Linuxes supported, including in console.
Install Xeoma for stand-alone work and for automated restarts.
Change installation folder (Main Menu -> Install -> Install).
-Set your commands for Xeoma to execute – for example, disk mounting or launching of executable files (Main Menu -> Install -> Autostart settings).
Problems Detector module will notify you (Email, SMS) about suspicious changes in cameras’ field of view or system health issues.
Logs (console command ‘-logs’) will save system information (camera added, client connected, etc.).
Multi-server mode allows to connect to several Xeoma servers at once.

-‘Create user profiles for operators.

Recommended products – Xeoma or Xeoma Pro

CCTV For Home

CCTV For Home with Xeoma video surveillance software

Aim of CCTV for home: to protect your house and the front yard from strangers’ intrusion.
Solutions from Xeoma: 
Motion Detector module allows you to detect moving objects and start recording. Sending Email module will inform you about emergencies by email. 
Web Server will let you broadcast the images from your cameras to a website. This gives you the opportunity to share the image with your family or friends. 

Recommended products for CCTV for home – Xeoma Lite or Xeoma

Office security with Xeoma

Office security with Xeoma

Aim: to provide security of the whole territory.
Solution from Xeoma:
E-map shows all your cameras on your floor plan. In case of emergency allows to see cameras’ exact position on the territory and send help immediately.

Aim: to control employees’ attendance.
Solution from Xeoma:
Visitors Counter module allows you to count employees entering and leaving the office. Face Detector module will automatically find a face. If your cameras can Pan Tilt and Zoom, then PTZ Tracking will automatically follow a moving object.

Recommended products – Xeoma or Xeoma Pro

Retail store security with Xeoma video surveillance

Retail store security with Xeoma

Aim of retail store security: to reveal frauds, to solve claims, to control shortage in the cash.
Solution from Xeoma:
HTTP Marking allows you to synchronize Xeoma with a cash register and controll till slips.

Aim of retail store security: to control store traffic.
Solution from Xeoma:
Visitors Counter module allows to count people entering and leaving the store. All the received data will be sent to CVS file where you can analyze it.

Aim of retail store security: to prevent breaking in through a window.
Solution from Xeoma:
Sound Detector will start working if a loud sound detected (the sound of breaking window or the sound of security alarm). 

Aim of retail store security: to prevent stealing surveillance records in case of robbery.
Solution from Xeoma:
Xeoma Cloud or Xeoma Pro Your Cloud will safely keep your records on cloud. You don’t even need to put a computer at a store, the only thing you need is a camera. And even if the camera is stolen – your records are still safe and available for you at any time.

Recommended products – Xeoma, Xeoma Pro, Xeoma Cloud.

School security with Xeoma 

School security with Xeoma

Aim: to control students’ activity in a computer class, to provide school security.
Solution from Xeoma:
Screen Capture module will let you see what is happening on computer screens. 

Recommended products – Xeoma, Xeoma Pro.
20% discount for Xeoma licenses for educational institutions

Hospital security with Xeoma

Hospital security with Xeoma

Aim: to control medical staff, to monitor patients’ condition, to provide hospital security.
Solution from Xeoma:
Sound Detector will indicate whenever there is a beeping from hospital facility (which might indicate something goes wrong with patient’s condition) or a scream for help. Visitors Counter module can tell how frequent the hospital staff comes to the patient’s room, it helps to check if the patient is being treated right and that he’s not left without proper attention.

Recommended products – Xeoma Pro.

Airport security with Xeoma

Airport security with Xeoma

Aim: to control forgotten and unattended items, to provide airport security.
Solution from Xeoma coming soon:
Object Detector module will notify you if an object is left unattended for some time.

Recommended products – Xeoma Pro.

Typical video surveillance goals and how to do that in Xeoma

Use video source that is not a camera (Screen Capture, File Reading, etc.) – add a default scheme through the “+” menu in the lower panel, remove the Universal camera module, and replace it with the needed module from the upper panel

Fisheye dewarping – Fisheye Dewarping module

Automatic search for faces – Face Detector module

Interactive map of objects – eMap option in ‘Layouts’ menu

Cashier register/POS synchronization with IP cameras – HTTP Marking module

SD card synchronization – Download from SD card option in the Preview and Archive module

Crowd detection – Face Detector module

Restricted areas trespassing – Motion Detector module

Simultaneous view of several archives at once – the ‘Play’ button in the lower panel

Cross-line detection and alarms – Visitor Counter module in combination with needed notifications modules

Blurring (masking) image areas facing private property – Privacy Masking module

Following moving objects (tracking) – PTZ Tracking module in combination with Motion Detector

Motion visualization on preview – Visualization settings menu in Layouts menu in the lower panel

Motion visualization in archive – Visualization settings menu in Layouts menu in the lower panel

Motion track visualization – Visualization settings menu in Layouts menu in the lower panel

Motion detection – Motion Detector module

Detection of lack of motion – the ‘Detect only the absence of movement’ in Motion Detector module

Clouds and shadows false alarms elimination – ‘Compare to the accumulated background’ detection method in Motion Detector module

False alarms elimination – ‘Sensitivity threshold’, ‘Object size’, ‘Disregard motion shorter than’ options and detected area in Motion Detector module

Staff monitoring – Motion Detector, Face Detector, Screen Capture, Microphone modules

Loud noises detection (e.g. glass break, gunshot, explosion) – Sound Detector in combination with Microphone or Universal Camera modules

Object Detector – Object Detector

Quick turning on/off of recording or any filter or destination modules remotely (e.g. automatically by automation systems or manually in browser) – HTTP Switcher module

Quick turning on/off of recording or any other modules from Xeoma’s interface – Button Switcher module

Quick turning on/off of cameras from Xeoma’s interface – ‘Turn cameras on/off’ option in the Main Menu

Quick turning on/off of all modules from Xeoma’s interface – tick/untick modules in the popup left panel of the Quick settings screen

Recording only in daytime – Day Detector

Recording only in night time – Scheduler module

Recording at specific time, date – Scheduler module

Turn on one camera if another is down – Relay Switcher module

Wrong direction detection – Cross-line Detector module

Email notification about emergency – Email Sending in combination with Motion Detector, Sound Detector, Problems Detector, etc.

SMS (text message) notification about emergency – SMS Sending in combination with Motion Detector, Sound Detector, Problems Detector, etc.

Get notification if cameras are down, ‘freeze’ – Problems Detector + Email/SMS Sending

Get notification if cameras are tampered, obscured – Problems Detector + Email/SMS Sending

Get notification if disk space is running out – Problems Detector + Email/SMS Sending

Get notification if RAM is running out – Problems Detector + Email/SMS Sending

Get notification if processor load is too high – Problems Detector + Email/SMS Sending

Get notification if modem/router/Internet is down – Problems Detector + Email/SMS Sending

Get notification about emergency restarts of Xeoma – Problems Detector + Email/SMS Sending

Get notification about database problems – Problems Detector + Email/SMS Sending

Save logs about problems, errors and program events – ‘Record found problems to the log file’ option in the Problems Detector module

Record two or more cameras into 1 archive – Unitor module

Change image resolution for both preview and all following modules – Image Resize module

Change image resolution only for archives – option in Preview and Archive module settings

Save videos to archive with lower quality or lower fps to save space – option in Preview and Archive module settings

Embed cameras into your site – Web Server module

View cameras in browser – Web Server module

Add date and time overlay to preview and archive – Marking module

Add custom text overlay to preview and archive – Marking module

Add GPS overlay to preview and archive – Marking module

Change font size for Xeoma’s marking overlay – option in Marking module’s settings

Change font size for camera’s own date/time overlay – check settings in camera’s web admin page (outside of Xeoma)

Change font size for camera’s name on Main Screen – option in Layouts -> Window settings

Reports of people count entering or leaving – ‘Save data in CSV report’ in Visitor Counter module

Control of camera’s pan, tilt, zoom functions, Xeoma interface – PTZ control in lower panel or on camera’s preview box. See also

Control of camera’s pan, tilt, zoom functions, browser view – PTZ control in Single Camera view mode (PRO license required)

Connection of camera’s PTZ – Universal Camera module settings

Create user profiles (operators) – ‘Users’ menu in Main menu -> Remote access

Restrict access to certain cameras/functions to certain operators – ‘Users’ menu in Main menu -> Remote access

Change administrator password/remote access password – ‘Users’ menu in Main menu -> Remote access

Lost administrator/remote access – console command -showpassword

Quick addition of preset chain with optimum settings – Ready-to-use chains in the upper module panel

Remote access to a remote Xeoma server – Main menu -> Remote access

Simultaneous view of cameras from several servers (network clustering) – Main menu -> Remote access -> Multi-server mode

Connection to a remote server that has no external IP address – Repeater

Emulate MJPEG IP camera – Web Server

Emulate H264 IP camera – RTSP Broadcasting module (PRO)

Upload JPEGs and videos to an FTP server – FTP Upload module

Send http requests to other devices – HTTP Request Sender

Grouping of cameras – Device List in Main menu

Screen capture in Live View – ‘Screenshot’ option in Main menu or ‘Screenshot’ button in the lower panel

Screen capture in archive – ‘Screenshot’ option in archive viewer‘s menu

Periodic automatic screen captures – Screen capture module

Parental control – Screen capture module

Image zoom in archive viewer – Turn zoom on/off in the archive viewer menu (PRO)

Download videos from the archive viewer – ‘Export’ option in the archive viewer menu

Use JPEG image or MJPEG video as a video source – File reading module

Use video stream broadcast by other Xeomas as a video source – Another Xeoma module

Broadcast video or audio stream to other Xeomas – HTTP Upload module

Use video sent through FTP server as a video source – FTP Receiver module

Change language – ‘Language’ option in the Main menu

Use LDAP authorization data in Xeoma – LDAP settings

Ghosting of videos or still images – see troubleshooting of image distortions

Save videos in the format of choice – Save to File module

View archive records – ‘Play’ button in the top right corner of camera’s preview box (Preview and Archive module is required)

Search by date, time in the archive viewer – use the archive viewer’s timescale and calendar button

Activate Xeoma/Xeoma Lite/Xeoma Pro license (switching to the commercial version, registration) – Main menu -> Registration -> Activate (corresponding license required)

Activate renewals for Xeoma/Xeoma Pro licenses (extend the free updates period) – Main menu -> Registration -> Activate (corresponding renewal key required)

Activate Repeater – Main menu -> Remote access -> Repeater setup -> Subscription (Repeater subscription required)

Activate renewals for Xeoma Lite – Xeoma Lite doesn’t support that feature

View information about your activated licenses – Main menu -> Information -> Active licenses or Main menu -> Information -> About

Remove a module from a scheme – Recycle bin in the module’s settings; click on white wire connecting two modules; drag the module back to the top module panel

Add a module to a scheme – drag the module from the top module panel into the needed place in the scheme; click on the module in the top module panel

Change cameras order – drag camera’s preview box to the desired place

Put camera in a large slot surrounded by smaller camera slots – option in the ‘Layouts’ menu in the lower panel

Pop Xeoma window up when triggered – Pop-up Window module

Ring alarm when triggered – Sound Alarm module

Switch into the trial mode – option in Main menu -> Registration

Check if newer version of Xeoma is available – Main menu -> Information -> Check for updates

Update Xeoma to a newer release version – Main menu -> Information -> Check for updates

Update Xeoma to a newer release version – ‘Update to beta versions’ option in Main menu -> Information -> Check for updates

Protect access to Xeoma server with a password (on the same computer) – Tick the “Use this password…” option in the Installation dialog and untick “Remember this password” in the Connection Dialog

Scale interface (for example, for mobile displays) – option in Layouts -> Window settings

Easy start guide even for newbies

When you launch Xeoma for the first time, this is what you’ll see:

Interface is both easy to use and hard to rival

You can click a couple of times on an empty space to skip all the messages and start working. If your cameras are within the same local network-
– Hold on! How do I know whether they are or aren’t?
Local network is the one created by your router. Basically, any device within its reach is part of that network. So, if the cameras are not particularly far from that router, you can safely assume they are in the local network. The easiest way to check is to access the router’s admin page in a browser: it should contain a list of all connected devices. Note the IP addresses for those devices – they should look something like this, These are local IP addresses, so you can’t use them outside.

Adding these cameras is simple: “+” → Simple search for local cameras:

A simple system of searching

Soon enough you’ll see the cameras:

See? Surveillance CAN be easy to use

A simple system, isn’t it? You may see this message during the search:

Just another simple system of protection

The information needed here should be mentioned in the cam’s manual (if it’s standard admin/admin, then you won’t even need to input anything yourself – Xeoma will use these credentials automatically).

Now, if the cameras are in different networks, then they’ll need static public IP addresses. You can get those from your Internet provider (they’ll instruct you on how to use it as well). When the camera has the static public IP, you can add it in Xeoma by going “+” → Search by IP/password. You’ll see this window:

Xeoma makes it easy to use the search for cameras

You should know the username and password, the IP is the one your Internet provider gave you, the port is typically 80. Sometimes cameras can have unusual ports, you can check the admin page to make sure. The right page should look something like this:

Even a camera is controlled by a simple system

Once the cameras are added, you can consider this machine your server. You can take a look at the settings by pressing the gear button. As you can see, Xeoma uses a simple system of chains. This is the standard chain of modules Xeoma creates for every camera:

Easy to use modules

It works in 2 ways simultaneously:

  1. during the right time (the one set in the “Scheduler”) the “Motion Detector” switches on and stores all the motion in the “Preview and Archive”;
  2. if something happens with either the camera or the server, the “Problems Detector” informs the “Sending Email” module, which will notify you about the issue.

Your surveillance system is pretty much ready, you just need to spend a bit of time setting up the “Motion Detector” and “Sending Email”.

If you’d like to check your server from a different device (e.g. your Android or iPhone), you can connect to it remotely. Any of these devices will be your client. This a simple system called “client-server architecture”. Just download Xeoma app for them and go Main menu → Remote access → Connect to. You’ll see this window:

Remote connection is a simple system

You’ll need to put your server’s IP in the first bar. If both the server and the client are in the same network, the server’s local IP (192.168.x.x) will be sufficient. You can learn your server’s IP by checking this same window on the server – it will show you the exact IP in the IP address of this computer to connect to. If not, the server will need either a static public IP or an activated Repeater (an easy to use solution for that problem).

There is one more step left to make your system independent. In case your server reboots, you want Xeoma to launch automatically, so that you don’t lose any footage. This is easy to set up by going Main menu → Install → Install and CHECK the box Autorun the server part of Xeoma as service.

Installing Xeoma video surveillance software for Linux without graphical shell (for example Raspberry Pi on ARM) (via Terminal)

If your Linux is a server version or if you want to do the same through a console, run the Terminal and execute

wget (for 64 bit systems)


wget (for 32 bit Linuxes).

Unpack the archive with the tar command.

Manual for Xeoma video surveillance software for Linux without graphical shell: Download the right file and unpack

After unpacking is done, you will get the file. Run it to start Xeoma (both server and client parts at once). When you access the file, the short help will be displayed with commands that can be used.

Manual for Xeoma video surveillance software for Linux without graphical shell: Short help displayed when accessing Xeoma file

Running will only be good if your Linux has a graphical shell. The client part – the visual part – will then be displayed:

Manual for Xeoma video surveillance software for Linux via console: Run simply by accessing Xeoma app

Otherwise, you can just run the server part without displaying the visual part (the client part):

Manual for Xeoma video surveillance software for Linux without graphical shell: Run the server part alone and view help info

You can change language via console, install and uninstall the program, run it and activate it.

Manual for Xeoma video surveillance software for Linux without graphical shell: Run the client part and other commands

To setup other features (for example, add and configure cameras, add user profiles, change password and set it for local access, etc.) you will need to connect to this server part from a client. The machine with the client part must have graphical shell. This can even be your Android smart phone.

As you see, Xeoma video surveillance software for Linux is as easy to handle as Xeoma for other operating systems. Moreover, you can save not just nerves and time but also money with Xeoma on Ubuntu or other Linux distros.

Console commands

When you access Xeoma in a Terminal, you’ll get these regular commands displayed:

Usage: [-command] [-argument]

-help (show this help)
-core (run server only)
-client (run client only)
-install [-argument] (working with argument only)
-allmanual (install Server and client with manual start)
-allauto (install Server and client with auto start)
-coreauto (install Server (autoStart) and client (manualStart)
-hiddenmode (install Server (autoStart) hidden mode used)
-removeall (remove all, include Archive and config files)
-removeexe (remove program. Leave Archive and config files)

-activateOnline [Serial],[Serial];…
-activateRequest [Serial];[Serial];… (offline activation)
-activateResponce [ActivationData] (offline activation)
-showpassword (show current password and set enable network access)
-startdelay [seconds] (delay before starting in seconds)
-log (enable log for server events)
-lang [Language] (for English: en, for Russian: ru, etc.)
-clientIndex [ClientIndex] (client ID can contain only letters and numbers (no spaces, maximum 16 characters)
-individualsettings (store personal settings individually for each client)
-cloud (start Cloud server with auto restart on crashes)
-noguard (use this parameter with -cloud to run Cloud without restart guard)
-sampleconfig (use this parameter with -cloud to generate sample config in Cloud mode)
-nohup (ignore the HUP (hangup) signal)
-noscan (disable camera scanning)
-proxy [ProxyServerURL] (Set proxy server address)
-proxyclear (Remove stored proxy server address)
-noarchivedb (Disable archive database (search in archive will be not available).
-activateRetranslator [Serial] (online activation of retranslator (separate Serials with ‘;’. For example: -activateRetranslator ‘Serial1;Serial2’)

Note: for -activateOnline if you want to use “;” instead of “,” as a delimiter, please put serials into ‘ ‘. For example: ./xeoma -activateOnline ‘LKB6CWP10WBPVW5KFGRЕ226UV;NK5XWLJUVММ9TММХСХDLV24E6’

Here are some additional commands you could take advantage of:

-setpassword MYPASS (set MYPASS or another password for Administrator profile, the password that is used for remote access)

-serverport 777 (set 777 as Xeoma port instead of the default 8090, can be any number).

for Linux: /etc/init.d/XeomaCoreService
for Mac: /Library/LaunchDaemons/XeomaCoreService.plist
for Windows: in the settings of services (Administrative Tools)
Edit it with admin rights. Restart the server part thereafter.

-noscan (cancel initial search for cameras). Attention: doesn’t work for servers installed to autostart. See -serverport to learn how to make it work.

For a detailed instruction on how to work with Xeoma on Linux (with or without graphical shell), please see this article.

Changing camera layouts via configuration file

Starting from Xeoma 14.5.13, layouts can be controlled without the visual part via configuration file. For example, when integrated to your home automation system, it will help you choose camera layouts switch between live camera previews simply by pressing a button on a remote controller.

Changes should be applied to the Preview configuration file in Preview configuration folder in Xeoma’s directory:

# Use PreviewMode variable for setting preview mode, TabNumber for setting tab number.
# PreviewMode possible values are:
# 0 for all cameras
# 1 for 1×1
# 2 for 2×1
# 3 for 2×2
# 4 for 3×2
# 5 for 3×3
# 6 for 4×3
# 7 for 4×4
# 8 for 5×4
# 9 for 5×5
# 10 for 8×8

Replace 0 in PreviewMode=0 with 1 to enable the 1х1 layout (one camera on screen at a time), with 2 to enable the 2х1 layout, etc. Replace 0 in TabNumber=0 with the number of a tab you’d like to open. Please note: Xeoma should be launched and working when you apply those changes.


1. Error cannot execute binary file (at launch)

If you’re getting an error message as follows:

root@myUser:/home/myFolder# uname -a
Linux myUser 2.7.32-504.el6.i686 #1 SMP Wed Oct 15 03:02:07 UTC 2014 i686 i686 i386 GNU/Linux
root@myUser:/home/myFolder# ./
bash: ./ cannot execute binary file

Please make sure that you are launching 32 bit Xeoma on 32 bit Linux, or 64 bit Xeoma on 64 bit Linux. Installing ia32-libs might help, or simply use Xeoma of bit capacity that matches your OS’s bit capacity.

Another reason for this error might be insufficient rights. In such case please try to execute chmod 777 in the folder where your is, and then launch Xeoma server again ( -core).

2. Error “Access denied” (at launch)

If you’re getting an error message as follows:

bash: ./ Access denied

This error can occur if you’re trying to launch Xeoma on a USB stick or a disc mounted into the system with a noexec parameter. We recommend to try to launch Xeoma on a system disc or disable execution restrictions.

3. Error Fail (at installation)

If you’re getting the error as follows during installation

[root@myUser ~]# ./ -install -coreauto

install server (auto start) and client (manual start) ... * Ok > installFiles

* Ok > popClientFromAutorun
*** Fail > installCoreShortcut
* Ok > removeExeOnly
* Ok > unRegisterInSystem
* Ok > revertOldXeomaVersion
*** Fail > installCoreAutostartOnly

please install the xdg-user-dirs package and run installation again.

If none of this helps, please contact our technical support with the description of the issue.

Web server customization for online view of cameras in Xeoma

Starting with Xeoma 13.9.30, along with rebranding opportunities, Xeoma offers you to customize its web server pages to make them look the way you want.

To do that, you will need to the following:

Connect Web server module to the cameras you’d like to view in web server.

Web server customization in IP camera software Xeoma: Attach the Web server module to the cameras you'd like to view in web server

Enter the Web server module settings and visit the pages in a browser that you’d like to customize.

Web server customization in IP camera software Xeoma: Visit the pages in a browser that you'd like to customize

In Xeoma directory a XeomaWeb folder will appear:

Web server customization in IP camera software Xeoma: XeomaWeb folder will appear in Xeoma directory

In XeomaWeb folder you will see the needed html pages.

Web server customization in IP camera software Xeoma: In XeomaWeb folder you will see the needed resources

This is where you need to place all resources you are going to use (icons, pictures, other pages). To access the graphic files, you will need to use a path like img src=”?obj=PictureName.png”.

Web server customization in IP camera software Xeoma

Open and edit the needed html pages (even Notepad will do).

Web server customization in IP camera software Xeoma: Edit the pages the way you want

Here is an example of a customized page: changed are the title of the page, browser icon, and the contents of the page.

Web server customization in IP camera software Xeoma: An example of a customized page

You can also access other pages from the directory:

Web server customization in IP camera software Xeoma: Access to other pages

Xeoma settings

Sometimes, like in this case, you need to find where Xeoma stores its settings files. Xeoma settings are stored in default user directory.

For Windows it’s:

C:\Users\Public\Documents\Xeoma\ (either if Xeoma is installed or not installed)

For Linux:

/home/USERNAME/.config/Xeoma/ (not installed)

/usr/local/Xeoma/ (installed)

For Mac OS X:

Users/USERNAME/Xeoma/ (not installed)

Users/Shared/Xeoma/ (installed)

Please be careful: deleting settings files will erase all settings changes you applied, passwords, etc.

Change camera order

To change camera order on the Main Screen (Real Time View Window), just drag cameras one by one to a new place.
Default camera order
Drag a camera to a new place
New camera order

Multi-server mode

Multi-server mode is very useful for the control of large holdings with offices in different cities around the world and a multi-level control system. In such systems, servers might be located in different locations geographically, and even in different cities. The work of the situational monitoring centers of the territorially separated surveillance objects. Support for multi-server scalable configurations with the unlimited number of video cameras / servers / clients. Allows to combine systems in a structural hierarchical tree with the central unit, which allows to perform management from anywhere in the system. With Xeoma’s Multi-server mode you can connect to all of them at a time and/or switch between the offices to get the full insight and raise the efficiency of monitoring. Simply add all server you’d like to connect to to the list in Main menu -> Remote access -> Multi-server mode.

If, for example, you need to view cameras from several servers at a time, then view cameras from several other servers, and then reconnect to the first group of servers, you can use grouping in Multi-server mode for quick access this or that group of servers. This configuration can be done in two ways.

Method #1

Add all servers you’d need to connect at various times. To do this, enter the servers’ IP address, port and password in the field “List of Xeoma servers to connect to”, and then click “Add server”.

Multi-server mode

Then, when all servers are added, add the names of the groups. Enter a new name in the “List of server groups to connect to” instead of the name that is already there, and click “Add group”.

Multi-server mode

Now when you have added all the servers and groups, we turn to fine-tuning the groups. Open a group, and remove unnecessary servers, that you will not need this group to connect to, from the list (it does not affect the server lists for other groups). Do the same for other groups, leaving only those servers inside a group that you’d want to connect to when you select this group.

Multi-server mode

Method #2

It is suitable for those who have just a few servers and only several groups to connect. You can add the name of the group and immediately add all the needed servers to it.

Multi-server mode
Multi-server mode

*There is a limit on the number of external client connections to the server, caused by the limited read/write HDD speed (when accessing the archive) and the speed of the network interfaces, depends on requirements to fail-over protection, as well as on the processing capacity of the servers.


If you don’t have the static public IP address, you can use the ‘Repeater” function. Using this type of connection you will be able to view cameras and archive, change settings.

The ‘Repeater’ function is available 10 min per day for free. You can buy monthly or yearly subscription.

You also need to install Xeoma on the PC #1 (server).

Then you should go Main menu ->Remote access -> Repeater setup

Address and password for ‘Repeater’ will be generated automatically. Please make sure the box ‘Repeater is on’ is checked.

Repeater function setup

Write down the repeater’s address and password.

On PC #2 run Xeoma and go to Main menu ->Remote access -> Connect to

Type the password and address.

Xeoma server part connection setup via Repeater

You can also watch the videotutorial on how to work with the ‘Repeater’.

How to activate the Repeater?

To activate the Repeater license сhoose the “Subscription” option, enter your serial number and click “Activate” button.

How to activate Repeater

Step-by-step guide on using free rebranding of Xeoma

Download the free rebranding utility from our site and unpack the archive. You will get a rebrand_bundle folder. Follow the instructions in the readme.txt file in this folder to customize Xeoma.

Please note that the rebranding utility only works under Windows but you can customize Xeoma for all operating systems Xeoma supports with its help.

Xeoma video surveillance software: free rebranding utility works for all Windows, Linux, Mac OS X and Android

Customization process consists of a few simple steps:

1. Place Xeoma that you’d like to customize into the distrib folder, subfolder with name corresponding to the operating system.

Xeoma video surveillance software: place the distribution to customize into the distrib folder

2. If you’d like to change the icon of the program, place the new icons into the icon folder – .ico for Windows, .png for Linux и Android, .icns for Mac OS X.

If you don’t need that, you can leave the original Xeoma icons or leave this folder empty.

Xeoma video surveillance software: changing icon

3. The oem_info.xml file in the custom folder is where you can change the program’s name, add information and contacts of your company, hide or show some menus, make Xeoma run as client only, and so on. You can open and edit it in a text editor. Then save the changes.

Xeoma video surveillance software: editing the main customization file to change the program's name, add information, etc.

4. You can change background color, modules icons, add splash screen in the skin.xml text file in the custom folder. You can open and edit it in a text editor. Then save the changes.

Xeoma video surveillance software: changing program's colors, module icons, adding splashscreen with the free rebranding utility

5. After you’ve prepared everything, run the customize.bat file. A console will be shown:

Xeoma VSS customization and rebranding utility: console showing customization progress

6. There will be a log file named customize.log created in the rebrand_bundle folder. Open it to see the information about successfully completed rebranding or customization errors.

Xeoma video surveillance software: rebranding utility log

7. After the console closes and there’s a message about successful customization in the log, you can find the customized new program based on Xeoma in the distrib folder:

Get the rebranded video surveillance software based on Xeoma in the distrib folder

8. Run the new program. In our example, we change the program’s name and logo.

A rebranded video surveillance software with a new logo and name

9. If Xeoma was not launched or activated on this computer before, customized version will look like this:

Xeoma video surveillance software modified with the rebranding utility: unregistered version's intro window

10. If you install your customized Xeoma with a new logo via Main menu > Install > Install, you will get the shortcuts with the new logo as well (except for if you tick the Hidden mode installation, in which case no shortcuts are created at all):

Xeoma video surveillance software modified with the rebranding utility: shortcuts with a new logo

Device List (devices by groups)

Handy when working with many cams. Quick jump to the selected cam. Cameras grouped.

After your cameras are set up and laid out on the preview, you can change camera’s name and specify what group it should belong to. Put it in square brackets:


Then, turn on the Device List in main menu by selecting the ‘Devices by groups’ option:


The panel will be opened on the left side. It can be dragged horizontally. When you click on a camera in the list, it will be opened. In the example, we divided all cameras into 2 groups – ‘Outside’ and ‘Interior’.


The same camera can be added to several groups. To set it, type the names of the groups the cam should belong to, in square brackets, one after another.


You can also put the camera into a subgroup. Use / to create a subgroup inside a group:


‘House’ is a group. ‘Kitchen’ and ‘Room’ are subgroups. Below are 2 cameras that belong to the ‘House’ group but not to any of the subgroups:


By clicking on a Group/Subgroup name you can expand or, if was already expanded, collapse the list of cameras that belong there:


To close the Device List, click on the x button in the right upper corner.

FTP-receiver: easier way to connect your camera

You can make your camera stream image to the server via FTP. It’s convenient when you don’t want or cannot perform port-forwarding on your router at the place where camera is located, or when there’s no IP address that can be assigned to the camera (like when the camera is connected via the mobile Internet) thus no program can find it.

First of all, naturally, you camera must have support for this feature. There are just too many manufacturers today for us to be able to tell if your camera has it or not so please refer to the camera’s documentation in case of doubt.

First step is adding a scheme with FTP receiver as a source module in your Xeoma.

Add FTP receiver module

There will be no image yet, but there will be settings that you need to use in camera FTP streaming setup like port (changeable), user name, password and server address (not changeable). You will need this data later on. Tip: if you need to change the password, remove this FTP receiver module and add another – new password will be generated for the new FTP receiver module.

In FTP receiver settings you will see the server's login, password, and port

Next step is to go to the camera settings and on to the FTP streaming settings. You should look for tabs like “Event Setup”, “FTP” or the like.

In camera settings, go to Event Setup or FTP tab

In this configuration page you need to enter FTP receiver’s data: IP address (host) where Xeoma with FTP receiver are, port, username, password. Folder or Directory Path can be of any name, however some restrictions may prohibit use of special signs, so we’d recommend to keep it simple.

In FTP server configuration enter FTP receiver's connection data

If all is correctly set up, the FTP receiver will start showing picture from the camera.

If all is correctly set up, FTP will start to get image from the camera

Dual streaming with rtsp (h264) cameras

If yours are h264 (rtsp) cameras and you would like to reduce CPU load, you are welcome to try Xeoma’s new option to store high resolution video streams directly into archive, without re-decoding the streams.

If you are using h264 (rtsp) cameras, you might well be receiving many Mpix image from your camera and seeing it in the preview window. But as often as not, the priority is not the ability to view cameras real-time but to store high quality into the archive:

Reducing CPU load with Xeoma webcam software: High resolution RTSP stream, preview window

If the machine is slow or you have many high resolution rtsp cameras, it may cause intense CPU load resulting in image distortions:

Reducing CPU load in Xeoma: Image distortions

In both these cases we recommend to try the direct storing into archive without re-decoding. To do that, please go to the camera’s settings in Xeoma. You will see there that the regular URL to work with the camera is given in “Full URL for IP camera” field:

Reducing CPU load with Xeoma software: Regular URL for RTSP stream

To establish direct saving into archive, paste the URL for hi res RTSP (h264) stream into “Full URL address of the RTSP (h264) video stream…” field. In regular “Full URL address for IP camera” you can specify a jpeg/mjpeg/rtsp URL for lower quality stream (for preview and detectors’ work):

Reducing CPU load in Xeoma software: URL for preview and URL for direct storing to the archive

You will see a lower quality picture in preview window.

How to reduce CPU load with Xeoma: Lower quality preview when the preview is not necessary

But you will get maximum quality footage stored into the archive at the same time:

How to reduce CPU load in Xeoma software: Maximum quality footage stored to the archive at the same time

If you don’t know the URL for a stream of lower quality, or simply don’t want to use it (when real-time view is not necessary), you can leave this field blank:

How to reduce CPU load with Xeoma: You can leave the preview URL field empty

You will know that the recording is on and going well by this sign:

This sign in Xeoma webcam shows that saving to the archive goes well

Even without lower quality stream showed in preview, you will get a high quality stream stored to the archive, and CPU load will be significantly lower.

High resolution stream saved into Xeoma's archive, and CPU load is significantly reduced

How to set Xeoma on Raspberry Pi with ARM processor

Are you still using expensive video surveillance equipment? In this manual we are going to disclose a secret how to make your videosurveillance cheaper. For this you will need Raspberry Pi single-board computer, Xeoma and a simple IP camera. This will be Raspberry Pi security system!

Raspberry Pi security system
Connected Raspberry Pi

You can easily buy Rasberry Pi on eBay for $20 and Raspberry Pi 2 for $40.

Please download Xeoma ARM version:

Download Xeoma ARM version

Then you need to unzip the downloaded file:

Unzip the downloaded file

Now let’s install the server to the auto start:

Install the server to the auto start

Please make sure that Xeoma process is really started:

Make sure process is really started

In the end, we need to know device IP address and password:

Find IP address for remote connection

Find password for remote connection

Now, download the client for any operating system and use remote access to connect. In the remote access option enter device IP address and password.

Now configure your camera in the Raspberry Pi security system!

Moving Xeoma video surveillance program records

When you copy the records back from the backup into Xeoma, please pay attention that they get to the right camera’s archive. Here’s some screenshots to illustrate that:

Say, this is your backup folder:

It is your backup folder

And this is your current folder for Xeoma:

It is your current folder

You can see that the numbers in folders’ names differ. The digit is actually camera’s ID in Xeoma so simple pasting folders into main directory may not work. You will need to help Xeoma find old records. You should open Archive and Preview module’s settings for the camera you want to paste old records for:

Module setting

In the example, 13 is your camera’s new number. Go to the backup and find its records (in our example, they are in the folder #103), then copy the folders inside:

Copy the folders content

In the current archive location, open the camera’s archive:

It is current archive location

And paste those backed-up records there.

Paste backed-up records

Now, you will be able to view older records in this camera’s archive. One more thing: pay attention in “Preview and Archive” module settings that the “Archive storage time” setting should comply with those old records’ date of creation (if the time is too short, the records will be deleted as being too old).

Please keep in mind that you need to restart Xeoma after you moved archives. It means that if you’re using the trial edition, old records can be erased after the restart because the Archive storage time setting will be reset to the default 1 hour.

Time lapse in Xeoma

Time lapse in video surveillance is the effect of speeded playback. Comprising video footage for security or creative application:

Security guard application: compress hours of footage for a quick review of motion events (or other events of interest) that have happened in the camera’s field of view.

Creative application is used in art, science, biology, etc. For example, you can compress days of footage for a visual representation of how rare flowers grow and blossom. Or, watch an art object like Kronshtadtskaya Icicle staying there as seasons change.

As always, Xeoma offers several flexible ways to get the timelapse effect depending on your equipment and needs. They can be roughly divided into 2 large methods: limiting stream frames per second rate and speeded playback.

Limiting the stream’s fps is mainly used in the stage of saving footage. It’s as simple as it sounds: you can choose to save footage already with lower fps to get the time lapse effect. This method is also good as it saves disk space. But you will not be able to see the “missing” frames – they will simply not be recorded.
1) For IP cameras: some cameras allow you to set llower fps in camera’s administration browser page where yous et up camera streams and parameters for the streams.
Also, if the camera stream is in the MJPEG format, you can set lower fps in Xeoma’s Universal Camera module for this camera with the FPS setting (only available for MJPEG cameras).
Tip: some cameras support parameters specified straight in the camera URL. You might want to try to add the ?fps=[value] postfix into the URL like

2) For USB cameras: a special drop down box in Universal Camera settings lets you choose resolution and fps with which to accept the USB camera’s stream.


Note that these combinations are what the camera offers itself. If the desired combination is not there, see other methods or use another camera.

Another way to limit fps in records is in the Preview and Archive module settings:


Set a lower interval to get the time lapse effect afterwards when you review the recordings.

Viewing footage with faster speed.
The Xeoma archive viewer allows up to 64x acceleration of playback speed. You can review days of footage in a couple of minutes, even for 25 fps video.


See more about Xeoma archive viewer

Also, you can speed up playback of exported pieces of Xeoma archive even when viewing them in third-party players outside of Xeoma. To do that, go to Playback settings of your video player and select faster playback speed there.