{"id":26047832,"url":"https://github.com/wasifsohail5/virtual_mouse","last_synced_at":"2025-08-02T22:10:08.415Z","repository":{"id":281108925,"uuid":"944217643","full_name":"WasifSohail5/Virtual_Mouse","owner":"WasifSohail5","description":"Virtual Mouse is an AI-powered, gesture-based control system that replaces traditional peripherals with hand movements. Using MediaPipe for hand tracking and PyAutoGUI for cursor control, it enables seamless clicking, scrolling, and navigation through simple gestures. Experience a futuristic, touchless interaction with your PC! 🚀🖱️","archived":false,"fork":false,"pushed_at":"2025-03-07T03:07:49.000Z","size":37,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-14T23:47:12.111Z","etag":null,"topics":["cv2","mediapipe","mediapipe-hands","numpy","opencv","pyautogui","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WasifSohail5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-03-07T01:21:45.000Z","updated_at":"2025-03-07T03:10:42.000Z","dependencies_parsed_at":"2025-03-07T03:34:48.852Z","dependency_job_id":null,"html_url":"https://github.com/WasifSohail5/Virtual_Mouse","commit_stats":null,"previous_names":["wasifsohail5/virtual_mouse"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/WasifSohail5/Virtual_Mouse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WasifSohail5%2FVirtual_Mouse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WasifSohail5%2FVirtual_Mouse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WasifSohail5%2FVirtual_Mouse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WasifSohail5%2FVirtual_Mouse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WasifSohail5","download_url":"https://codeload.github.com/WasifSohail5/Virtual_Mouse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WasifSohail5%2FVirtual_Mouse/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264647521,"owners_count":23643651,"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","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":["cv2","mediapipe","mediapipe-hands","numpy","opencv","pyautogui","python"],"created_at":"2025-03-07T23:14:16.366Z","updated_at":"2025-07-10T20:08:05.530Z","avatar_url":"https://github.com/WasifSohail5.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🖱️ **Virtual Mouse – Hands-Free Computer Control** 🚀🖐️\n\nRevolutionize the way you interact with your computer! **Virtual Mouse** leverages cutting-edge AI and computer vision to transform your **hand gestures** into seamless mouse movements, clicks, and scrolling. No need for physical peripherals – just **gesture, control, and navigate effortlessly!** 🏆\n\n---\n\n## ✨ **Key Features** 🔥\n\n🔹 **Real-Time Hand Tracking:**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;🎯 Powered by **MediaPipe**, ensuring precise and fast tracking.  \n\n🔹 **Gesture-Based Controls:**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;🖱️ **Left Click:** Pinch your index finger and thumb together.  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;🖱️ **Double Click:** Perform a quick double pinch.  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;🖱️ **Right Click:** Touch your middle finger to your thumb.  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;🖱️ **Scroll Mode:** Activate scrolling by aligning fingers in a vertical motion.  \n\n🔹 **Smooth Cursor Movement:**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;💡 Adaptive smoothing techniques ensure fluid and natural cursor motion.  \n\n🔹 **Customizable Sensitivity:**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;⚙️ Adjustable thresholds for clicks and scroll actions for personalized control.  \n\n🔹 **No Extra Hardware Needed!**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;📸 Just use your **webcam** to bring gestures to life!  \n\n---\n\n## 🛠 **How It Works** 🔍\n\n📷 **Step 1: Webcam Capture**  \nOpenCV accesses your webcam, flips the video for a **mirror view**, and processes the frames in real time.\n\n✋ **Step 2: Hand Landmark Detection**  \nMediaPipe detects hand landmarks and extracts **critical points** such as fingertips and knuckles.\n\n📐 **Step 3: Gesture Recognition**  \nUsing **distance calculations** between fingertips, Virtual Mouse interprets gestures like clicks and scrolls.\n\n🖥️ **Step 4: Mouse Control**  \nPyAutoGUI maps detected hand movements to your screen, ensuring a seamless experience.  \n\n⚡ **Flow Diagram:**  \n```mermaid\ngraph LR\nA[Webcam Capture] --\u003e B[Hand Landmark Detection]\nB --\u003e C[Gesture Recognition]\nC --\u003e D[Cursor Control \u0026 Clicks]\nD --\u003e|Output| E[Real-Time Mouse Interaction]\n```\n\n---\n\n## 🚀 **Installation Guide** 🏗️\n\n### ✅ **Prerequisites**\n- **Python 3.x**  \n- **Pip** for package management  \n\n### 🛠 **Setup Instructions**\n\n1️⃣ **Clone the Repository:**\n   ```bash\n   git clone https://github.com/your-username/virtual-mouse.git\n   cd virtual-mouse\n   ```\n\n2️⃣ **Install Dependencies:**\n   ```bash\n   pip install -r requirements.txt\n   ```\n   *If you don't have a `requirements.txt`, install manually:*  \n   - `opencv-python` (for video capture)\n   - `mediapipe` (for hand tracking)\n   - `pyautogui` (for cursor control)\n   - `numpy` (for mathematical operations)\n\n3️⃣ **Run the Application:**\n   ```bash\n   python Virtual\\ Mouse.py\n   ```\n\n---\n\n## 🛠 **Technologies Used** 🧩\n\n| **Technology**         | **Purpose**                              |\n| ---------------------- | -----------------------------------------|\n| **Python**             | Core programming language                |\n| **OpenCV**             | Capturing and processing video frames    |\n| **MediaPipe**          | Hand detection and landmark tracking     |\n| **PyAutoGUI**          | Simulating mouse movements and clicks    |\n| **NumPy**              | Numerical operations and smoothing logic |\n\n---\n\n## 🎯 **Future Enhancements** 🚀\n\n✅ **Enhanced Gesture Recognition:**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;➖ More intuitive gestures for additional functionality.  \n\n✅ **Voice Command Integration:**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;🎙️ Combine hand gestures with **voice control** for a futuristic experience.  \n\n✅ **Customizable UI Dashboard:**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;🖥️ A visual interface to tweak settings, sensitivity, and control modes.  \n\n✅ **Cross-Platform Compatibility:**  \n\u0026nbsp;\u0026nbsp;\u0026nbsp;💻 Optimizing performance for Windows, macOS, and Linux.  \n\n---\n\n## 🌟 **Experience the Future of Touchless Interaction!** ✨\n\nVirtual Mouse brings **gesture-based control** to life. Forget traditional peripherals – navigate your PC **effortlessly, smoothly, and intuitively!** 🎯\n\n📢 **Contribute \u0026 Collaborate:**  \nHave ideas or improvements? Join the project and help enhance the Virtual Mouse experience! 🚀\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwasifsohail5%2Fvirtual_mouse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwasifsohail5%2Fvirtual_mouse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwasifsohail5%2Fvirtual_mouse/lists"}