← Back to Articles

Xeoma’s Face Detection And Face Recognition

face_detector_icon 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?

You can do it via the module “Face Detector”. Put it in your chain so that it is connected to the “Preview and Archive” (this is essential to ensure its proper operation).


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. You can add up to 100 different photos for the same face to make recognition even more reliable. Adding more will result in overriding the old ones.


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. The database has no limits – you can add as many people to it as you need. 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.