Media Server 25.4
Media Server Help

# Detect Faces

To detect faces that appear in media, follow these steps.

To detect faces in media

1. Create a new configuration to send to Media Server with the `process` action, or open an existing configuration that you want to modify.

2. In the `[Session]` section, add a new analysis task by setting the `EngineN` parameter. You can give the task any name, for example:

       [Session]
       Engine0=Ingest
       Engine1=FaceDetect

3. Create a new configuration section to contain the task settings, and set the following parameters:

   `Type` | The analysis engine to use. Set this parameter to `FaceDetect`.
   Input | (Optional) The image track to process. If you do not set this parameter, Media Server processes the first track of the correct type.
   Region | (Optional) The region that you want to search for faces.
   FaceDirection | (Optional) Media Server can detect faces looking in any direction, but if you know that all faces will look directly at the camera you can set `FaceDirection=Front`. This is faster and might produce fewer false detections.
   ColorAnalysis | (Optional) A Boolean value that specifies whether to perform color analysis on detected faces. This can reduce the number of false detections.
   MinSize | (Optional) The minimum expected size of faces in the media. Increasing the minimum size can increase processing speed.

   For example:

       [FaceDetect]
       Type=FaceDetect
       FaceDirection=Front
       ColorAnalysis=TRUE
       MinSize=100 pixels

   For more information about the parameters that you can use to configure Face Detection, see Face Detection.

4. Save and close the configuration file. OpenText recommends that you save your configuration files in the location specified by the `ConfigDirectory` parameter.

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.4

Topic Title: Detect Faces