gesture-control-cursor

A sophisticated hand gesture-based computer control system

https://github.com/shauryan28/gesture-control-cursor

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.1%) to scientific vocabulary

Keywords

ai gesture-detection handsfree-interaction motion-tracking
Last synced: 6 months ago · JSON representation ·

Repository

A sophisticated hand gesture-based computer control system

Basic Info
  • Host: GitHub
  • Owner: Shauryan28
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 7.81 KB
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Topics
ai gesture-detection handsfree-interaction motion-tracking
Created about 1 year ago · Last pushed about 1 year ago
Metadata Files
Readme License Citation

README.md

Gesture Control System

Made with ❤️ by Shaurya Nandecha

A sophisticated Python-based gesture control system that allows you to control your computer's mouse cursor using hand gestures captured through your webcam. This project combines computer vision and machine learning to create a natural and intuitive way to interact with your computer.

Features

  • Control mouse cursor with index finger movements
  • Left click and drag with index finger + thumb pinch
  • Right click with middle finger + thumb pinch
  • Double click with quick double pinch
  • Activate/deactivate gesture control with "Yo" sign (index and pinky up)
  • Smooth cursor movement with enhanced gesture detection
  • Debug visualization mode

Requirements

  • Python 3.7 or higher
  • Webcam
  • Required Python packages (install using pip install -r requirements.txt):
    • OpenCV
    • MediaPipe
    • PyAutoGUI
    • NumPy

Installation

  1. Clone this repository: bash git clone https://github.com/Shauryan28/Gesture-Control-Cursor.git cd Gesture-Control-Cursor

  2. Install required packages: bash pip install -r requirements.txt

Usage

  1. Run the program: bash python gesture_control.py

  2. To activate/deactivate gesture control:

    • Make a "Yo" sign (index finger and pinky up, other fingers down)
    • Hold it for 1 second
    • Status will change from "Inactive" (red) to "Active" (green)
  3. When active:

    • Move index finger to control cursor
    • Pinch index finger and thumb for left click
    • Hold pinch and move for drag operations
    • Quick double pinch for double click
    • Pinch middle finger and thumb for right click
  4. To quit:

    • Press 'q' while the webcam window is focused
    • Or close the webcam window

Debug Visualization

The program includes visual feedback to help with gesture recognition: - Green circles: Extended fingers - Red circles: Folded fingers - Blue circles: Thumb position when near middle/ring fingers - Purple line: Appears when "Yo" sign is detected

Citation and Credits

If you use this project in your work, please provide appropriate credit by:

  1. Adding a citation in your README: markdown This project uses [Gesture Control System](https://github.com/Shauryan28/Gesture-Control-Cursor) by [Shaurya Nandecha](https://github.com/Shauryan28).

  2. Adding a star ⭐ to the original repository

  3. If you create a derivative work, please maintain the original credit in your code and documentation: python """ Based on Gesture Control System Original work by Shaurya Nandecha (https://github.com/Shauryan28) """

For academic use, please cite as: bibtex @software{nandecha2024gesture, author = {Shaurya Nandecha}, title = {Gesture Control System}, year = {2024}, publisher = {GitHub}, url = {https://github.com/Shauryan28/Gesture-Control-Cursor} }

Author

Shaurya Nandecha - GitHub: @Shauryan28

License

This project is licensed under the MIT License - see the LICENSE file for details.


If you found this project helpful or interesting, please consider giving it a ⭐️ on GitHub!

Owner

  • Login: Shauryan28
  • Kind: user

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it using these metadata."
title: "Gesture Control System"
abstract: "A sophisticated hand gesture-based computer control system that lets you control your mouse cursor using natural hand movements."
type: software
authors:
  - family-names: Nandecha
    given-names: Shaurya
    orcid: # Add your ORCID if you have one
repository-code: "https://github.com/Shauryan28/Gesture-Control-Cursor"
url: "https://github.com/Shauryan28/Gesture-Control-Cursor"
keywords:
  - gesture-control
  - computer-vision
  - human-computer-interaction
  - python
  - mediapipe
license: MIT
version: 1.0.0
date-released: "2024-02-27" 

GitHub Events

Total
  • Watch event: 1
  • Push event: 1
  • Create event: 2
Last Year
  • Watch event: 1
  • Push event: 1
  • Create event: 2

Dependencies

requirements.txt pypi
  • mediapipe >=0.8.9
  • numpy >=1.19.0
  • opencv-python >=4.5.0
  • pyautogui >=0.9.53