.. _offline-video:

***************************************
Face Identification in Offline Videos   
***************************************

Besides real-time face identification, FindFace Security allows for offline video processing. This functionality has a wide range of possible applications, among which the most common case is face detection and recognition in archived videos. Supported formats are MP4 and FLV (H.264).

.. rubric:: In this chapter:

.. contents::
   :local:


Configure Offline Video Processing
=======================================

By default, video files are processed in a queued mode to prevent event drops due to resource overconsumption. You can modify the default number of simultaneously processed video files. To do so, open the ``findface-security`` configuration file and change the ``MAX_VIDEO_ARCHIVE_JOBS`` parameter. Please contact our experts prior (support@ntechlab.com) to make sure your resources are enough.

.. code::
 
   sudo vi /etc/findface-security/config.py

   ...

   FFSECURITY = {
   ...
       # maximum concurrent video manager jobs for video archives processing
       'MAX_VIDEO_ARCHIVE_JOBS': 3,
       ...
   } 
   ...

Process Video File
=====================

To identify faces in an offline video, do the following:

#. To process offline videos, you need a camera group. You can create a new camera group with basic settings or use the Video Archive default camera group. After the camera group is chosen, assign it to all :ref:`watch lists <guests>` that you want to monitor when processing the video.
#. Create a video in FindFace Security by uploading it from a file or online storage/cloud. To do so, navigate to the :guilabel:`Videos` tab.
#. Click :guilabel:`+`.

    |create_video_en|

     .. |create_video_en| image:: /_static/create_video_en.png
        :scale: 60%

     .. |create_video_ru| image:: /_static/create_video_ru.png
        :scale: 60%


#. Specify the video name. 

     |video_upload_en|

     .. |video_upload_en| image:: /_static/video_upload_en.png
        :scale: 70%

     .. |video_upload_ru| image:: /_static/video_upload_ru.png
        :scale: 70%

#. Specify the video URL in an online storage, or select a video file. 
#. Click :guilabel:`Upload`.
#. After the video is uploaded, navigate to the :guilabel:`Parameters` tab. Select the camera group you have chosen.

     |video_parameters_en|

     .. |video_parameters_en| image:: /_static/video_parameters_en.png
        :scale: 70%

     .. |video_parameters_ru| image:: /_static/video_parameters_ru.png
        :scale: 70%

#. (Optional) Select a camera to which you want to attribute the face recognition events found in the video.
#. (Optional) Configure the timestamps for face recognition events.
#. (Optional) On the :guilabel:`Advanced`, :guilabel:`ROI`, :guilabel:`ROT` tabs, specify parameters of video processing in the same manner as you do when configuring a :ref:`camera <add-camera>`.
#. Navigate to the :guilabel:`Processing` tab. Click :guilabel:`Process` to start face identification. 

     |video_process_en|

     .. |video_process_en| image:: /_static/video_process_en.png
        :scale: 60%

     .. |video_process_ru| image:: /_static/video_process_ru.png
        :scale: 60%

   You can view face identification events right here, as well as on the :guilabel:`Events` and :guilabel:`Episodes` tabs by filtering the list of events by the camera group/camera associated with the video.