Skip to content

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.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


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
      • run openTSPS/
    • ASUS Xtion
  • Windows

    • Tested with Windows 7
    • web camera, video files:
      • download and extract
      • run openTSPS.exe
    • Kinect
      • download and extract
      • 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:
  2. clone the TSPS directory into openframeworks/
  3. clone all submodules:
git submodule update --init --recursive
  1. Kinect 2 support: checkout ofxKinectForWindows2 using new
  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 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.


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.






No packages published