Face Tracker

Face Tracker 0.5.4

This is a minor release with a new feature and a bugfix.

Changes in 0.5.4
  • Implemented face landmark detection as an option to calculate face location and size more accurately.
  • PTZ: Add hotkeys to pause and reset (This feature was already implemented in the source and filter.)
  • PTZ: Fixed BGR24 format

To enable the face landmark detection, enable the feature from the property dialog.
obs-face-tracker-landmark-property.png

Comparison of the conventional method (using bounding box) and the new feature using the landmark detection is available in this video. (There is no audio.)
Only the 5-point landmark detection dataset is bundled in the package.
Since the 68-point landmark detection dataset is not available for commercial use, which means not compatible with GPL, I cannot bundle the dataset in the package. Still you can download from the website and choose it.
This is a hotfix change release.

Changes in 0.5.3
  • Fixed a crash when creating Face Tracker Source.
  • Like
Reactions: GregPeatfield
This is a minor change release. I'm sorry that I remembered this was missing from 0.5.1 just after releasing.

User is now be able to revert the tracking behavior to that in 0.4.2.

Changes in 0.5.2
  • Added a checkbox Set tracking threshold in the property dialog to disable the tracking threshold that was added in 0.5.0.
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.
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](../../issues/new) 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](../../blob/main/azure-pipelines.yml).
Affiliate Promotion
  • [Jimcom](https://www.jimcom.us/?ref=2), a PTZ camera vendor, is now providing a coupon code **FACETRACK20** for 20% discount and free shipping in the USA.
This is a experimental release.
Detection and tracking has improvement. Users may experience differences from the old version.
Face Tracker PTZ has many improvements.

Changes
  • Add a new property to adjust tracking threshold
  • Add a new feature to crop image for face detection (not effective for tracking)
  • Changes only for PTZ
    • Fix an issue that zoom control was not working when sending through obs-ptz.
    • Stop camera before exiting OBS Studio or before removing the filter.
    • Add a new property to attenuate after lost face
    • Remove deprecated ptz devices (use obs-ptz)
    • Separate PID control parameters for each axis
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.
  • Transition with `Duplicate Sources`, the tracking may start from the initial condition. Recommended to disable `Duplicated Sources` so far.
  • 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](../../issues/new) 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](../../blob/main/azure-pipelines.yml).
This is a hotfix release with a bugfix for PTZ.

Changes from 0.4.1
  • PTZ: Add supported frame formats YUYV and YUY2
  • Like
Reactions: GregPeatfield
Add zoom control through [obs-ptz](https://github.com/glikely/obs-ptz/)
The new zoom control requires obs-ptz v0.10.3 or later. For older version, only pan and tilt will move.
  • Like
Reactions: GregPeatfield
This is a new release with improvements for zoom control.
  • Add attenuation property for zoom (face tracker filter only)
  • Separate LPF parameter for zoom (both face tracker filter and PTZ)
Due to this change, all users will experience different behavior of the zoom control.
If exactly same behavior is needed, set `Attenuation (Z)` to `0 dB` and `Track LPF for Td (Z)` to same value as `Track LPF for Td (X, Y)`.
This is a minor release including PTZ camera control through PTZ Controls version 0.9.0.
  • Face Tracker PTZ:
    • Add PTZ camera control through PTZ Controls version 0.9.0.
      • This feature is under testing. Future release of either plugin could break the functionality.
      • The zoom control is currently not implemented.
  • Face Tracker:
    • No changes
This is a release with some small new features.
  • face-tracker: Add hotkeys to pause/resume tracking and reset tracking states.
    • 3 hotkey settings are added; Pause, Resume, and Reset. If you assign a same key to Pause and Resume, you can toggle with that key.
    • I'd like to thank @rusty1 and @GregPeatfield for the idea.
  • PTZ: Add TCP connection to VISCA device.
Top