A simple desktop music player built with Python, Pygame, and Tkinter, designed to play MP3 files and manage playlists.
Note
This project is still in development. While the core features are functional, there is still plenty of room for improvement and expansion.
- 🎵 Play MP3 files
- 📂 Load music files from a selected folder
- ➕ Add individual MP3 files to the playlist
- ⏯️ Toggle play/stop functionality for tracks
- 🔁 Toggle repeat mode for the current track
- 🔊 Adjust the volume through a slider
- 🎶 Shuffle the playlist order
- ⬆️ Move tracks up or down in the playlist
- 💾 Playlist is saved and loaded automatically from a JSON file
- 📥 Drag-and-drop support for loading MP3 files or folders
- 🖥️ User-friendly GUI built with Tkinter
To run the project, make sure you have Python 3.x installed and then follow these steps:
-
Clone the repository:
git clone https://github.com/yourusername/py-music-player.git
-
Navigate to the project directory:
cd py-music-player -
Install required dependencies:
pip install -r requirements.txt
-
Run the main script:
python src/main.py
Below is a detailed preview of the Desktop Music Player interface, showcasing its clean and user-friendly design, as well as the essential controls and features available to users for a smooth music listening experience:
- When the application starts, you can load MP3 files into the playlist using the "Load Folder" button or by adding individual MP3 files using the "Add File" button.
- You can move tracks up and down in the playlist, remove selected tracks, or shuffle the playlist using the provided buttons.
- The volume can be adjusted with the volume slider, and the play/stop button allows you to toggle playback of the currently selected track.
- You can also toggle repeat mode to repeat the current track once it finishes.
Feel free to contribute or open issues for bugs or feature requests!
This project is licensed under the MIT License - see the LICENSE file for details.