Leap Mapper is an open-source application to manage and send Leap Motion data to any audio and visual software able to receive OSC and MIDI messages. With Leap Mapper you can also send Leap Motion data to any hardware with embedded MIDI connection through a MIDI I/O interface.
Leap Mapper is developed by Balandino Di Donato at Integra Lab.
- Install Java
- Launch LeapMapper
- Switch the MIDI or OSC for sending messages
- Open your MIDI or OSC receiver application. If you are sending data via OSC, the set your receiver's port at 5432.'
The MIDI port can be changed through source code
To change cc value of the single Leap Motion value, you need to open the relative MIDI.pde file and edit the parameters of the functions which send MIDI data.
To change cc values of Leap Motion values you have to open the MIDI.pde file
open <path>/<to>/LeapMapper/LeapMapper/MIDI.pde
and then edit the function to send MIDI data.
myBus.sendControllerChange(channel, cc, value);
NB: left hand Leap Motion data are sent on channel 1, and right hand Leap Motion data are sent on channel 2.
| channel | cc value | Velocity | Leap Motion parameter |
|---|---|---|---|
| 1/2 | 1 | 0-127 | Left/Right Yaw |
| 1/2 | 2 | 0-127 | Left/Right Pitch |
| 1/2 | 3 | 0-127 | Left/Right Roll |
| 1/2 | 4 | 0-127 | Left/Right Grab |
| 1/2 | 5 | 0-127 | Left/Right Pinch |
| 1/2 | 6 | 0-127 | Left/Right Thumb X |
| 1/2 | 7 | 0-127 | Left/Right Index Finger X |
| 1/2 | 8 | 0-127 | Left/Right Middle Finger X |
| 1/2 | 9 | 0-127 | Left/Right Ring Finger X |
| 1/2 | 10 | 0-127 | Left/Right Pinky Finger X |
| 1/2 | 11 | 0-127 | Left/Right Thumb Y |
| 1/2 | 12 | 0-127 | Left/Right Index Finger Y |
| 1/2 | 13 | 0-127 | Left/Right Middle Finger Y |
| 1/2 | 14 | 0-127 | Left/Right Ring Finger Y |
| 1/2 | 15 | 0-127 | Left/Right Pinky Finger Y |
| 1/2 | 16 | 0-127 | Left/Right Thumb Z |
| 1/2 | 17 | 0-127 | Left/Right Index Finger Z |
| 1/2 | 18 | 0-127 | Left/Right Middle Finger Z |
| 1/2 | 19 | 0-127 | Left/Right Ring Finger Z |
| 1/2 | 20 | 0-127 | Left/Right Pinky Finger Z |
Myo Mapper sends OSC messages at the port 5432. To change it you have to go through the following steps:
-
Open the osc.pde file within the Myo Mapper folder
open <path>/<to>/LeapMApper/LeapMapper/osc.pde(from terminal) -
Edit the host IP and port number at the 10th line of code:
Host IP Port | | V V
myRemoteLocation = new NetAddress("127.0.0.1",5432); // IP address and Port
- Save the osc.pde file
- Compile or Export application again.
Legend
- X = 1 left; 1 = right
- Y = finger number, 0, 1, 2, 3, 4
| Leap Motion parameter | OSC tag | Value type | Range values |
|---|---|---|---|
| Hands position | /handX/position |
float, float, float |
0-1, 0-1, 0-1 |
| Finfers position | /handX/fingerY/position |
float, float, float |
0-1, 0-1, 0-1, |
| Pinch | /handX/grab |
float |
0-1 |
| Grab | /handX/grab |
float |
0-1 |
- Leap Motion for Processing
- ControlP5
- oscP5
- The MidiBus
Copyright (c) 2016 - Balandino Di Donato
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.