A wrapper for the Leap Motion SDK compatible with Leap 2.0 Beta with skeletal tracking
Switch branches/tags
Nothing to show
Clone or download
Latest commit 9875861 May 6, 2018



ofxLeapMotion2 is an OpenFrameworks addon for the second version of the LeapMotion SDK supporting skeleton tracking (beta 2.1). It is tested on Mac OSX, and should support Linux and Windows as well.

It is based on Theo Watson's original ofxLeapMotion addon.


git clone git://github.com/genekogan/ofxLeapMotion2.git

  • The addon should sit in openFrameworks/addons/ofxLeapMotion2/.

Running the Example Project


Xcode4: Open the Xcode project, select the "leapMotionExample Debug" scheme, and hit "Run".

How to Create a New ofxLeapMotion Project

To develop your own project based on ofxLeapMotion, simply copy the example project and rename it. You probably want to put it in your apps folder, for example, after copying:

openFrameworks/addons/ofxLeapMotion2/example_leap/ => openFrameworks/apps/myApps/example_leap/

Then after renaming:


Mac (Xcode):

Rename the project in Xcode (do not rename the .xcodeproj file in Finder!): Slow double click the project name and rename (Xcode4)

Linux ( command line )

You can simply navigate to the project folder and use make Debug, make Release or make and then execute with ./bin/example . If you have exported the OF_ROOT path you can also use make RunDebug or make RunRelease or make run ( othewise you will get an error on execution as it won't find the path of the linked .so )

Adding ofxLeapMotion to an Existing Project

Mac (Xcode):

In the Xcode project browser:

  • add the ofxLeapMotion2 sources to the project:

    • create a new group "ofxLeapMotion2"
    • drag these directories from ofxLeapMotion into this new group: ofxLeapMotion2/src & ofxLeapMotion2/libs

  • On OS X, you must have this in the Run Script Build Phase of your Xcode project. where the first path ../../../addons/ofxLeapMotion2/ is the path to the ofxLeapMotion addon.

cp -f ../../../addons/ofxLeapMotion2/libs/lib/osx/libLeap.dylib "$TARGET_BUILD_DIR/$PRODUCT_NAME.app/Contents/MacOS/libLeap.dylib"; install_name_tool -change ./libLeap.dylib @executable_path/libLeap.dylib "$TARGET_BUILD_DIR/$PRODUCT_NAME.app/Contents/MacOS/$PRODUCT_NAME";

If you don't have this you'll see an error in the console: dyld: Library not loaded: @loader_path/libLeap.dylib

Linux ( command line )

Simply add ofxLeapMotion2 to the addons.make file of your project. Remember that make RunDebug or make RunRelease or make run won't work if you don't have exported the OF_ROOT path. Executing with ./bin/yourappname will always work.

Developing ofxLeapMotion

Feel free to log bug reports and issues to the ofxLeapMotion Github page: https://github.com/genekogan/ofxLeapMotion2/issues