https://github.com/siddhant13421/gesture-music-player
Control your music player with hand gestures using OpenCV + MediaPipe. Play, pause, adjust volume, skip tracks, and scrub songs — all hands-free.
https://github.com/siddhant13421/gesture-music-player
gesture-recognition mediapipe musicplayer opencv python
Last synced: about 1 month ago
JSON representation
Control your music player with hand gestures using OpenCV + MediaPipe. Play, pause, adjust volume, skip tracks, and scrub songs — all hands-free.
- Host: GitHub
- URL: https://github.com/siddhant13421/gesture-music-player
- Owner: Siddhant13421
- Created: 2025-09-03T19:08:15.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-09-03T19:37:00.000Z (about 1 month ago)
- Last Synced: 2025-09-03T21:28:28.931Z (about 1 month ago)
- Topics: gesture-recognition, mediapipe, musicplayer, opencv, python
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
🎶 Gesture Music Player
A Python-based gesture-controlled music player that uses your webcam to detect hand gestures and control playback, volume, and track navigation.
Built with OpenCV and Media Pipe, it turns your hands into a controller — no keyboard needed.
------------------------------------------------------------------------------------------------------------------------------------------------------
✨ Features
- 👊 Fist → Play / Pause
- ✌️ V-Sign** → Mute / Unmute
- ☝️ Index Finger** → Next Track
- 🤙 Pinky Finger** → Previous Track
- 👍 Tap Thumb + Middle Finger Tip → Volume Up
- 👎 Tap Thumb + Middle Finger Tip → Volume Down
- 👌 OK-Sign with both hands → Scrub through track (forward/rewind)
- 🎨 Visual overlay with icons for gesture feedback
------------------------------------------------------------------------------------------------------------------------------------------------------
⚡ Requirements
Make sure you have Python 3.10+ installed.
Install the following tools/libraries before running:
```bash
pip install opencv-python
pip install mediapipe
pip install keyboard
pip install pyautogui
------------------------------------------------------------------------------------------------------------------------------------------------------
// How to Run:-
1. Clone this Repository:
git clone https://github.com/Siddhant13421/gesture-music-player.git
cd gesture-music-player
2. Create and activate a virtual environment:
python -m venv .venv
.venv\Scripts\activate # On Windows
3. Run the Program:
python main.py
------------------------------------------------------------------------------------------------------------------------------------------------------
// Notes:-
1. Works best in Good lighting
2. Default camera is 0 (laptop webcam). Change "config.json" to use another source
(e.g., DroidCam )
3. Icons must be placed in the icons/ folder with the exact filenames mentioned in "visuals.py".