{"id":13548080,"url":"https://github.com/norihiro/obs-face-tracker","last_synced_at":"2026-01-31T06:20:06.166Z","repository":{"id":44536574,"uuid":"370888725","full_name":"norihiro/obs-face-tracker","owner":"norihiro","description":"Face tracking plugin for OBS Studio","archived":false,"fork":false,"pushed_at":"2025-10-28T09:16:10.000Z","size":569,"stargazers_count":421,"open_issues_count":47,"forks_count":36,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-10-28T11:20:00.618Z","etag":null,"topics":["face-detection","face-tracker","obs","obs-studio","obs-studio-plugin"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/norihiro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":"https://paypal.me/nkamae","github":"norihiro","ko_fi":"nkamae"}},"created_at":"2021-05-26T02:55:52.000Z","updated_at":"2025-10-28T09:16:13.000Z","dependencies_parsed_at":"2023-12-18T23:05:52.829Z","dependency_job_id":"6b5257b0-f97d-4cc0-8405-02715207ad0b","html_url":"https://github.com/norihiro/obs-face-tracker","commit_stats":{"total_commits":281,"total_committers":1,"mean_commits":281.0,"dds":0.0,"last_synced_commit":"573da1af2bad48b9cbd4c75a8abb45d5f6061b29"},"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/norihiro/obs-face-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norihiro%2Fobs-face-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norihiro%2Fobs-face-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norihiro%2Fobs-face-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norihiro%2Fobs-face-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/norihiro","download_url":"https://codeload.github.com/norihiro/obs-face-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/norihiro%2Fobs-face-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28931096,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T04:05:25.756Z","status":"ssl_error","status_checked_at":"2026-01-31T04:02:35.005Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["face-detection","face-tracker","obs","obs-studio","obs-studio-plugin"],"created_at":"2024-08-01T12:01:05.454Z","updated_at":"2026-01-31T06:20:06.138Z","avatar_url":"https://github.com/norihiro.png","language":"C++","funding_links":["https://paypal.me/nkamae","https://github.com/sponsors/norihiro","https://ko-fi.com/nkamae"],"categories":["C++","\u003ca name=\"cpp\"\u003e\u003c/a\u003eC++","others"],"sub_categories":[],"readme":"# Face Tracker Plugin for OBS Studio\n\n## Introduction\n\nThis plugin provide a feature to track face of a person by detecting and tracking a face.\n\nThis plugin employs [dlib](http://dlib.net/) on face detection and object tracking.\nThe frame of the source is periodically taken to face detection algorithm.\nOnce a face is found, the face is tracked.\nBased on the location and the size of the face under tracking, the frame will be cropped.\n\n## Usage\n\nFor several use cases, total 3 methods are provided.\n\n### Face Tracker Source\nThe face tracker is implemented as a source. You can easily have another source that tracks and zooms into a face.\n1. Click the add button on the source list.\n2. Add `Face Tracker`.\n3. Scroll to the bottom and set `Source` property.\n\nSee [Properties](doc/properties.md) for the description of each property.\n\n### Face Tracker Filter\nThe face tracker is implemented as an effect filter so that any video source can have the face tracker.\n1. Open filters for a source on OBS Studio.\n2. Click the add button on `Effect Filters`.\n3. Add `Face Tracker`.\n\nSee [Properties](doc/properties.md) for the description of each property.\n\n### Face Tracker PTZ\nExperimental version of PTZ control is provided as an video filter.\n1. Open filters for a source on OBS Studio,\n2. Click the add button on `Audio/Video Filters`.\n3. Add `Face Tracker PTZ`.\n\nSee [Properties](doc/properties-ptz.md) for the description of each property.\n\nSee [Limitations](https://github.com/norihiro/obs-face-tracker/wiki/PTZ-Limitation)\nfor current limitations of PTZ control feature.\n\n## Wiki\n- [Install procedure for macOS](https://github.com/norihiro/obs-face-tracker/wiki/Install-MacOS)\n- [FAQ](https://github.com/norihiro/obs-face-tracker/wiki/FAQ)\n\n## Building\n\nThis plugin requires [dlib](http://dlib.net/) to be built.\nThe `dlib` should be extracted under `obs-face-tracker` so that it will be linked statically.\nI modified `dlib` so that `openblasp` won't be linked but `openblas`.\n\nFor macOS,\ninstall openblas and configure the path.\n```\nbrew install openblas\nexport OPENBLAS_HOME=/usr/local/opt/openblas/\n```\n\nFor Linux and macOS,\nexpand `obs-face-tracker` outside `obs-studio` and build.\n```\nd0=\"$PWD\"\ngit clone https://github.com/obsproject/obs-studio.git\nmkdir obs-studio/build \u0026\u0026 cd obs-studio/build\ncmake ..\nmake\ncd \"$d0\"\n\ngit clone https://github.com/norihiro/obs-face-tracker.git\ncd obs-face-tracker\ngit submodule update --init\nmkdir build \u0026\u0026 cd build\ncmake .. \\\n\t-DLIBOBS_INCLUDE_DIR=$d0/obs-studio/libobs \\\n\t-DLIBOBS_LIB=$d0/obs-studio/libobs \\\n\t-DOBS_FRONTEND_LIB=\"$d0/obs-studio/build/UI/obs-frontend-api/libobs-frontend-api.dylib\" \\\n\t-DCMAKE_BUILD_TYPE=RelWithDebInfo\nmake\n```\n\nFor Windows, see `.github/workflows/main.yml`.\n\n## Preparing data file\n\nYou need to prepare a model file.\n\n### HOG model file\nOnce you have built on Linux or macOS, you will find an executable file `face-detector-dlib-hog-datagen`.\n\nAssuming your current directory is `obs-face-tracker`, run it like this.\n```shell\nmkdir data/dlib_hog_model/\n./build/face-detector-dlib-hog-datagen \u003e ./data/dlib_hog_model/frontal_face_detector.dat\n```\n\n### CNN model file\nThe CNN model file `mmod_human_face_detector.dat.bz2` can be downloaded from [dlib-models](https://github.com/davisking/dlib-models/).\n\nAssuming your current directory is `obs-face-tracker`, run commands like below.\n```shell\nmkdir data/dlib_cnn_model/\ngit clone --depth 1 https://github.com/davisking/dlib-models\nbunzip2 \u003c dlib-models/mmod_human_face_detector.dat.bz2 \u003e data/dlib_cnn_model/mmod_human_face_detector.dat\n```\n\n### 5-point face landmark model file\nThe 5-point face landmark model file `shape_predictor_5_face_landmarks.dat.bz2` can be downloaded from [dlib-models](https://github.com/davisking/dlib-models/).\n\nAssuming your current directory is `obs-face-tracker`, run commands like below.\n```shell\nmkdir data/dlib_face_landmark_model/\ngit clone --depth 1 https://github.com/davisking/dlib-models\nbunzip2 \u003c dlib-models/shape_predictor_5_face_landmarks.dat.bz2 \u003e data/dlib_face_landmark_model/shape_predictor_5_face_landmarks.dat\n```\n\n### 68-point face landmark model file\n\u003e [!NOTE]\n\u003e The 68-point face landmark model is a non-free license.\n. Check [README](https://github.com/davisking/dlib-models/#shape_predictor_68_face_landmarksdatbz2) for the restriction.\n\nIf you want to use the 68-point face landmark model file `shape_predictor_68_face_landmarks.dat.bz2`, run commands like below.\n```shell\nmkdir data/dlib_face_landmark_model/\ngit clone --depth 1 https://github.com/davisking/dlib-models\nbunzip2 \u003c dlib-models/shape_predictor_68_face_landmarks.dat.bz2 \u003e data/dlib_face_landmark_model/shape_predictor_68_face_landmarks.dat\n```\n\n### Installing the model files\nOnce you have prepared the model files under `data` directory,\nrun `cd build \u0026\u0026 make install` so that the data file will be installed.\n\n## Known issues\nThis plugin is heavily under development. So far these issues are under investigation.\n- Memory usage is gradually increasing when continuously detecting faces.\n- It consumes a lot of CPU resource.\n- The frame sometimes vibrates because the face detection results vibrates.\n\n## License\nThis plugin is licensed under GPLv2.\n\n## Sponsor\n- [Jimcom USA](https://www.jimcom.us/?ref=2) - a company of Live Streaming and Content Recording Professionals.\n  Development of PTZ camera control is supported by Jimcom.\n  Jimcom is now providing a 20% discount for their broadcast-quality network-connected PTZ cameras and free shipping in the USA.\n  Visit [Jimcom USA](https://www.jimcom.us/?ref=2) and enter the coupon code **FACETRACK20** when you order.\n\n## Acknowledgments\n- [dlib](http://dlib.net/) - [git hub repository](https://github.com/davisking/dlib)\n- [obz-ptz](https://github.com/glikely/obs-ptz) - PTZ camera control goes through this plugin.\n- [OBS Project](https://obsproject.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnorihiro%2Fobs-face-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnorihiro%2Fobs-face-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnorihiro%2Fobs-face-tracker/lists"}