Kinect2share

kinect2share

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.

Features

Video

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)

OSC : Skeleton

Supported:

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

License

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

TODO

• [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~~

Donations Accepted

---

---

Notes

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