TSPS is a cross platform Toolkit for Sensing People in Spaces. It performs openCV operations on live video (Kinect, web camera, etc) and sends it to clients as JSON (via WebSockets), OSC, TUIO, or TCP.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



TSPS is a toolkit for sensing people in spaces meant for both prototyping and permanent installations. It uses openCV to analyze a camera, kinect, or video data, and sends what it finds via OSC, TCP, TUIO, or Websockets. There are example TSPS clients in Processing, Javascript, Flash, Quartz composer, and many others!



Because of the now defunct Github downloads, TSPS downloads are hosted at Sourceforge


  • Mac OS X - 10.6+

    • web camera, video files, or Kinect:
      • download and extract openTSPS_1.3_mac.zip
      • run openTSPS/openTSPS.app
    • ASUS Xtion
  • Windows

    • Tested with Windows 7
    • web camera, video files:
      • download and extract openTSPS_1.3_win.zip
      • run openTSPS.exe
    • Kinect
      • download and extract openTSPS_1.3_win.zip
      • plug in your kinect
      • manually install drivers from openTSPS/drivers/Kinect
      • run openTSPS/openTSPS.exe
  • All platforms

    • make sure to keep the "data" folder next to your app if you move it!


  1. clone openframeworks 0.8.0 from here: https://github.com/openframeworks/openFrameworks
  2. clone the TSPS directory into openframeworks/
  3. clone all submodules:
git submodule update --init --recursive
  1. Kinect 2 support: checkout ofxKinectForWindows2 using new cloneaddons.sh
bash cloneaddons.sh
  1. open the project for your platform (Xcode of vs2010) in openTSPS/standalone/basic
  • Windows only: add this preprocessor argument to the ofxKinectForWindows2 project:
  1. WINDOWS ONLY: Include winsock2.h instead of winsock.h everywhere in ofxKinect (see this issue). It should be in 3 files:
  • libs/libfreenect/platform/windows/libusb10emu/libusb-1.0/libusb.h
  • libs/libfreenect/include/libfreenect.h
  • libs/libusb-1.0/include/libusb-1.0/libusb.h
  1. compile and run!

Compiling OS X 10.7+:

To use the video settings feature with openFrameworks, you must compile against OS X 10.6. If you don't need the video settings, change the Base SDK in the openTSPS project and openFrameworks project to "Latest SDK".

To compile against 10.6, follow the steps laid out in this forum post

Build Script

  • (OS X) - You can alternately build all of the binaries, the Processing library, and zip up all examples by running the build script
    • cd /Directory/of/openTSPS/build
    • bash build.sh VERSION_NUMBER (e.g. 1.3)
    • this will place 4 zip files in openTSPS/releases
    • note: you must have Xcode installed for this to work!


  • If you have trouble compiling, experience crashes, or need any general help, please visit the TSPS Forum


  • To turn on WebSocket communication (on by default in 1.1), select the Communication panel in the GUI and edit the WebSockets panel at the very bottom.
  • To test your WebSocket, simply compile/run openTSPS, then navigate your browser to localhost:PORT, where PORT is the port that is specified in the GUI. By default it's localhost:7681.
  • To have extra fun, open that same URL in a bunch of browser windows.
  • To have the most fun, open up another computer to http://YOUR_IP_ADDRESS:PORT
  • Making your own JS TSPS clients is easy (and they don't have to live in the bin/data/web directory); the TSPS WebSocket sender sends JSON, so you don't even have to use our JS files if you don't want to.