O-Hands Quick Reference
Essential shortcuts and features at a glance
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Cmd/Ctrl+1 |
Full UI mode |
Cmd/Ctrl+2 |
Performance mode |
Cmd/Ctrl+3 |
Blackout mode |
Cmd/Ctrl+Shift+F |
Toggle fullscreen |
Cmd/Ctrl+Shift+T |
Toggle transparency |
Cmd/Ctrl+Shift+O |
Overlay mode |
Escape |
Exit fullscreen |
Performance Mode Only
| Shortcut | Action |
|---|---|
Cmd+C |
Toggle camera |
Cmd+H |
Toggle hands |
Cmd+M |
Toggle mappings |
Hand Features
Position
- Palm X — Left ↔ Right
- Palm Y — Down ↔ Up
- Palm Z — Away ↔ Toward
Fingers
0 = straight, 1 = curled
- Thumb Curl
- Index Curl
- Middle Curl
- Ring Curl
- Pinky Curl
State
- Hand Openness — Overall spread
- Pinch Distance — Thumb to index
Rotation
- Roll — Left/right tilt
- Pitch — Forward/back tilt
- Yaw — Horizontal rotation
Velocity
- X — Horizontal speed
- Y — Vertical speed
- Z — Depth speed
Output Types
| Type | Use For |
|---|---|
| CC | Filter, volume, effects — continuous control |
| Note | Triggers, drums, melodies |
| Pitch Bend | Smooth pitch control (14-bit) |
| Aftertouch | Expressive pressure control |
| OSC | Max, TouchDesigner, SuperCollider, etc. |
Response Curves
| Curve | Best For |
|---|---|
| Linear | Equal response throughout |
| Exponential | Filter, volume — slow start, fast end |
| Logarithmic | Pitch, frequency — fast start, slow end |
| S-Curve | Crossfaders — smooth at extremes |
Common OSC Ports
| Application | Port |
|---|---|
| Max/MSP | 9000 |
| TouchDesigner | 9000 |
| SuperCollider | 57120 |
| Pure Data | 9000 |
Local IP: 127.0.0.1
Virtual MIDI Drivers
| Platform | Driver |
|---|---|
| macOS | IAC Driver (built-in) — enable in Audio MIDI Setup |
| Windows | loopMIDI (free) |
| Linux | ALSA virtual ports |
Troubleshooting
No tracking?
→ Check lighting, face a light source
Jittery output?
→ Increase Smoothing in Settings
No MIDI?
→ Check device selection, use Test CC
OSC not working?
→ Verify IP:port, check firewall