An open API service indexing awesome lists of open source software.

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.

Awesome Lists containing this project

README

        

py-music-player


MIT License
Version
Python Version
Python Version
Pygame Version
Tkinterdnd2 Version
Mutagen Version

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:


Desktop Music Player Preview

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.