Kinect-via-Synapse Max Interface

Download Links
Max interface screenshot Tool Site

First published in Dec. 2011, Kinect-via-Synapse Max Interface routes and displays user-tracking data from the XBox Kinect via OSC messages inside Max/MSP. No external drivers required, although you will need Synapse (, as well as the OSC-route external. The interface handles fifteen /joint messages for a single user, three different tracking modes, and six different joint event messages with a real time configuration of external routing options. Includes installation, guide manual, as well as credits.

Additional URLs

Jun 21 2012 | 5:35 pm

That’s an amazing patch, especially if need to use part of the Kinect dataflow as an event triggering. Thanks for sharing!
I would only add 2 basic steps for rookies in Kinect/OSC use:
1) after starting Synapse, don’t forget to stay in position (stand up and put your arms up) and wait for skeleton detection, and
2) pause (but don’t quit) OSCulator (or other software you use for OSC communication) after making the handshake in channel 12345 or 12347 (a tricky step you have to do before setting the patch at the right UDP channel).
Nice job!!!

Jun 22 2012 | 11:00 am

Thanks Eufrasio! I’ve added these as add-ons for future updates.

Jun 20 2013 | 12:01 pm

This is great, I am just stating using it. Thank you so much for offering this tool! I would try to add a second user tab, although I am not completely sure how to do it. I have noticed that the kinect wouldn’t scan a second user. Is this a kinect + maxMSP + synapse bug, or is it just because this functionality is missing ?

Jun 20 2013 | 6:32 pm

Synapse only tracks a single user. Not a bug, just what the feature is. If you like Kinect-Via-, you may also try my simpleKinect, which is a stand-alone app that sends OSC data out. simpleKinect takes the good parts of Synapse and combines them with the good parts of other openNI apps. Easy to send over to Max, and also sends distances between joints.

Nov 20 2013 | 2:41 pm

Has anyone seen this problem:

After launching synapse and starting Kinect-via-synapse, error messages start appearing in the Max window. They say: % OSC-route: invalid message pattern righthand does not begin with /

(screenshot of errors attached)

I have kinect-via-synapse working perfectly on my MacBook Pro, but some of my students are trying to use it on lab computers (also MacBook Pro) and are seeing this error. No data shows in the initial data screen in kinect-via-synapse (after toggling options on to do so) and no data is received in "r rhnd1x" objects created in another max patch. The skeleton is created in synapse and the OSC indicator flashes in the OSC input window in kinect-via-synapse. No other programs are running when this problem occurs. Restarts of Max and synapse do nothing. This problem was replicated on two computers with two separate (but matching model 1414) kinects.

Any suggestions would be greatly appreciated!

PS. Jon, thank you for creating and sharing this software!

Nov 20 2013 | 2:52 pm

Here is the attachment mentioned in the previous post. Didn’t notice that the screen shot was too large on the first try.

Nov 20 2013 | 3:01 pm

Ok, one more try on the attachment (it seems like one of those days… ;^)

  1. Screen-Shot-2013-11-20-at-2.47.04-PM


Apr 06 2015 | 8:50 am

Hey Byron and everyone,

I have the same problem using Kinect-via-Osceleton: " % OSC-route: invalid message pattern l_hand does not begin with / "

Could you or anyone come up with a solution?

Dec 08 2015 | 4:03 pm

Whoa! I’m out of the loop. This is definitely not timely, but for any future viewers, Kinect-Via-Synapse is now at version 1.2.1, and should have addressed the OSC-route issue from the previous two posts. At least, I was not able to recreate the issue when I updated. This should also address Byron’s receive object issue. New version (1.2.1) is on github or at

Viewing 9 posts - 1 through 9 (of 9 total)

Explore More

Subscribe to the Cycling ’74 Weekly Newsletter

Let us tell you about notable Max projects, obscure facts, and creative media artists of all kinds.

* indicates required