Everything you need to know about GestureV — from setup to advanced customization.
Quick Start
Watch the full tutorial to get started in under 2 minutes.
1
Go to gesturev.com and sign inUse Google or GitHub. Copy your User ID from the dashboard.
2
Run this command in your terminal (Windows, macOS, or Linux): npx gesturev@latest --user-id=YOUR_ID
Replace YOUR_ID with your User ID from the dashboard above. Requires Node.js installed.
3
Open GestureV any time with one command gesturevPoint your index finger to move the mouse. Pinch to click. Open the Bindings Editor to customize gestures.
How It Works▾
1
Your webcam captures videoMediaPipe processes hand landmarks and face mesh in real-time on your machine. Nothing leaves your computer.
2
Gesture detection engineThe controller recognizes 72 gestures: pointing, pinching, swiping, winking, smiling, head nods, and more.
3
Actions fire based on your bindingsEach gesture maps to an action: press a key, open a URL, type text, or launch an app. Edit these in the Bindings Editor.
4
Cloud sync keeps bindings everywhereEdit bindings on the website, they sync to your controller every 30 seconds. One account, all your devices.
Cloud Sync & Account▾
☁
Your bindings live in the cloudSave bindings at gesturev.com/editor. They are stored with your account. Any device running the controller can pull them.
↻
Auto-sync every 30 secondsThe controller checks for binding updates in the background. No restart needed.
📱
Multiple devices, same profileInstall GestureV on your desktop, laptop, and work computer. All share the same bindings.
🔒
Private by defaultAll gesture processing is local. Only your binding configs (not video) sync to the cloud.
Open the Bindings EditorClick "Edit Bindings" on the dashboard, or go to gesturev.com/editor. Sign in with your account.
2
Pick a gesture from the sidebarGrouped by type: Face, Mouse, Hand, Combo, Motion, Two-Hand. Green = enabled, gray = disabled, blue = locked.
3
Choose an action type⌨ Key single key (space, enter, a, f5) • ⌘ Hotkey combo (ctrl+c, alt+tab) • ✎ Type type text • ⚡ URL open website • 📂 App launch app
4
Enter value and saveHit "Save Binding" — it syncs to your controller automatically within 30 seconds.
Keyboard Shortcuts & CLI▾
Controller Window
❌qQuit the controller
✎tToggle mouse on/off
📄vVerbose logging
👀fToggle face gestures
✋gToggle hand gestures
🎯hToggle hand tracking
↻backspaceRecalibrate
Web UI
⌘1 / 2 / 3 / 4Switch pages
⎋EscBack to Dashboard
🔍/ or Ctrl+KSearch gestures
CLI Flags
--user-idYour GestureV account ID
--cloud-urlCloud server (default: gesturev.com)
--calibration-durationCalibration time in seconds
--skip-webcam-checkSkip webcam test
Troubleshooting▾
!
Mouse moves erratically or jumpsImprove lighting, face the camera directly, and ensure your hand is clearly visible. Try enabling Cursor Smoothing in Quick Settings to reduce jitter.
!
Face gestures not detectingMake sure Face Detection is enabled in Quick Settings. Check that your face is well-lit and centered. Re-calibrate by pressing backspace in the video window.
!
Bindings not syncingCheck that you're signed in on the website and your user ID matches the one used to install. The controller syncs every 30 seconds — wait or restart the controller to force sync.
!
"Python was not found" after installingClose your terminal and reopen it, then run gesturev. If needed, run the installer command again from Setup & Install.
!
Controller won't startRe-run the installer command from Setup & Install, then run gesturev. Check controller.log for errors.
!
"ModuleNotFoundError" or missing packagesRe-run the installer command from Setup & Install to rebuild dependencies, then run gesturev.
!
Camera not foundEnsure your webcam is connected and not in use by another app. Check Windows Privacy Settings → Camera → allow desktop apps.
!
Gestures are delayedClose other applications using the camera or heavy CPU. Check the FPS counter on the Dashboard — aim for 30+ FPS.
Frequently Asked Questions▾
Q
Does GestureV work on Mac or Linux?Yes. Use the install command shown in Setup & Install. It installs dependencies automatically on Windows, macOS, and Linux.
Q
Is my webcam data sent anywhere?No. All processing happens locally on your machine. Only your binding configs (not video) sync to the cloud.
Q
Can I use GestureV without a webcam?No. GestureV requires a webcam to detect hand and facial gestures. Any standard USB webcam works.
Q
How do I update GestureV?Re-run the installer command from Setup & Install, then launch with gesturev.
Q
Can I have GestureV on multiple computers?Yes! Sign in with the same account on each device. All bindings sync automatically. You can also edit them on the website.
Q
Do I need to be online for gestures to work?Once synced, the controller works fully offline. You only need internet for initial setup and to sync binding changes.
Tips for Best Results
☀Good lightingFace a light source
👤Center yourselfFace the camera directly
🏡Clear backgroundLess clutter behind you
⏱Hold gesturesSteady for ~0.5s
📷Clean lensWipe your camera
💻Close background appsFree up CPU & camera
Still Need Help?
Check controller.log for debugging info. Join our community or open an issue on GitHub.
