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: about 2 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 (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-28T17:08:00.000Z (about 1 year ago)
- Last Synced: 2025-04-30T03:53:36.821Z (about 1 year 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
| Feature | Description |
|----------|--------------|
| ✋ **Hand Gestures** | Control system volume using hand gestures — pinch to decrease, spread to increase . |
| 🤖 **AI-Powered Tracking** | Uses **MediaPipe** for hand tracking and **OpenCV** for capturing video in real time. |
| 🎧 **System Integration** | Seamlessly integrates with system audio volume using **PyCaw**. |
| ⚡ **Lightweight & Easy to Use** | Fast, efficient, and simple to set up for a smooth user experience. |
---
## ⚙️ Requirements
Install the following dependencies -
```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 🤝
Want to contribute? Here's how:
1. 🍴 Fork the repository.
2. 🌿 Create a new branch (`git checkout -b feature-name`).
3. ✍️ Make your changes and commit them (`git commit -am 'Add feature-name'`).
4. 🚀 Push to your branch (`git push origin feature-name`).
5. 🔄 Submit a pull request to merge into the main branch.