gchaprnka / kinect2share Goto Github PK

Share skeleton and video data from the Kinect V2 with Isadora or any other software which supports OSC (Open Sound Control), Spout, and/or NDI.

Kinect2share is a Windows only OpenFrameworks app based on the example projects included in Elliot Woods fantastic OpenFrameworks plugin, ofxKinectForWindows2.

The goal of this project is to make as many Kinect2 features available to creative platforms as possible using open standards including OSC (opensoundcontrol), and Spout.

Specific care has been given to providing a demo file for use with the Isadora creativity server. This demo file provides basic functional examples that Isadora users can build upon. Currently the Isadora version 2.5.x is required to run the demo file.

Since this project is developed using open standards it can easily be used with other popular tools/frameworks including: processing, resolume, max msp, touchdesigner, vvvv, qlab, and many more. Additionally Kinect2share allows sharing both the skeleton data and multiple video feeds over a network connection. This allows the Kinect V2 data to be used by Apple / Mac computers. (note this requires 2 computers, 1 mac and 1 pc) To connect a Mac to a PC running kinect2share you will require:

• network router ( not required, but much easier than a direct PC/Mac network connection )
• to access the video feeds. Syphon2NDI for the Mac ( http://techlife.sg/TCPSyphon/ )
• to access the Skeleton data. Configure the OSC to broadcast. ( see: https://forum.openframeworks.cc/t/broadcasting-with-ofxosc/1625/3 ) Both video and skeleton data can be shared over a wireless connection, however; video performance is much better with a gigabit ethernet connection.

Supported (provided via Spout):

• Black and White Mask (512 x 424)
• Color (1920 x 1080)
• Keyed (512 x 424) *CPU process
• Depth Image (512 x 424)

Supported:

• Body data as JSON
• Body elements as individual OSC addresses

MIT License http://en.wikipedia.org/wiki/MIT_License

• [video] Infrared
• [video] Long Exposure Infrared
• [video] Depth
• [video] Keyed via GLSL
• [OSC] add body features (eg hands open/closed)
• [video] add option to adjust levels for depth image / IR images
• [NDI] network video sharing

1. The release version requires the Kinect V2 SDK. https://www.microsoft.com/en-us/download/details.aspx?id=44561
2. The x86 2015 c++ redistributable is required from Microsoft as well. https://www.microsoft.com/en-us/download/confirmation.aspx?id=48145
3. To work with the code, you'll need the Kinect v2 SDK and the NewTek NDI sdk http://pages.newtek.com/NDI-Developers.html

Additional ofx addons are used:

• ofxGui (create parameters gui) *core addon
• ofxOsc (shares skeleton data) *core addon
• ofxInputField (adds text field for editing of OSC port & ip) https://github.com/fx-lange/ofxInputField
• ofxSpout2 (shares video with other applications) https://github.com/Kj1/ofxSpout2
• ofxNDI (networked video sharing) https://github.com/leadedge/ofxNDI
• ofxKinectForWindows2 https://github.com/elliotwoods/ofxKinectForWindows2