Documentation
Everything you need to get started with FingerGuns, from installation to advanced gesture controls.
Quick Start Guide
Download
Download the latest version of FingerGuns and extract the files to your preferred location.
Camera Setup
Position your webcam to capture both your face and hand gestures with good lighting.
Calibration
Run the calibration utility to set your neutral positions and sensitivity preferences.
Start Gaming
Launch CSGO, start FingerGuns, and experience gesture-based controls in action.
Recommended System Requirements
For optimal performance and smooth gesture tracking experience
Recommended Specs
- OS: Windows 11 / macOS 12+ (Monterey or later)
- Processor: Intel Core i7 / AMD Ryzen 7 / Apple M1/M2
- Memory: 16 GB RAM
- Camera: 1080p webcam at 60 FPS (30 FPS acceptable, but 60 FPS provides better tracking)
- Python: Python 3.8+ with pip
- Dependencies: MediaPipe, OpenCV, PyAutoGUI, NumPy
Note: Actual camera FPS performance depends on CPU capability. The system uses 120 FPS interpolation to ensure smooth cursor movement regardless of camera framerate.
Gesture Controls Reference
Right Hand - Gun Control
| Gesture | Action | Description |
|---|---|---|
| Gun Gesture | Activate Aiming | Index finger out, bottom 3 fingers curled |
| Index Finger Move | Aim Crosshair | Move index finger tip to control cursor |
| Thumb Down | Fire Weapon | Press thumb down to start firing |
Left Hand - Actions (Palm Facing Camera)
| Gesture | Action | Key Pressed |
|---|---|---|
| 1 Finger Down | Crouch | CTRL |
| 4 Fingers Down | Jump | SPACE |
Body & Head - WASD Movement
| Movement | Action | Description |
|---|---|---|
| Head Forward | Move Forward (W) | Lean head forward to activate |
| Head Backward | Move Backward (S) | Lean head backward to activate |
| Body Lean Left | Strafe Left (A) | Lean body left (strong = hold, weak = tap) |
| Body Lean Right | Strafe Right (D) | Lean body right (strong = hold, weak = tap) |
Facial Gestures
| Gesture | Action | Key Pressed |
|---|---|---|
| Stick Out Tongue | Spray Emote | T |
Keyboard Shortcuts
| Key | Action |
|---|---|
| G | Toggle control ON/OFF |
| + | Increase sensitivity (0.1-1.0) |
| - | Decrease sensitivity |
| Q | Quit program |
Troubleshooting
Hand tracking is not working
Ensure your hand is clearly visible in the camera frame with adequate lighting. Avoid backgrounds with similar skin tones or complex patterns.
Try adjusting camera position or increasing ambient lighting.
Controls are too sensitive or not sensitive enough
Run the calibration utility to adjust sensitivity thresholds and deadzones to match your movements.
Settings can be fine-tuned in the configuration file.
High latency or lag
Close other resource-intensive applications. Ensure your webcam is set to recommended resolution and frame rate.
Lower camera resolution may improve performance on older systems.
Python dependencies error
Ensure all required packages are installed: MediaPipe, OpenCV, PyAutoGUI, and NumPy. Run the included installation script.
Check that you're using Python 3.8 or later.