https://github.com/anonymbyte-404/py-music-player
A desktop music player built with Python and Pygame, allowing users to play MP3 files, manage playlists, and toggle repeat functionality through a simple GUI.
https://github.com/anonymbyte-404/py-music-player
audio-player desktop-application gui mp3 music-player playlist-management python
Last synced: 3 months ago
JSON representation
A desktop music player built with Python and Pygame, allowing users to play MP3 files, manage playlists, and toggle repeat functionality through a simple GUI.
- Host: GitHub
- URL: https://github.com/anonymbyte-404/py-music-player
- Owner: anonymByte-404
- License: mit
- Created: 2025-01-11T04:32:34.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-03-07T03:21:42.000Z (3 months ago)
- Last Synced: 2025-03-07T04:25:49.508Z (3 months ago)
- Topics: audio-player, desktop-application, gui, mp3, music-player, playlist-management, python
- Language: Python
- Homepage:
- Size: 85 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
py-music-player
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.
Features
- 🎵 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
Installation
To run the project, make sure you have Python 3.x installed and then follow these steps:
1. Clone the repository:
```bash
git clone https://github.com/anonymByte-404/py-music-player.git
```
2. Navigate to the project directory:
```bash
cd py-music-player
```
3. Install required dependencies:
```bash
pip install -r requirements.txt
```
4. Run the main script:
```bash
python src/main.py
```
Usage
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:
1. 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.
2. You can move tracks up and down in the playlist, remove selected tracks, or shuffle the playlist using the provided buttons.
3. The volume can be adjusted with the volume slider, and the play/stop button allows you to toggle playback of the currently selected track.
4. 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!
License
This project is licensed under the MIT License - see the LICENSE file for details.