Skip to main content

BriefCam VMS Integration Guide

LENSEC Integration

Last Updated: 5 minute read
LanguageEnglish

Integration Summary

VMS Partner 

Product 

Version 

Last Tested BriefCam Version 

Integration Level 

H.265 Support 

LENSEC

Perspective VMS

6.1.x.0

2025 R1 SP1 (Classic engine)

Real time alerts integration (L2a) only

Yes

LENSEC

Perspective VMS

6.0.x.0

2024 M1 HF2 (Classic engine)

Real time alerts integration (L2a) only

Yes

Important

Certification policy note: Official certification applies to major and minor versions. Maintenance versions are not part of the certification process. However, versions 6.1.1.0, 6.1.2.0, and 6.1.3.0 have been tested and verified as stable.

LENSEC 6.1.x.0 Integration

Required ports

The following ports should be available when installing the plugin.

Default port

Description

80

General communication with VMS Server

554

Camera service stream port – RTSP live streaming from the VMS

None

Event connector port – for receiving alerts from BriefCam, defined by the user

Adding the Lensec VMS as a Directory in BriefCam

  1. From the Video Integration field, select Lensec Integration.

  2. In the Directory Name field, enter a display name for the user directory.

  3. Enter the VMS address. The VMS address is the URL to the VMS – http(s)://{VMS-Server-Address}/{VMS-Endpoint}. The VMS endpoint is configurable during the installation. The default is PerspectiveVMS, for example: http://172.1.1.100/PerspectiveVMS.

  4. Enter the administrator's user name.

  5. Enter the password for the administrator user.

Lensec_6.png
Enable Sending of Alerts to the VMS (L2a)

STEP 1. Creating the BriefCam connector 

This connector is used to receive all alerts sent by BriefCam

  1. Open the VMS Administration.

  2. Navigate to Integrations > Connectors.

  3. Click Add to add a new connector.

  4. In the Connector type field, select LENSEC - General Analytics.

  5. In the Connector name field, enter BriefCam.

  6. In the Server field, select a server that will receive the alerts.

  7. Set the Frequency field to 0.

    Lensec_basic_info.png

  8. Navigate to Advanced Settings.

  9. Set the Listener type to TCP.

  10. In the Port field, enter the port that will be used for receiving alerts from BriefCam.

  11. Click Create.

    Lensec_advanced_settings.png

After the connector is successfully created, the port will be opened by the VMS.

Ensure this port is opened to the BriefCam machine.

STEP 2. Creating the Camera Analytic rules 

For each camera that will receive alerts from BriefCamBriefCam, an Analytics Rule needs to be created.

  1. Navigate to Integrations > Analytic Rules.

  2. Click Add.

  3. From the Connector list, select BriefCam.

  4. In the Name field, enter a name for the analytic rule.

  5. In the Camera field, select the camera that will be used when the rule is triggered.

  6. From the Provider list, select BriefCam.

  7. From the Event panel list, select a panel where the alerts will be shown.

  8. From the Minimum log level field, select the required log level, depending on user needs.

  9. Set the rule as Active.

    Lensec_analytic_rule.png

  10. Navigate to Advanced Information.

  11. In the Camera Id field, enter the ID for the previously selected camera (in step 5).

  12. In the Provider IP field, enter the IP address of the BriefCam server that will send the alerts.

    If the server is on a different network than the VMS, the VMS Network Gateway address needs to be used instead of the server address.

    Lensec_advanced_info.png

  13. Navigate to Associated Events.

  14. Add Generic to Selected events.

  15. Click Create.

    Lensec_associated_events.png
L2a Setup in BriefCam

To enable the sending of alerts:

  1. In the BriefCam Administrator Console, open the Settings tab.

  2. Set the Respond.AlertsPublishingEnabled environment setting to True.

  3. Save the value.

    Respond_alerts_publishing.png
Enabling Sending of Alerts in the Lensec Integration Configuration file

  1. Open the BriefCam.LensecIntegration.ini configuration file (located at C:\Program Files\BriefCam\BriefCam Server\plugins).

  2. In the AlertsHTTPPort parameter, enter the BriefCam connector's port.

  3. Remove the semicolon from the beginning of the row.

  4. Save the file.

  5. Restart the VSServer service.

    LensecIntegration_file.png

The AlertendpointAddress parameter defaults to the server address set up in the BriefCam directory.

If the alerts need to be sent to another VMS server, enter the server address in the AlertendpointAddress parameter and enable it (by removing the semicolon at the beginning of the row).

The AlertEndpointAddressURLformat is the same as the format needed for the BriefCam directory: http(s)://{VMS-Server-Address}/{VMS-Endpoint}.

BriefCam Alert Thumbnails in the Perspective VMS Panel
Lensec_alert_thumbnails.png

When alerts are sent to the VMS, the metadata includes a hyperlink to thumbnails generated by BriefCam.

These thumbnails are generated and located in the BriefCam shared folder.

The VMS machine needs to have access to the BriefCam shared folder in order to display these thumbnails properly.

If the VMS does not have access to the BriefCam shared folder, it will generate thumbnails based on the alert time, from its own recorded video.

Known Limitations

  • For L1 (on-demand processing), motion detection recordings are not supported. Only constant recordings are supported.

LENSEC 6.0.x.0 Integration

Prerequisites

To view BriefCam alerts in Lensec, the Lensec user needs to be part of an operator group (on the Lensec VMS) at a minimum.

Installation Steps

  1. From the BriefCam Administrator Console, stop all currently running services.

  2. Check "Programs and Features" to confirm that the Lensec plugin is not already installed.

  3. Run the downloaded BriefCam Lensec plugin.

  4. Open the Briefcam.LensecIntegration.ini file (located at C:\Program Files\BriefCam\BriefCam Server\plugins) and change the FFmpegPath setting to: C:\Program Files\BriefCam\BriefCam Server\FFmpeg.exe. Save the changes.

    Lensec ini file.png

  5. Add the Lensec Integration to BriefCam:

    1. In the BriefCam Administrator Console, open the Settings tab and click Camera Management.

    2. Click the Add Directory button.

      Camera Management add directory M1.png

    3. From the Video Integration field, select Lensec Integration.

    4. In the Directory Name field, enter a display name for the user directory.

    5. In the Address field, enter the Lensec server address, for example: 172.1.1.111.

    6. In the User Name field, enter, for example: admin.

    7. In the Password field, enter a password of up to 12 characters, for example: Tadmin#.

    8. Click Add.

      Add directory Lensec.png

  6. In the Add/Edit Cameras screen, activate the desired Lensec cameras.

  7. Restart all BriefCam services.

  8. On the Windows machine, restart Internet Information Services (IIS).

  9. From the BriefCam Administrator Console, make sure that all services are running properly.