# SpotDL GUI
A user-friendly graphical interface for the [`spotdl`](https://github.com/spotDL/spotify-downloader) command-line tool, making it easy to download music from Spotify without using terminal commands.

## Overview
A user-friendly graphical interface for downloading Spotify songs, albums, and playlists using spotdl.

![License](https://img.shields.io/badge/License-GPLv3-blue?style=for-the-badge&labelColor=black&color=blue)
![SpotDL GUI](https://img.shields.io/badge/Python-3.10_|_3.11_|_3.12_|_3.13-blue?style=for-the-badge&labelColor=black&color=blue)
![Version](https://img.shields.io/badge/Version-0.1.3-orange?style=for-the-badge&labelColor=black)

## Features
- 🎵 Download Spotify songs, albums, and playlists
- 🎨 Clean, modern GUI built with PyQt5
- 🌙 Dark/Light mode toggle
- 🎚️ Multiple audio formats (MP3, WAV, FLAC)
- 📊 Adjustable bitrate settings (128k, 192k, 256k, 320k)
- 📁 Custom folder structure options
- 📊 Download counter with reset functionality
- 📝 Real-time output log with color-coded messages
- 🖼️ System tray integration
- 🎯 One-click folder opening

## Screenshots
<img width="1280" height="720" alt="Image" src="https://github.com/user-attachments/assets/3e7e013b-533e-47db-94b1-2f820525a42e" />
<img width="1280" height="720" alt="Image" src="https://github.com/user-attachments/assets/cb34bbbd-9936-4834-953f-b3cb87802c93" />

## Prerequisites
Before using this application, you must install `spotdl` version `4.4.2` :

```
pip install spotdl==4.4.2
```

### System Requirements
- **Python**: 3.10 or higher
- **FFmpeg**: Required for audio conversion

# Installation
```
pip install spotdl_gui
```
# Usage
<sub>Type the following into your terminal<sub>
```
spotdl_gui
```

# License
This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.