Kinect-via-Synapse Max Interface

    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.
    Tool Files
    • Max interface screenshot

    • eufrasio prates
      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!!!
    • jpbellona's icon
      jpbellona's icon
      Jun 22 2012 | 11:00 am
      Thanks Eufrasio! I've added these as add-ons for future updates.
    • coralie's icon
      coralie's icon
      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 ?
    • jpbellona's icon
      jpbellona's icon
      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.
    • Byron Lahey's icon
      Byron Lahey's icon
      Byron Lahey
      Nov 20 2013 | 10: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!
    • Byron Lahey's icon
      Byron Lahey's icon
      Byron Lahey
      Nov 20 2013 | 10: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.
    • Byron Lahey's icon
      Byron Lahey's icon
      Byron Lahey
      Nov 20 2013 | 11:01 pm
      Ok, one more try on the attachment (it seems like one of those days... ;^)
    • ekin horzum's icon
      ekin horzum's icon
      ekin horzum
      Apr 06 2015 | 3:50 pm
      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?
    • jpbellona's icon
      jpbellona's icon
      Dec 09 2015 | 12:03 am
      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
    • Amandda Kao's icon
      Amandda Kao's icon
      Amandda Kao
      Aug 01 2017 | 12:33 am
      Hey all, I was just wondering if the new kinect for xbox One would work with this? I just want to make sure before I purchase one. Thanks in advance!
    • Candace Hazelwood's icon
      Candace Hazelwood's icon
      Candace Hazelwood
      Nov 13 2017 | 6:23 pm
      I am on Windows 7. have synapse folder on Desktop and kinect-via-synapse in max-packages, but I tried to 'add folders to search path' in max file browser and it gives the error "error while trying to add kinect-via-synapse to file path" so I assume that is why when I open the davinci presentation patch all the data is 0? thanks for any help.