{"id":24829578,"url":"https://github.com/architj6/gesture-volume-control","last_synced_at":"2026-05-03T01:41:28.411Z","repository":{"id":274827527,"uuid":"924155012","full_name":"ArchitJ6/Gesture-Volume-Control","owner":"ArchitJ6","description":"Easily control your system volume with simple hand gestures! This project leverages OpenCV, MediaPipe, and Pycaw to track hand movements and adjust the system volume dynamically. Say goodbye to keyboard shortcuts and volume buttons—just move your hand to set the volume!","archived":false,"fork":false,"pushed_at":"2025-01-29T15:47:54.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T02:11:25.435Z","etag":null,"topics":["handgesture","mediapipe","numpy","opencv","os","pycaw","python","python3","volume-control"],"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/ArchitJ6.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}},"created_at":"2025-01-29T14:12:39.000Z","updated_at":"2025-01-29T15:49:37.000Z","dependencies_parsed_at":"2025-01-29T16:45:32.690Z","dependency_job_id":null,"html_url":"https://github.com/ArchitJ6/Gesture-Volume-Control","commit_stats":null,"previous_names":["architj6/gesture-volume-control"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchitJ6%2FGesture-Volume-Control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchitJ6%2FGesture-Volume-Control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchitJ6%2FGesture-Volume-Control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchitJ6%2FGesture-Volume-Control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArchitJ6","download_url":"https://codeload.github.com/ArchitJ6/Gesture-Volume-Control/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245573904,"owners_count":20637674,"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":["handgesture","mediapipe","numpy","opencv","os","pycaw","python","python3","volume-control"],"created_at":"2025-01-30T23:26:30.945Z","updated_at":"2025-10-19T03:35:38.971Z","avatar_url":"https://github.com/ArchitJ6.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gesture-Volume-Control 🎵✋  \n\nEasily control your system volume with simple hand gestures! This project leverages **OpenCV**, **MediaPipe**, and **Pycaw** to track hand movements and adjust the system volume dynamically. Say goodbye to keyboard shortcuts and volume buttons—just move your hand to set the volume!  \n\n---\n\n## 📌 Features  \n✅ **Real-time Hand Tracking** – Uses OpenCV and MediaPipe to detect and track hand movements efficiently.  \n✅ **Gesture-Based Volume Control** – Adjust system volume by changing the distance between your thumb and index finger.  \n✅ **Smooth \u0026 Responsive** – Optimized for real-time performance with minimal latency.  \n✅ **Cross-Platform Support** – Works on **Windows, macOS, and Linux**.  \n✅ **Lightweight \u0026 Easy to Use** – Requires minimal dependencies and runs with basic system resources.  \n\n---\n\n## 🖥️ Supported Operating Systems  \n| OS       | Supported |  \n|----------|-----------|  \n| Windows  | ✅ Yes  |  \n| macOS    | ✅ Yes  |  \n| Linux    | ✅ Yes  |  \n\n💡 **Note:** On **Linux and macOS**, ensure Pycaw alternatives like `pactl` (PulseAudio) or `os.system` commands are used for volume control.  \n\n---\n\n## 🚀 Installation  \n\nFollow these steps to set up and run the project:  \n\n### 1️⃣ Clone the Repository  \n```bash\ngit clone https://github.com/ArchitJ6/Gesture-Volume-Control.git\ncd Gesture-Volume-Control\n```\n\n### 2️⃣ Install Dependencies  \nEnsure you have Python **3.7+** installed. Then, run:  \n```bash\npip install -r requirements.txt\n```\n\n### 3️⃣ Run the Application  \n```bash\npython VolumeHandControl.py\n```\n\n---\n\n## 🏗️ How It Works  \nThe application captures video through the webcam and uses **MediaPipe** to detect hand landmarks. By measuring the distance between the **thumb and index finger**, it maps the distance to the system's volume level, adjusting it in real time.  \n\n📌 **Hand Gestures:**  \n- Move your thumb and index finger **closer** ➝ 🔈 Decrease volume  \n- Move them **farther apart** ➝ 🔊 Increase volume  \n\n---\n\n## 🛠️ Configuration  \nYou can tweak the sensitivity and behavior inside `VolumeHandControl.py`. Some key parameters:  \n- **Min/Max Hand Distance** – Defines the range for volume scaling.  \n- **Frame Rate Optimization** – Adjust camera frame processing speed.  \n\n---\n\n## 📥 Cloning (For Development)  \nIf you want to contribute or modify the project, clone it:  \n```bash\ngit clone https://github.com/ArchitJ6/Gesture-Volume-Control.git\ncd Gesture-Volume-Control\n```\n\n---\n\n## 🤝 Contributing  \nWe welcome contributions! 🚀  \n\n### Steps to contribute:  \n1️⃣ **Fork the repository** 🍴  \n2️⃣ **Create a new branch** (`git checkout -b feature-branch`) 🌱  \n3️⃣ **Make your changes** and commit (`git commit -m \"Your message\"`) 📝  \n4️⃣ **Push your changes** (`git push origin feature-branch`) 📤  \n5️⃣ **Submit a pull request** 🔀  \n\nFeel free to add new features, optimize performance, or improve the UI! 🎉  \n\n---\n\n## 📜 License  \nThis project is licensed under the **MIT License**. 🆓","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farchitj6%2Fgesture-volume-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farchitj6%2Fgesture-volume-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farchitj6%2Fgesture-volume-control/lists"}