Relapse Music Player is a web-based music player built using Flask, a Python web framework. It allows users to play audio files (MP3 and WAV formats) stored in a designated music directory. The application provides a UI to browse and play music files, with an API endpoint to retrieve the playlist. If you're remembering a moment and want to relapse into those memories—whether it's a song that takes you back to a forgotten summer or a melody that stirs old emotions—this player is here to help you relive those feelings through music.
- 🎵 Audio Support: Play MP3 and WAV audio files
- 🌐 Web Interface: Clean, intuitive browser-based UI
- 🤚 Hand Gesture Controls: Control playback without touching your device
- Open Palm → Play/Resume
- Fist → Pause
- Two Fingers Swipe Left → Previous Track
- Two Fingers Swipe Right → Next Track
- ⚡ Lightweight: Minimal setup and resource usage
1. Clone the Repository
2. Install Dependencies
pip install flask
pip install opencv-python mediapipe flask pygame
3. Directory Structure
Ensure your music files (MP3 or WAV) are placed in a directory named music within the project folder:
4. Run the Application
python music_player.py
The app will start on http://127.0.0.1:5000 by default.
Web Interface
- Browse your music collection in the web interface
- You can import songs
- Click on any track to start playing
- Use the standard playback controls
Gesture Controls
- Ensure your webcam is connected and functioning
- Position yourself in front of the camera
- Use the hand gestures listed in the features section
- Make sure your hand is clearly visible to the camera
© 2025 Juliana Mancera