About

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!

http://openTSPS.com

Installing:

  • 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!

Compiling:

  1. clone openframeworks from here: https://github.com/openframeworks/openFrameworks
  2. clone the TSPS directory into openframeworks/
  3. open the project for your platform (Xcode of vs2010) in openTSPS/standalone/basic
  4. compile and run!

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!

Troubleshooting

  • If you have trouble compiling, experience crashes, or need any general help, please visit the [TSPS Forum] (http://opentsps.com/forum)

WebSockets

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