Skip to content

Application that allows you to monitor the traffic in and out of your building, using the RPi Camera and openFrameworks


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



88 Commits

Repository files navigation



Footfall is a camera based people counting system that uses a Raspberry Pi and Pi Cam and openFrameworks. There is more information about the system on our blog.

Important: The source code provides a barebones system that will require customisation for each installation.

This means tweaking variables which are explained in the

Built using openFrameworks 0.9.8.

How to Customise

Inside the bin/data folder of the Footfall App there is a config.json file. This contains all of the relevant variables you will need to change.

Please see the Configuration section.


Find attached the relevant readmes to help build Footfall system.


Thanks to Kyle McDonald for ofxCv and George Profenza for [ofxCvPiCam] (


The original software was intended for sole use within Watershed, therefore some of the source code has been altered for public use and differs slightly to our systems. For example our system generated event tags showing screening in conjunction with the total number of people in Watershed, to do this we had to pre-populate some timestamps and may cause an issue if the system is ran past a certain time.


Will update soon.


Update 1

I have added some new documentation about how to create the server side system database etc... There is also a new guide about how to setup the raspberry pi as a server.

I will be updating this repo with more detailed instructions and improved tracking over the coming weeks.

Update 2


I will updating the project to of_0.9.3 over the next coming weeks this should resolve some of the issues people have been having with ofxCv | ofXML.

Update 3


I will updating the project to of_0.9.8 soon. There will also only be one version of Footfall that should work across all Pi Platforms.

In the mean time. If you are coming up against compiler errors for ofxCvPiCam and ofxCv, try moving the ofxCvPiCam libs then, download the latest ofxCv repo. If you are using an earlier version oF ie less than 0.9.8. checkout the VS2012-stable branch. If you are using 0.9.8 use the origin/stable branch this will negate the glm:: errors.