{"id":30884206,"url":"https://github.com/albertomarquillas/gesture-mouse-control","last_synced_at":"2026-05-07T01:12:00.416Z","repository":{"id":313584013,"uuid":"1051922873","full_name":"AlbertoMarquillas/gesture-mouse-control","owner":"AlbertoMarquillas","description":"Real-time hand gesture tracking with OpenCV and MediaPipe to control system volume or emulate mouse actions.","archived":false,"fork":false,"pushed_at":"2025-09-07T03:16:40.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-07T05:35:37.037Z","etag":null,"topics":["computer-vision","gesture-recognition","hand-tracking","human-computer-interaction","mediapipe","opencv","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlbertoMarquillas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-07T02:29:43.000Z","updated_at":"2025-09-07T03:16:11.000Z","dependencies_parsed_at":"2025-09-07T05:35:41.237Z","dependency_job_id":"965c67d8-3050-414d-8a87-04f9416004a7","html_url":"https://github.com/AlbertoMarquillas/gesture-mouse-control","commit_stats":null,"previous_names":["albertomarquillas/gesture-mouse-control"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AlbertoMarquillas/gesture-mouse-control","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertoMarquillas%2Fgesture-mouse-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertoMarquillas%2Fgesture-mouse-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertoMarquillas%2Fgesture-mouse-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertoMarquillas%2Fgesture-mouse-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlbertoMarquillas","download_url":"https://codeload.github.com/AlbertoMarquillas/gesture-mouse-control/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlbertoMarquillas%2Fgesture-mouse-control/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274166988,"owners_count":25233962,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-08T02:00:09.813Z","response_time":121,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-vision","gesture-recognition","hand-tracking","human-computer-interaction","mediapipe","opencv","python"],"created_at":"2025-09-08T10:02:53.177Z","updated_at":"2026-05-07T01:12:00.384Z","avatar_url":"https://github.com/AlbertoMarquillas.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gesture Mouse Control\n\n![Language](https://img.shields.io/badge/language-Python-blue)\n![Framework](https://img.shields.io/badge/framework-OpenCV-green)\n![Library](https://img.shields.io/badge/library-MediaPipe-orange)\n![License](https://img.shields.io/badge/license-MIT-green)\n![Release](https://img.shields.io/github/v/release/AlbertoMarquillas/gesture-mouse-control)\n![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow)\n\n---\n\n## 📌 Overview\n\nThe **Gesture Mouse Control** project demonstrates how to use **hand-tracking with OpenCV and MediaPipe** to emulate system actions using real-time hand gestures. In this implementation, the gestures are mapped to **volume control**, but the framework can be extended to emulate other mouse or keyboard actions.\n\nThe project showcases how computer vision and human–computer interaction can be combined to build natural and intuitive interfaces.\n\n---\n\n## 📂 Repository Structure\n\n```\n\u003crepo\u003e/\n├─ src/                     # Source code\n│  ├─ main.py               # Entry point: runs the volume control app\n│  └─ hand_tracking_module.py # Hand tracking module (mediapipe wrapper)\n├─ test/                    # Placeholder for future tests\n├─ docs/                    # Documentation and assets\n│  └─ assets/               # Figures, screenshots, diagrams\n├─ notebooks/               # Optional experimentation notebooks\n├─ build/                   # Temporary outputs (ignored)\n├─ requirements.txt         # Dependencies\n└─ README.md                # Project documentation\n```\n\n---\n\n## ⚙️ Installation\n\nEnsure you have **Python 3.9+**. Install the dependencies listed in `requirements.txt`:\n\n```powershell\ngit clone https://github.com/AlbertoMarquillas/gesture-mouse-control.git\ncd gesture-mouse-control\npip install -r requirements.txt\n```\n\nTypical dependencies include:\n\n* `opencv-python`\n* `mediapipe`\n* `numpy`\n\n---\n\n## 🚀 Usage\n\nRun the application from the command line:\n\n```powershell\npython src/main.py\n```\n\n* The webcam feed will open.\n* The **hand landmarks** are detected in real time.\n* Gestures (e.g., distance between thumb and index fingers) are mapped to **system volume control**.\n\n\u003e ⚠️ Note: the current implementation modifies system volume. To extend it for **mouse control** or **other actions**, adjust the mapping logic inside `main.py`.\n\n---\n\n## 🔍 Features\n\n* **Real-time hand tracking** using **MediaPipe**.\n* **Gesture recognition** mapped to system actions.\n* **Volume control demo** included by default.\n* Modular code: `hand_tracking_module.py` encapsulates the MediaPipe logic.\n* Easily extendable to support other gestures and actions.\n\n---\n\n## 📚 What I Learned\n\nThrough this project I gained experience in:\n\n* Using **OpenCV** for real-time video processing.\n* Applying **MediaPipe** for robust hand-tracking.\n* Mapping geometric relationships (distance between landmarks) to actionable commands.\n* Designing intuitive human–computer interaction prototypes.\n* Structuring Python projects for clarity and reusability.\n\n---\n\n## 📜 License\n\nThis project is released under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falbertomarquillas%2Fgesture-mouse-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falbertomarquillas%2Fgesture-mouse-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falbertomarquillas%2Fgesture-mouse-control/lists"}