🎵 Python Music Player (CMD + GUI)

A dual-interface Music Player built using Python, featuring both a Command-Line Interface (CLI) and a Graphical User Interface (GUI) built with PyQt6.
It supports MP3/WAV playback, song directory selection, pagination, album art extraction, and volume control.

---

📸 Screenshots

🖥️ Command-Line Interface (CMD)

Intro Screen	Main Screen	Song List

🪟 Graphical User Interface (GUI)

Intro	Main	Drag Drop	Drag Drop Song	Settings

---

🚀 Features

🔹 Common Features

• Play .mp3 and .wav files using pygame
• Supports next, previous, repeat, and random song playback
• Adjustable volume controls
• Save and load last-used music directory
• Exception handling for robustness

💻 CMD Version

• Simple and intuitive terminal UI
• Paginated song listing using tabulate
• Menu-driven navigation
• Directory management via settings

🪟 GUI Version (PyQt6)

• Elegant, modern interface with background and album art
• Drag & Drop folder loading
• Embedded album art from songs (via mutagen)
• Persistent settings for last used folder
• Interactive buttons for playback, volume, and navigation
• Sound effects for transitions

---

🧩 Project Structure

📂 Music-Player
│
├── 📁 cmd
│   ├── main.py
│   ├── access_songs_directory.py
│   ├── operations.py
│   ├── settings.py
│   └── icons.py
│
├── 📁 gui
│   ├── main_one.py
│   ├── main.py
│   ├── main_frame.py
│   ├── intro.py
│   ├── load.py
│   ├── operations.py
│   ├── operations2.py
│   ├── settings.py
│   ├── access_songs_directory.py
│   └── 📁 assets
│       ├── 📁 images
│       ├── 📁 sounds
│       └── 📁 dir
│
├── 📁 screenshots
│   ├── 📁 cmd
│   └── 📁 gui
│
├── .gitignore
├── .python-version
├── requirements.txt
├── README.md
└── LICENCE

---

⚙️ Installation & Setup

1️⃣ Clone the repository

git clone https://github.com/hunjanhar/music-player.git
cd music-player

2️⃣ Create a virtual environment

python -m venv venv
source venv/bin/activate   # For macOS/Linux
venv\Scripts\activate      # For Windows

3️⃣ Install dependencies

pip install -r requirements.txt

▶️ Usage

🖥️ Run the Command-Line Version

cd cmd
python main.py

• Enter your song directory when prompted.
• Use menu options (1–10) to navigate, play, pause, and manage songs.

🪟 Run the GUI Version

cd gui
python main.py

• Drag and drop a folder containing .mp3 or .wav files.
• Use playback buttons to control the player.

---

🧠 Technologies Used

Library	Purpose
Pygame	Audio playback & sound effects
PyQt6	GUI interface
Mutagen	Extracting embedded album art
Tabulate	Table formatting in CMD
OS, Math, Random	File management & logic handling

---

📜 License

• This project is licensed under the MIT License — see the LICENSE file for details