Skip to content

Face Recognition

The Flussonic Watcher system can recognize human faces. This feature is used to solve various problems:

  • Arranging access without card swiping in an access control system
  • Employee time&attendance tracking
  • Accounting for incoming/outgoing traffic of people
  • Automatic identification or verification of persons when performing various actions

Before you proceed to settings:

  1. Update Flussonic Watcher to the latest version.
  2. Install the video analytics module.


Turning on face detection on a video camera

Enabling video analytics on the server

Enable the video analytics plugin. To do so, open the /etc/flussonic/flussonic.conf file and add following line in it:

plugin vision {
  jpeg_vector_helper true;

Turning on face detection on a video camera


The recognition settings may not be available if you have selected a non-adjustable preset.

To start faces detection and recognition:

  1. In the Watcher UI, go to Cameras. Find the camera in the list and open its settings by clicking the icon in the upper right corner of the player.

  2. Check the Enable recognition box.


  3. Select Recognize faces in the drop-down list that appears when you check the box.

  4. By default, the recognition system searches for faces over all the camera field of view. You can select specific area(s) to detect faces in by clicking Set up the detection zone. This settings may help you to reduce false detections.


  5. Open the file /etc/flussonic/flussonic.conf and the settings of the camera add the vision option, specifying the faces algorithm and GPU number:

stream face-detection-test {
  url fake://fake;
  auth auth://vsaas;
  vision alg=faces gpu=0;
  • gpu (required) – GPU number. You can use the nvidia-smi tool to find out which number is assigned to your GPU.

Reload the configuration with service flussonic reload so that the changes made to the file take effect.

Face detection

The face detection mode is useful if you need to:

  • Eliminate false triggering of the motion detector on foliage, animals, or other moving objects.
  • Accumulate a person database, which can later be used to divide people into lists.
  • Get statistical information about the passages of unique faces under the camera.

After turning on face recognition on the camera, all recognized faces will fall into the Face detector tab in the Events section, and the following information will be displayed: a photo of the face at the time of recognition, the date and time of recognition, the name of the person (if added to any list), and the ability to uploading a screenshot or video with the process of passing a person under the camera.

Face recognition

Face lists

To implement the tasks of identification and verification, when you need to answer the questions "Who is this?" and “Is this him?”, lists of faces are needed. They allow you to set the names found in the image to the appropriate names and identifiers and use them in other systems (for example, when integrating with access control systems, when you want to allow only employees of a particular office to enter the door).

To view the current lists of persons, go to the Events -> Face detector section and click the Person lists button.

The lists of persons that were created earlier will be opened, as well as a list of persons found on the video that do not belong to any list.

Face recognition

To view the list of persons and information about persons in it, click the list and then select the person you are interested in.

Face recognition

To add a new list, click Create a List, enter its name and indicate which cameras will search for persons on this list. One camera can serve only one list of faces.

Face recognition

After the list is created, you can add persons. To do this, go to the persons list and click Add Person.

In the form that opens, enter the name of the person, upload their reference photo, which will be used to compare it with all people passing by, then specify which list of people the person will belong to, and also add an arbitrary note.

Face recognition

In addition, you can edit information about an unidentified person that was seen by the camera. To do this, open the list of unidentified persons, find the photo from the camera of the person you are looking for and click Edit. After that, enter the information on the person - name, note, and the list of persons.

Face recognition

Now you have added the list and added several persons to it. As the persons pass under the camera, events about their passages will appear in the system on the Events -> Face detector tab. If a known person (from a list) passed under the camera, then the person’s name will be indicated in the event, and if the person was not in any list, then it will be automatically created in the list of unidentified persons and an identifier will be assigned to them.

You can search through the list of events, for example, to find a list of all events of the passage of a person with a given name before the camera. This list can be exported to CSV and analyzed using third-party tools.