OBS Face Tracker 0.5.3

This is a hotfix release.

Changes in 0.5.3

• Fixed a crash when creating Face Tracker Source.

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.

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.3-Windows-Installer.exe (provided below) and execute it.
Or, download obs-face-tracker-0.5.3-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.3-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.3-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.

OBS Face Tracker 0.5.2

This is a minor change release.

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.

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.2-Windows-Installer.exe (provided below) and execute it.
Or, download obs-face-tracker-0.5.2-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.2-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.2-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.

OBS Face Tracker 0.5.1

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.

OBS Face Tracker 0.5.0

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 from 0.4.2

• 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

Install

Windows

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

MacOS

Download obs-face-tracker-0.4.2-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.4.2-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.
• 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 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.

OBS Face Tracker 0.4.2

This is a hotfix release with a bugfix for PTZ.

Changes from 0.4.1

• PTZ: Add supported frame formats YUYV and YUY2

Changes from 0.4.0

• PTZ: Add zoom control through obs-ptz
  The new zoom control requires obs-ptz v0.10.3 or later.
  For older version, only pan and tilt will move.

Changes from 0.3.1

• 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).

Install

Windows

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

MacOS

Download obs-face-tracker-0.4.2-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.4.2-1_amd64.deb (provided below)
Or, compile from source for other distributions.

Limitation

• Binaries for 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 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.

OBS Face Tracker 0.4.1

This is a release with some small new features.

Changes from 0.4.0

• PTZ: Add zoom control through obs-ptz
  The new zoom control requires obs-ptz v0.10.3 or later.
  For older version, only pan and tilt will move.

Changes from 0.3.1

• 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).

Install

Windows

Download obs-face-tracker-0.4.1-Windows-Installer.exe (provided below) and execute it.
Or, download obs-face-tracker-0.4.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.4.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.4.1-1_amd64.deb (provided below)
Or, compile from source for other distributions.

Limitation

• Binaries for 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 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.

OBS Face Tracker 0.4.0

This is a release with zoom control improvements.

Changes from 0.3.1

• 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).

Install

Windows

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

MacOS

Download obs-face-tracker-0.4.0-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.4.0-1_amd64.deb (provided below)
Or, compile from source for other distributions.

Limitation

• Binaries for 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 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.

OBS Face Tracker 0.3.1

This is a release with some small new features.

Changes from 0.3.0

• PTZ:
  • Add PTZ camera control through PTZ Controls 0.9.0.
    • This feature is under testing. Future release of either plugin could break the functionality.
    • The zoom control is currently not implemented.

Install

Windows

Download obs-face-tracker-0.3.1-Windows-Installer.exe (provided below) and execute it.
Or, download obs-face-tracker-0.3.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.3.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.3.1-1_amd64.deb (provided below)
Or, compile from source for other distributions.

Limitation

• Binaries for 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 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.

OBS Face Tracker 0.3.0

This is a release with some small new features.

Changes from 0.2.2

• face-tracker:
  • Add hotkeys to pause/resume tracking and reset tracking states.
• PTZ:
  • Add TCP connection to VISCA device

Install

Windows

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

MacOS

Download obs-face-tracker-0.3.0-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.3.0-1_amd64.deb (provided below)
Or, compile from source for other distributions.

Limitation

• Binaries for 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 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.

OBS Face Tracker 0.2.2

This is a hotfix release of Face Tracker for OBS Studio.

Changes from 0.2.1

• Fixed a memory access violation on Face Tracker PTZ, which was introduced at 0.2.1.

Changes from 0.2.0

• Fixed a bug of memory leaks. Expecting less memory usage than old versions.
• Binary for macOS is signed and notarized. Expecting users on macOS 10.15 or later won't see security errors.

Install

Windows

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

MacOS

Download obs-face-tracker-0.2.2-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.2.2-1_amd64.deb (provided below)
Or, compile from source for other distributions.

Limitation

• Binaries for 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 with the information of (a) anti-virus software and (b) type of the virus (either text or screen shot is ok). I recommend not to waive but consider to use zip-package.
  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.