Get Started with Leap Motion VR Development BETA


Attach the Leap Motion VR Developer Mount

Lost the mount attachment instructions?     Download PDF

Note: The Oculus firmware limits bandwidth for the DK2’s built-in USB port, which harms the controller’s performance. We recommend using the free cable extender bundled with the mount to connect the controller directly to the computer. For more known issues, click here.

Installation and Optimization

  1. Download the Leap Motion SDK with enhanced head-mounted tracking. Run the installer bundled with the package.

    (Be sure to download the latest software, as tracking will be less accurate with older versions.)

  2. Calibrate your Leap Motion Controller. If you’re using your controller for the first time, this will help ensure optimal tracking. You’ll find the option to Recalibrate on the Troubleshooting tab in the Leap Motion Control Panel (click “Settings…” from the system tray).

  3. Allow Images from the Leap Motion Control Panel. This allows apps to access the infrared video passthrough.

  4. Download the Oculus Rift Runtime and run the installer. Be sure to have the latest version installed.

  5. Find the best configuration for you (mirroring or using extended display) in your operating system's Display settings. You also may have to experiment with the Display options (resolution, rotation) to ensure correct rotation for the screen. It may seem cumbersome at first, but you'll learn quickly how to set your VR station up.


Try a Leap Motion VR Experience

Build Your First Leap Motion VR Application

  1. Before you begin, make sure that you follow the steps in Installation and Optimization.

  2. Starting with v2.1.3, you must set the policy flags POLICY_IMAGES and POLICY_OPTIMIZE_HMD to access the Image API and head-mounted tracking in your application:

    // In C++ controller.setPolicyFlags(static_cast(Leap::Controller::PolicyFlag::POLICY_IMAGES | Leap::Controller::PolicyFlag::POLICY_OPTIMIZE_HMD));
  3. If you're building your first app from scratch, be aware that the head-mounted perspective is slightly different (POLICY_OPTIMIZE_HMD) from the Leap Motion Controller's usual table setup. We have a few code examples to help you:

    All platforms: Check out our VR essentials guide for insights on building from scratch.

    C++: The source code for Leap Motion VR Intro is available here.

    Unity: We provide assets that take care of the transformation for you. Download Core Assets: VR Edition from our Unity downloads page and check out our UI Widgets, Quick Switch and other resources on the Examples Gallery.

    JavaScript: Check out our JavaScript VR Quickstart demo, which you can use in your own projects.

Note: positional tracking on the DK2 is not affected by the mount – so track away!