TouchFree Tooling for Web is a lightweight client that can be integrated into your Web application, turning it touchless with minimal development effort.

This Quick Start Guide will show you how to import the client into your Web application. For more details visit the TouchFree User Manual on our Developer Resources Site.


Using the Quick Start Examples

Once you have imported TouchFree Tooling, a Quick Start Example webpage is provided.

This will allow you to test that TouchFree Tooling is working with TouchFree Service. It also serves as an example of how to integrate TouchFree Tooling. This page can be found in the Examples directory in the TouchFree Tooling for Web package.

Integrating TouchFree Tooling

Once you have the example page running, you’re ready to integrate TouchFree Tooling into your own application. You can reference the raw HTML of the Quick Start Example for the setup required to access the TouchFree Tooling.

We recommend duplicating the Quick-Start_Example.js and modifying it in order to make changes. This will prevent the file being overwritten when upgrading to newer versions of Tooling in future.

Note that this file depends on the content of TouchFree_Tooling.js being available under the name TouchFree.

We have a collection of TouchFree Tooling Examples on GitHub that you can use to learn how to integrate features of TouchFree Tooling into your application.



  • ServiceStatus now includes the service version, tracking version, camera serial number and camera firmware version.

  • New tooling events:

    • OnServiceStatusChange event - provides data about the status of the TouchFree Service whenever it changes.

    • WhenConnected event - functions identically to OnConnected but will dispatch an event immediately if already connected to the TouchFree Service.

    • IsConnected function exported as part of the top level TouchFree object for querying whether or not the client is connected to the TouchFree Service.

    • HandEntered event disptached when the active hand enters the interaction zone (if enabled).

    • HandExited event disptached when the active hand exits the interaction zone (if enabled).

  • Ability to set the IP and port that tooling should connect to the service via.

  • SVGCursor.SetColor allows you to set the color of the SVGCursor center fill, ring fill or center border.

  • SVGCursor.ResetToDefaultColors allows you reset the color of the entire SVGCursor back to it's default colors.

  • Cancelled drags (i.e. due to hands lost) now send pointerOut and pointerCancel events to element where the drag started

  • Improved error and warning messaging when TouchFree Tooling and Service API versions do not match.

    Bug Fixes

    • Improved reliability of Scrolling with the WebInputController

    • Improved reliability of touchfree-no-scroll making elements unscrollable (with TouchFree Tooling)

All users developing with Ultraleap hand tracking devices and/or software need a license.
By downloading TouchFree you are agreeing to the Ultraleap Tracking SDK Agreement and End User License Agreement.