handWavey

A more intuitive/usable desktop control using leapmotion/ultramotion.

You can see it in action and learn how to get the most out of handWavey.

If you use it, I'd love to hear from you.

Table of contents

• handWavey
  • Table of contents
  • Where does handWavey Work?
  • Requirements
    • Hardware
    • Softare
  • Run
    • Linux
    • Windows
    • MacOS
  • Install
  • Safety
  • Contributing

Where does handWavey Work?

Platform	Experience	Support
Linux - X	Excellent	Native
Linux - Wayland	Poor	Only VNC, so far. Hopefully native soon. Note that it works well enough that you can run it locally, and connect to VNC locally without needing to expose VNC to the rest of the network.
Windows 10	Excellent	Native
Windows 11	Unknown	Unknown - Probably native. Definitely via VNC.
MacOS	Poor	May be possible to get it working with a hack. Otherwise via VNC.

More context.

Requirements

Hardware

• LeapMotion controller.
  • Getting the device set up well.

Softare

• LeapMotion/UltraLeap SDK 2.3.1.
• Java. One of:
  • OpenJDK.
  • Or Oracle's Java.

Run

Linux

1. Satisfy the requirements.
2. Copy libraries from the LeapMotion SDK to lib.
3. Test that you have everything installed correctly: ./gradlew test
4. Run it: ./gradlew run

Windows

1. Satisfy the requirements.
2. copy build.gradle.windows build.gradle
3. Copy libraries from the LeapMotion SDK to lib.
4. Test that you have everything installed correctly: gradlew.bat test
5. Run it: gradlew.bat run

MacOS

This is theoretically possible, but has not been tested. There are known challenges.

1. Satisfy the requirements.
2. Copy libraries from the LeapMotion SDK to lib.
3. Test that you have everything installed correctly: ./gradlew test
4. Run it: ./gradlew run

Install

• Linux.
• Windows.
• MacOS. (This is theoretically possible, but has not been tested. There are known challenges.)

Safety

I believe this to be safe to use long term. But I have no medical or ergonomic background to back that up.

Please use your intelligence and judgement when using this.

If you notice any changes in discomfort, pain, stiffness, or you have any doubts whatsoever; please stop using it immediately, and seek medical advice. Only resume using it after you have medical advice saying that it's ok for you to resume.

Nothing in this repo, or any related material should be understood to be medical advice.

By using this software, you are taking responsibility for staying healthy.

Contributing

• Pull requests welcome.
• Report bugs.
• Support me on Patreon. - There will be better ways of doing this soon.