Skip to content

Wiki

Jump to bottom
Sergio edited this page Apr 12, 2025 · 1 revision

SoulDown Usage Wiki

souldown

SoulDown is a simple program that allows you to download audio from YouTube in different quality options and organize your downloaded files into folders based on their artist and album information. This wiki provides an overview of the main elements of the program and how to use them.

Table of Contents

No. Section
1 Interface Elements
2 Song URL
3 Select Audio Quality
4 Download Queue
5 Add to Queue Button
6 Download Queue Button
7 Total Progress Bar
8 Song Progress Bar
9 How to Use
10 Additional Features
11 Error Handling
12 Conclusion

Interface Elements

GUI

1. Song URL

  • Description: This is the input field where you enter the URL of the YouTube video you want to download.
  • Usage: Paste a YouTube URL into this field to add it to your download queue.

2. Select Audio Quality

  • Description: This dropdown allows you to choose the quality of the audio you want to download.
  • Options:
    • Low quality (96kbps)
    • Medium quality (128kbps)
    • High quality (320kbps)
  • Usage: Select one of the available options before adding the video to your download queue.

3. Download Queue

  • Description: This list displays the URLs you have added to the download queue, along with the selected audio quality.
  • Usage: This list is updated every time you add a new URL and quality to the queue.

4. Add to Queue Button

  • Description: Clicking this button adds the URL entered in the "Song URL" field to the download queue.
  • Usage: Once a URL is entered, press this button to add the song to the queue.

5. Download Queue Button

  • Description: This button starts the download of all the songs in the queue.
  • Usage: Press this button after adding URLs to the queue to start downloading the selected songs.

6. Total Progress Bar

  • Description: A progress bar that shows the overall progress of all the downloads in the queue.
  • Usage: This progress bar updates as each song in the queue is downloaded.

7. Song Progress Bar

  • Description: A progress bar for each individual song being downloaded, showing the download progress for that specific file.
  • Usage: This bar updates in real-time as each song is downloaded.

How to Use

  1. Enter a YouTube URL: In the "Song URL" field, paste the URL of the YouTube video you want to download.
  2. Select the Audio Quality: From the "Select audio quality" dropdown, choose your preferred audio quality (Low, Medium, or High).
  3. Add to Queue: Click the "Add to queue" button to add the video to the download queue. The song will be listed in the "Download queue" section.
  4. Download Queue: When you have added all the songs you want to download, click the "Download queue" button to start downloading all songs in the queue.
  5. Monitor Progress: You can monitor the overall download progress in the "Total progress" bar, and each song’s progress in the "Song progress" bar.

Additional Features

Cover Image Download

  • The program will automatically download the YouTube video's thumbnail and embed it as the album cover in the MP3 file, if available.

File Organization

  • Once all the songs are downloaded, the program will organize them into folders by artist and album name. This helps in keeping the downloaded songs well-organized in your file system.

Error Handling

  • If any step fails, a message box will appear to notify you of the error. Common errors include missing URLs, no selected quality, or no songs in the queue.

Conclusion

SoulDown is an easy-to-use program for downloading and organizing YouTube audio with customizable quality options. Simply add URLs, select quality, and press "Download queue" to start your downloads.

© SoulDown - By S3RGI09

Clone this wiki locally