Menu
HomeFeaturesWindowsAndroidDocumentationBlog
Documentation Menu

Troubleshooting

Welcome to the Gestro Troubleshooting Center. If you are experiencing issues, locate your problem category below.

Camera & Hardware Issues

Problem: Camera feed is black or unavailable

  • Cause: Another application (Teams, Zoom, OBS, browser) is holding exclusive access to the webcam. Windows Privacy settings may be blocking access.
  • Solution: Close other apps using the camera. Go to Windows Settings > Privacy & Security > Camera and ensure "Let desktop apps access your camera" is toggled ON. Restart Gestro.

Problem: Very low FPS or high CPU usage

  • Cause: Your CPU is struggling to run the high-fidelity AI models in real-time.
  • Solution: Open Gestro Settings > Performance. Switch the AI Engine mode from "Quality" to "Performance". This will reduce CPU load significantly.

Gesture & Tracking Issues

Problem: Gestures are not recognized or are misidentified

  • Cause: Poor lighting, hands moving too fast, or hands too close/far from the camera.
  • Solution: Ensure the room is well-lit. Avoid sitting with a bright window directly behind you (backlighting blinds the camera). Keep your hand between 0.5m and 1.5m from the lens.

Problem: Gestures trigger accidentally (False Positives)

  • Cause: The gesture confidence threshold is set too low.
  • Solution: Go to Settings > Gestures. Increase the "Confidence Threshold" slider to 85% or higher.

Air Mouse Issues

Problem: The cursor is jittery and hard to control

  • Cause: Natural hand tremors or poor lighting confusing the landmark detection.
  • Solution: Go to Settings > Air Mouse. Increase the "Smoothing Factor" (EMA filter). This will add slight latency but massively stabilize the cursor.

Problem: Pinch-to-click is not registering

  • Cause: The camera cannot clearly see the separation and joining of your thumb and index finger.
  • Solution: Rotate your hand slightly so the camera has a clear profile view of your thumb and index finger interacting.

Voice Control Issues

Problem: Voice commands are ignored

  • Cause: Background noise is interfering, or microphone volume is too low.
  • Solution: Check your Windows Sound Settings and ensure the correct microphone is selected and the input volume is at least 70%. Ensure you are speaking clearly.

Application Mapping Issues

Problem: Custom application gestures are not working

  • Cause: Gestro is not detecting that the application is active.
  • Solution: Ensure the application window is focused (clicked into). If it's a web app inside Chrome, Gestro maps to "Chrome", not the specific website.

Cloud Sync Issues

Problem: Changes on my laptop aren't showing on my desktop

  • Cause: One of the devices lost internet connection, or sync is paused.
  • Solution: Open the Dashboard on both devices and verify the "Cloud Status" indicator is green. Click "Force Sync" in the settings if necessary.

Ready to change how you interact?

Join thousands of users who have revolutionized their workflow with Gestro.