norihiro/obs-face-tracker 0.5.1

OBS Face Tracker 0.5.1

on GitHub

This is a minor change release.

Changes in 0.5.1

• Face Tracker Source is newly added.
  Previously, Face Tracker works as a filter. Now users have a choice to have another source.
  This will fix the issue that the tracking start from the initial condition at transition if Duplicate Sources is set.
• Filter: Fixed width and height if Stop tracking faces is set and Aspect setting is different from the source.
• PTZ: Added tracking target indicator (yellow +) as same as Face Tracker Filter.

Changes in 0.5.0

• Added a new property to adjust tracking threshold
• Added a new feature to crop image for face detection (not effective for tracking)
• Changes only for PTZ
  • Fixed an issue that zoom control was not working when sending through obs-ptz.
  • Stop camera before exiting OBS Studio or before removing the filter.
  • Added a new property to attenuate after lost face
  • Removed deprecated ptz devices (use obs-ptz)
  • Separated PID control parameters for each axis

Install

Windows

Download obs-face-tracker-0.5.1-Windows-Installer.exe (provided below) and execute it.
Or, download obs-face-tracker-0.5.1-Windows.zip (provided below) and extract to your OBS Studio installed directory.
See install instruction for detailed steps.

MacOS

Download obs-face-tracker-0.5.1-macos.zip (provided below) and extract in /Library/Application Support/obs-studio/plugins.
See also this guide.

Linux

Download and install obs-face-tracker_1-0.5.1-1_amd64.deb (provided below)
Or, compile from source for other distributions.

Limitation

• Binaries for Windows, macOS, and Ubuntu are not tested.
• Currently the plugin works for one face. If there are two or more faces, the plugin might hover back and forth over the faces.
• Consumes a lot of CPU. It is recommended to have enough test beforehand to ensure it won't affect encoding.
• There is no warranty for the results. Use at your own risk.
• Deb package for Ubuntu requires OBS Studio 27 or later. Binary packages for Windows and macOS work with OBS Studio 26 or later.
• I heard some anti-virus software detect the installer. If you see your anti-virus software alarms the installer, please file to issue page with the information of (a) anti-virus software and (b) type of the virus (either text or screen shot is ok).
  I'd like to note that all binaries are build on a Microsoft-hosted machine and the whole recipe is available on azure-pipelines.yml.

Affiliate Promotion

• Jimcom, a PTZ camera vendor, is now providing a coupon code FACETRACK20 for 20% discount and free shipping in the USA.