Music Player with Python

A modular and versatile music player ecosystem built with Python. From a lightweight CLI to a feature-rich modern GUI, this project offers multiple ways to enjoy your local music library.

---

Quick Start (Latest Version)

To dive straight into the most advanced version (GUI v2):

# Navigate to the latest version
cd v1.0.1

---

Evolution of the Project

This repository tracks the development of the music player through three distinct phases:

GUI Version 1.0.1 (Latest)

The most advanced iteration with a focus on User Experience.

• Playlist Sidebar: Real-time discovery of all tracks in your library.
• Smart Navigation: Sequential playback with Next and Previous controls.
• Volume Management: Integrated slider for precise audio control.
• Modern UI: Sleek, responsive layout built with customtkinter.

GUI Version 1.0.0

The initial transition from CLI to Graphical Interface.

• Simple, distraction-free playback.
• Single-file focus for testing core GUI logic.
• Lightweight and fast.

CLI Version (Legacy)

The core engine that started it all.

• Terminal-based selection and control.
• Zero GUI overhead.
• Perfect for low-resource environments.

---

Key Features

• Auto-Discovery: Automatically scans the music_files/ directory for .mp3 and .wav files.
• Intuitive Controls: Full Play/Pause/Resume/Stop functionality across all versions.
• Premium Aesthetics: High-quality dark mode visuals powered by CustomTkinter.
• Audio Engine: Robust playback engine powered by the industry-standard pygame.mixer.

---

Installation & Prerequisites

Ensure you have Python 3.x installed. Then, install the required dependencies:

pip install -r requirements.txt

Setup your Library

1. Ensure the music_files/ folder exists in the root.
2. Drop your favorite music files (.mp3 or .wav) into that folder.
3. Launch any version of the player!

---

Project Structure

.
├── v1.0.0/                      # v1.0.0 Release
├── v1.0.1/                      # v1.0.1 Release (Premium)
├── music_files/                 # Your Audio Assets
├── music.py                     # Legacy CLI Script
├── LICENSE                      # MIT License
└── README.md                    # Project Documentation

---

Controls (CLI Mode)

Action	Key	Description
Pause	P	Pauses current track
Resume	R	Resumes from pause
Stop / Quit	S / Q	Stops track and returns to menu

---

License

Distributed under the MIT License. See LICENSE for more information.