{"id":28762260,"url":"https://github.com/kunalmehra075/volume-control-opencv","last_synced_at":"2026-05-08T10:35:56.572Z","repository":{"id":293821113,"uuid":"984830444","full_name":"KunalMehra075/Volume-Control-OpenCV","owner":"KunalMehra075","description":"Virutal Volume Controller — OpenCV + MediaPipe, Control your system volume using just your fingers — no keyboard, no mouse, just pure gesture magic! 🖐️🤏 ","archived":false,"fork":false,"pushed_at":"2025-05-17T10:16:12.000Z","size":9858,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T08:07:36.804Z","etag":null,"topics":["autopy","cv2","hand-tracing","hand-tracking","handcontrol","mediapipe","opencv","python","python3","virtual-controller","volume","volumehandcontrol","webdev"],"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/KunalMehra075.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,"zenodo":null}},"created_at":"2025-05-16T15:21:34.000Z","updated_at":"2025-05-17T10:16:15.000Z","dependencies_parsed_at":"2025-05-17T23:31:00.718Z","dependency_job_id":null,"html_url":"https://github.com/KunalMehra075/Volume-Control-OpenCV","commit_stats":null,"previous_names":["kunalmehra075/volume-control-opencv"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KunalMehra075/Volume-Control-OpenCV","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KunalMehra075%2FVolume-Control-OpenCV","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KunalMehra075%2FVolume-Control-OpenCV/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KunalMehra075%2FVolume-Control-OpenCV/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KunalMehra075%2FVolume-Control-OpenCV/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KunalMehra075","download_url":"https://codeload.github.com/KunalMehra075/Volume-Control-OpenCV/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KunalMehra075%2FVolume-Control-OpenCV/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260318699,"owners_count":22991120,"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":["autopy","cv2","hand-tracing","hand-tracking","handcontrol","mediapipe","opencv","python","python3","virtual-controller","volume","volumehandcontrol","webdev"],"created_at":"2025-06-17T08:07:36.550Z","updated_at":"2026-05-08T10:35:56.537Z","avatar_url":"https://github.com/KunalMehra075.png","language":"Python","funding_links":["https://www.buymeacoffee.com/kunalmehra"],"categories":[],"sub_categories":[],"readme":"# 🔊 Virtual Volume Controller — OpenCV + MediaPipe Project\n\nControl your system volume using just your **fingers** — no keyboard, no mouse, just pure gesture magic! 🖐️🤏  \nBuilt using **Python**, **OpenCV**, and **MediaPipe**, this project uses your webcam to detect finger distance and adjust the volume in real time.\n\n## 🖼 Demo\n\n![Demo](assets/Demo.gif)\n\n## 🎯 How It Works\n\n📷 Your webcam tracks your **index finger** and **thumb** using MediaPipe's hand tracking.  \nThe distance between them determines the volume level:\n\n- 👉✌️ **Stretch fingers wide** → Volume increases\n- 🤏 **Bring fingers close** → Volume decreases\n- 👈👉 **Touch both fingers** → System is **muted**\n\nThis is a simple yet powerful demo of **gesture-based human-computer interaction**!\n\n## 🚀 Features\n\n✅ Real-time finger tracking with MediaPipe  \n✅ Dynamically adjust system volume based on finger distance  \n✅ Mute system when fingers are touching  \n✅ Clean UI using OpenCV overlays  \n✅ Works offline (on Windows)\n\n## 🧠 What You’ll Learn\n\n- Hand landmark detection using **MediaPipe**\n- Measuring Euclidean distance between fingers\n- Mapping distance to volume percentage\n- Controlling system audio using **pycaw** (Windows)\n\n## 🛠 Setup Instructions\n\n1.  **Install the required dependencies, globlally or by creating a virtual environment:**\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n2.  **Run the application:**\n\n    ```bash\n    python volumeHandControl.py\n    ```\n\n## 🧰 Tech Stack \u0026 Dependencies\n\n- Python\n- OpenCV\n- MediaPipe\n- pycaw (for controlling system volume on Windows)\n\n#### Buy me a coffee 🥹:\n\n\u003ca href=\"https://www.buymeacoffee.com/kunalmehra\" target=\"_blank\"\u003e\n\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\n\u003c/a\u003e\n\nContributions are welcome! 🙏 If you have any ideas for improvements, feel free to submit a pull request.\\\nFollow me for more exciting projects like this! 🤩\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkunalmehra075%2Fvolume-control-opencv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkunalmehra075%2Fvolume-control-opencv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkunalmehra075%2Fvolume-control-opencv/lists"}