Skip to content

Latest commit

 

History

History
92 lines (75 loc) · 3.79 KB

README.markdown

File metadata and controls

92 lines (75 loc) · 3.79 KB
Raw

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

Downloads

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

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

  • Linux

openTSPS works with an obsolete version of oF. We've got you covered. Check the install_opentsps_from_scratch.sh script.

$ chmod +x clone_addons.sh
$ ./clone_addons.sh
$ sh install_dependencies.sh

For Ubuntu 14.04 you'll need specific revisions for some libraries:

  • ofxLibwebsockets: a5537dd942d14e4043231ee48e5bf522f852c65c

  • ofxCv: 165193b84abe7e6dcdd4c442eae990a2d0ea3e96

  • All platforms

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

Compiling:

  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. open the project for your platform (Xcode of vs2010) in openTSPS/standalone/basic
  2. 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!

Troubleshooting

  • If you have trouble compiling, experience crashes, or need any general help, please visit the TSPS 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.