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.