Skip to content

Windows Installation

Jump to bottom
Tadas Baltrusaitis edited this page Jul 13, 2019 · 36 revisions

Binaries

Windows binaries can be found here:

For the binaries to work you need to have Visual Studio 2017 installed or need to install the 64-bit Visual C++ redistributable package, that can be found here.

Explanation of how to use the command line binaries can be found here

Alternatively you can use the Windows GUI (OpenFaceOffline.exe), which has mostly the same functionality as the command line interface.

For CE-CLM landmark detector to work you need to download additional model files, this can be done by executing the download_models.ps1 PowerShell script. For more details on model download see - https://github.com/TadasBaltrusaitis/OpenFace/wiki/Model-download

From code

For Windows this software comes prepackaged with most of the necessary binaries and dll's for compilation of the project (with missing ones downloaded through a script, see below). You will also need to compile the code it in order to run it. Code was tested on Windows 7/8/10 and Windows Server 2008 can't guarantee compatibility with other Windows versions (but in theory it should work).

Dependency download

To download OpenCV binaries you will need to execute the download_libraries.ps1 PowerShell script (right click on the script and select Run with PowerShell)

Model download

For CE-CLM landmark detector to work you need to download additional model files, this can be done by executing the download_models.ps1 PowerShell script. For more details on model download see - https://github.com/TadasBaltrusaitis/OpenFace/wiki/Model-download

Code building

You don't need to download anything additional besides the models and dependencies listed above, just open "OpenFace.sln" using Visual Studio 2017 and compile the code. The project was built and tested on Visual Studio 2017 (can't guarantee compatibility with other versions, and you would need to find/build the appropriate dll and lib files for them yourself).

Release Mode

NOTE be sure to run the project without debugger attached and in Release mode for speed (if running from Visual Studio). To run without debugger attach use CTRL + F5 instead of F5. To change from Debug mode to Release mode select Release from drop down menu in the toolbar. This can mean the difference between running at 5fps and 60fps on 320x240px videos.

NOTE 2 make sure the startup project you select is one of the projects in Executables (FaceLandmarkImg, FaceLandmarkVid, FaceLandmarkVidMulti, or FeatureExtraction) as other projects (dlib, FaceAnalyser, LandmarkDetector) are libraries and will not work as executables. To change the start up project, right click on the project in the Solution Explorer and select Set as StartUp project

Architecture

The software works both on 32 and 64 bit architectures. I found that the x64 version seems to run faster on most machines. Furthermore, all the demo scripts assume you compiled the x64 version. To change versions go to the top bar and change Win32 to x64 (next to the Debug/Release choice).

Testing

You can test if the models compiled correctly by launching the GUI using OpenFaceOffline.exe or OpenFaceDemo.exe from the release directory (Release or x64/Release/). This will launch a GUI for analyzing images/videos/live feeds with the former or a live feed only with the latter.

To test if the system compiled correctly or to test binaries go to matlab_runners\Demos and attempt to run all the demo scripts (from Matlab)

  • run_demo_videos.m tracking videos
  • run_demo_video_multi.m multiple faces in videos
  • run_demo_images.m landmark detection in images
  • gaze_extraction_demo_vid.m gaze in videos
  • feature_extraction_demo_vid.m various features (pose, landmarks, gaze, and Action Units from a video)

Alternatively if you don't have Matlab try these command line arguments from Release directory (add extra ../ if running from x64/Release/:

  • FaceLandmarkImg.exe -wild -fdir "../samples/" -verbose

  • FaceTrackingVid.exe -f "../samples/changeLighting.wmv" -f "../samples/default.wmv"

  • FeatureExtraction.exe -f "../samples/changeLighting.wmv" -verbose

See command line arguments for more details of how to use the binaries

Clone this wiki locally