SoulDown - S3RGI09

SoulDown is a Python desktop application that allows you to download full albums or individual songs from YouTube. It offers audio quality options and automatically organizes downloads into structured folders by artist and album. Additionally, it lets you manage a download queue with individual and total progress tracking.

You can access the website here

Main Features

• Full album downloads: Enter a YouTube playlist or album URL to download all songs.
• Individual song downloads: Select specific songs from an album to download.
• Audio quality options: Choose between low (96kbps), medium (128kbps), and high quality (320kbps).
• Automatic organization: Songs are saved in a structured folder format Artist/Album/Song.mp3.
• Cover art download: Automatically downloads and assigns album covers to each song.
• Download queue management: Add multiple albums to a queue and download them sequentially.
• Progress bars: View both individual and total queue download progress.
• Customizable interface: A graphical interface with a blue and black theme for a visually pleasant experience.

System Requirements

• Operating System: Windows, macOS, or Linux with Python 3.x support.
• Python: Version 3.6 or higher.
• Dependencies: Required libraries are listed in the requirements.txt file.

Installation

1. Clone or download the repository: Get the SoulDown source code from the official repository.
2. Navigate to the project directory:
   • Open a terminal or command prompt.
   • Go to the directory where the project is located.
3. Install dependencies:
   • Make sure pip is installed.
   • Run pip install -r requirements.txt to install all necessary dependencies.

Usage

1. Run the application:
   • In the terminal, inside the project directory, run python souldown.py.
2. Add an album to the queue:
   • In the graphical interface, enter the YouTube album or playlist URL in the designated field.
   • Select the desired audio quality.
   • Click "Add to Queue" to add the album to the pending downloads list.
3. Manage the queue:
   • View the queued albums in the designated section.
   • Reorder the list by dragging items as needed.
4. Download the queue:
   • Click "Download Queue" to start downloading.
   • Monitor the progress bars for individual and total queue download tracking.

Warning

This tool can be used for copyright infringement and piracy.
It is your responsibility to use it ethically and legally.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for more details.