https://github.com/krishbharadwaj5678/gestune
Gestune turns your hand gestures into system volume control. Adjust audio levels effortlessly with a simple pinch or spread of your fingers. Touch-free, intuitive, and fun volume control at your fingertips!
https://github.com/krishbharadwaj5678/gestune
gesture-recognition hand-tracking mediapipe opencv python volume-control
Last synced: 6 months ago
JSON representation
Gestune turns your hand gestures into system volume control. Adjust audio levels effortlessly with a simple pinch or spread of your fingers. Touch-free, intuitive, and fun volume control at your fingertips!
- Host: GitHub
- URL: https://github.com/krishbharadwaj5678/gestune
- Owner: KrishBharadwaj5678
- Created: 2025-04-28T16:33:01.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-28T17:08:00.000Z (6 months ago)
- Last Synced: 2025-04-30T03:53:36.821Z (6 months ago)
- Topics: gesture-recognition, hand-tracking, mediapipe, opencv, python, volume-control
- Language: Python
- Homepage:
- Size: 588 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🤚 **Gestune**
Control your system volume with hand gestures! It's a fun, touch-free way to manage audio levels without reaching for the keyboard or mouse. 🖱️🔊
---
---
## 🚀 Features
- ✋ **Hand gestures** to control volume (pinch to decrease, spread to increase).
- 🤖 Uses **MediaPipe** for hand tracking and **OpenCV** for capturing video.
- 🎧 Seamlessly integrates with system audio volume using PyCaw.
- ⚡ Lightweight and easy to use.
---
## ⚙️ Requirements
Before running the application, make sure you have the following dependencies installed:
- 🐍 **Python 3.x**
- 📷 **OpenCV**
- 🖐️ **MediaPipe**
- 🔊 **PyCaw** (for controlling the volume)
To install the required dependencies, run the following command:
```bash
pip install opencv-python mediapipe pyautogui numpy
```
---
## 📝 How to Use
1. **Clone the repository:**
```bash
git clone https://github.com/KrishBharadwaj5678/Gestune.git
cd gestune
```
2. **Run the script:**
```bash
python VolumeHandControl.py
```
3. **Make gestures** ✋ in front of your camera to control the system's volume:
- 🤏 **Pinch** your thumb and second finger together to decrease the volume.
- ✋ **Spread** your thumb and second finger apart to increase the volume.
---
## 🤝 Contributing
We welcome contributions! If you'd like to contribute, feel free to fork the repository and submit a pull request. Here are a few ways you can help:
- 🐞 Bug fixes
- 🛠️ Code improvements
- ✨ Feature requests