FaceTracker is a library for deformable face tracking written in C++ using OpenCV 2, authored by Jason Saragih and maintained by Kyle McDonald.

It is available free for non-commercial use, and may be redistributed under these conditions. Please see license.md for complete details. For commercial use, request a quote.

Wrappers are available for:

• openFrameworks: ofxFaceTracker
• Cinder: ciFaceTracker
• Python: pyfacetracker

These instructions are for compiling the code on OS X and Ubuntu, but it should be possible to compile on other platforms.

First, install OpenCV-2.x. This code has been tested with OpenCV-2.0 and OpenCV-2.4. On OSX you can use [brew](http://brew.sh/) install opencv and on Ubuntu use sudo apt-get install libcv-dev libopencv-dev. Alternatively, you can download the repository from git clone git://code.opencv.org/opencv.git and compile it manually.

Then, clone this repository with git clone git://github.com/kylemcdonald/FaceTracker.git. This repository contains a few subdirectories within the root directory:

• src (contains all source code)
• model (contains a pre-trained tracking model)
• bin (will contain the executable after building)

Next, make sure that your copy of OpenCV is located in /usr/local (this should be the case if you used brew or apt-get). If it isn't located there, modify the OPENCV_PATH in the Makefile. Optionally, you can also add -fopenmp to the CFLAGS and -lgomp to LIBRARIES to compile with OpenMP support.

From the root FaceTracker directory, build the library and example by running make.

To 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.

Usage: face_tracker [options]
Options:
-m <string> : Tracker model (default: ../model/face2.tracker)
-c <string> : Connectivity (default: ../model/face.con)
-t <string> : Triangulation (default: ../model/face.tri)
-s <double> : Image scaling (default: 1)
-d <int>    : Frames/detections (default: -1)
--check     : Check for failure 
--help      : Print help
-?          : Print help