{"id":13418148,"url":"https://github.com/kylemcdonald/FaceTracker","last_synced_at":"2025-03-15T03:30:38.097Z","repository":{"id":4868301,"uuid":"6023218","full_name":"kylemcdonald/FaceTracker","owner":"kylemcdonald","description":"Real time deformable face tracking in C++ with OpenCV 3.","archived":true,"fork":false,"pushed_at":"2020-07-24T18:26:28.000Z","size":346,"stargazers_count":1001,"open_issues_count":8,"forks_count":360,"subscribers_count":118,"default_branch":"master","last_synced_at":"2024-09-27T04:03:55.180Z","etag":null,"topics":["computer-vision","facetracker","opencv","realtime"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"amazeui/docs","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kylemcdonald.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-09-30T22:50:52.000Z","updated_at":"2024-08-17T18:25:29.000Z","dependencies_parsed_at":"2022-09-24T05:40:52.038Z","dependency_job_id":null,"html_url":"https://github.com/kylemcdonald/FaceTracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kylemcdonald%2FFaceTracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kylemcdonald%2FFaceTracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kylemcdonald%2FFaceTracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kylemcdonald%2FFaceTracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kylemcdonald","download_url":"https://codeload.github.com/kylemcdonald/FaceTracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243681005,"owners_count":20330152,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["computer-vision","facetracker","opencv","realtime"],"created_at":"2024-07-30T22:00:58.998Z","updated_at":"2025-03-15T03:30:38.078Z","avatar_url":"https://github.com/kylemcdonald.png","language":"C++","readme":"# FaceTracker\n\n**This repository is no longer maintained, due to challenges of upgrading to OpenCV 4.**\n\nFaceTracker is a library for deformable face tracking written in C++ using OpenCV 2, authored by [Jason Saragih](http://jsaragih.org/) and maintained by [Kyle McDonald](http://kylemcdonald.net/).\n\nAny publications arising from the use of this software, including but not limited to academic journal and conference publications, technical reports and manuals, should cite the following work: `J. M. Saragih, S. Lucey, and J. F. Cohn. Face Alignment through Subspace Constrained Mean-Shifts. International Conference of Computer Vision (ICCV), September, 2009.`\n\n## FAQ\n\n1. **\"I successfully compiled the code, so why is my app is crashing?\"** Make sure that your model files are in the right location. If you see the error `Assertion failed: s.is_open()` when running your app, that means you forgot to put the model files in the right directory.\n2. **\"Is there an example of using FaceTracker on a mobile device?\"** There is no official example. But there is an example of using ofxFaceTracker on iOS [here](https://github.com/kylemcdonald/ofxFaceTracker-iOS) and a native Android example [here](https://github.com/ajdroid/facetrackerapp).\n3. **\"Why is the tracking is slow, and why is there high CPU usage?\"** The face detection step (finding the general location of the face) can be slow. If this is causing an issue, you might want to put the tracking in a separate thread. If the detection is very slow you might try using a face detector that is native to your platform, and initializing FaceTracker with that rectangle.\n4. **Can I use this for my commercial project/product?** Yes. FaceTracker was re-licensed under the MIT license on April 8, 2020. Previously it was available under a custom non-commercial use license, with a separate license for commercial use available for purchase.\n\nWrappers are available for:\n\n* Android: [facetrackerapp](https://github.com/ajdroid/facetrackerapp)\n* [openFrameworks](http://www.openframeworks.cc/): [ofxFaceTracker](https://github.com/kylemcdonald/ofxFaceTracker)\n* [Cinder](http://libcinder.org/): [ciFaceTracker](https://github.com/Hebali/ciFaceTracker)\n* Python: [pyfacetracker](https://bitbucket.org/amitibo/pyfacetracker)\n\n## Installation\n\nThese instructions are for compiling the code on OS X and Ubuntu, but it should be possible to compile on other platforms.\n\nFirst, install OpenCV3 (if you're using OpenCV2, use the [opencv2](https://github.com/kylemcdonald/FaceTracker/tree/opencv2) branch of this repo). On OSX you can use [homebrew](http://brew.sh/):\n\n```\n$ brew tap homebrew/science\n$ brew install opencv3\n```\n\nAnd on Ubuntu use:\n\n```\n$ sudo apt-get install libcv-dev libopencv-dev\n```\n\nAlternatively, you can download [OpenCV from the GitHub](https://github.com/opencv/opencv) and compile it manually.\n\nAfter installing OpenCV, clone this repository with `git clone git://github.com/kylemcdonald/FaceTracker.git`. This repository contains a few subdirectories within the root directory:\n   - src (contains all source code)\n   - model (contains a pre-trained tracking model)\n   - bin (will contain the executable after building)\n\nNext, make sure that your copy of OpenCV is located in `/usr/local` (this should be the case if you used `apt-get`). If it isn't located there, modify the `OPENCV_PATH` in the `Makefile`. If you installed with Homebrew, it should be set to `/usr/local/opt/opencv3`.\n\nOptionally, you can also add `-fopenmp` to the `CFLAGS` and `-lgomp` to the `LIBRARIES` variable to compile with [OpenMP](http://openmp.org/) support.\n\nFrom the root `FaceTracker` directory, build the library and example by running `make`.\n\nTo test the demo, `cd bin` and `./face_tracker`. Because many webcams are 1280x720, try running `./face_tracker -s .25` to rescale the image before processing for a smoother framerate.\n\n## `face_tracker` Usage\n\n````\nUsage: face_tracker [options]\nOptions:\n-m \u003cstring\u003e : Tracker model (default: ../model/face2.tracker)\n-c \u003cstring\u003e : Connectivity (default: ../model/face.con)\n-t \u003cstring\u003e : Triangulation (default: ../model/face.tri)\n-s \u003cdouble\u003e : Image scaling (default: 1)\n-d \u003cint\u003e    : Frames/detections (default: -1)\n--check     : Check for failure \n--help      : Print help\n-?          : Print help\n````\n","funding_links":[],"categories":["TODO scan for Android support in followings","C++","realtime"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkylemcdonald%2FFaceTracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkylemcdonald%2FFaceTracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkylemcdonald%2FFaceTracker/lists"}