Skip to content
This repository has been archived by the owner on Apr 4, 2023. It is now read-only.

findot/leaplog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

leaplog

A simple Leap Motion logger.

Installation

Leaplog supports Windows, OSX, and Linux. To do so, we can't use Leap Motion versions ulterior to the 2.3.1 release. This version was compiled for python2. This is, hence, the python version leaplog uses.

  1. Download the Leap Motion client software v2.3.1 for your operating system and install it. Depending on the said operating system, the installation process may vary.

    1. For windows users: Execute Leap_Motion_Setup_4(...).exe and follow the instructions. Users who installed the 2017 Fall Creator's Update, follow this guide to get the driver to work.
    2. For OSX users: Execute the Leap_Motion_Installer_release(...).dmg file and follow the instructions.
    3. For Linux users: On Debian-based distributions, the installer is a native deb file. To install the Leap Motion on a different distribution, you'll have to either search the web for a ported package (arch users can find one on the AUR) or use a package converter (alien for fedora & Cie). Note that the deb package was linked with dependencies that are now out of date so you may have to containerize the driver in a way or another (chroot, docker) to resolve dependency issues.
  2. Install leaplog dependencies :

    pip2 install --user -r requirements.txt
  3. Finally, initialize the database :

    python2 -m leaplog initdb

Usage

  1. Start the server :

    python2 -m leaplog serve
  2. Reach the webapp which by default listens on 0.0.0.0 at port 8000.

  3. Recorded data will be saved in the data.db file.

License

The project is MIT licensed as described in the LICENSE file. Leap Motion documentation and libraries (lib/ and doc/ folders) are properties of Ultraleap Ltd and are, therefore, licensed under their terms.