Skip to content
This repository has been archived by the owner on Sep 19, 2022. It is now read-only.
/ YDL Public archive

A Simple GUI wrapper around yt-dlp for Windows using AHK

License

Notifications You must be signed in to change notification settings

pukkandan/YDL

Repository files navigation

Youtube-Dl Launcher (YDL)

A Simple GUI Launcher for my own fork of youtube-dl on Windows using AHK.

Prerequisites

Optional

  • ffmpeg - Required for mergring audio and video files together, extracting audio, embedding metadata etc
  • aria2c - Provides faster downloads for all non-DASH videos.

How to Use

  1. Install AHK1.1 and Python3.
  2. Download the optional prerequisites if needed.
  3. Download either the entire repository or just update.ahk and place the file(s) in an empty folder.
  4. Either make sure the all the prerequisites (except AHK) are available in PATH variable, or copy them to the script directory.
  5. Open update.ahk with AHK. This will download the latest version of both YDL and youtube-dl to the same folder.
  6. Open YDL.ahk with AHK.

Profiles

Any .conf file present in the script directory will be available as a profile. For more information on youtube-dl configuration files, refer to the official documentation.

The script makes two additional variables available in these configuration files:

  • %ydl_dir% which expands to the script directory AND
  • %ydl_home% which expands to the path given in the gui.

The profile MUST define the file naming pattern using the ydl_home variable. Eg: --output "%ydl_home%/%(uploader)s - %(title)s [%(id)s] (%(resolution)s).%(ext)s". Otherwise, the file will be downloaded to the path given in the profile (or in the script directory if either a relative path or no path is given).

It is recomended that you make your own profiles instead of editing the exising ones since updates will reset the profile back to default. (This issue will be fixed in a later version)

FAQ

What is the field called Options?

YDL accepts all the options of youtube-dl. These options override the settings generated by the script which in turn overrides the options in the profile.

The download never completes.

The download process is wrapped in retry.cmd which will keep retrying the download until youtube-dl exits without any error. So, if any of the videos is not downloadable (due to the video being removed/private/age-gated, url being wrong, etc), the download will never complete. You can simply break/close the terminal window to stop the download process.

The video is getting downloaded to the wrong folder.

The path given in the GUI is simply a guideline for the profile on where to download the video. The profile must define the file naming pattern using this information. See Profiles for details

Why use a custom fork of youtube-dl?

The format selection in YDL is done using the option --format-sort that I implemented but has not been (and probably never will be) merged with the main branch. Achieving the same effect using the main branch of youtube-dl is unnecessarily tedious and prone to error.

Can I use other branches/forks of youtube-dl with this?

Other branches of youtube-dl can be used as long as this pull request is merged into it.

If you are using a different branch, you have to change https://codeload.github.com/pukkandan/youtube-dl/zip/my-tweaks in update.ahk to the url of the zip file of your desired branch. You will also need to change "%~dp0\youtube-dl-my-tweaks\youtube_dl\__main__.py" in youtube-dl.cmd to the correct path

How do I update YDL/youtube-dl?

There is no auto-update in the current version of YDL. To update, you have to manually run update.ahk. Note that this updates both the program and youtube-dl, but not any other dependancies.

About

A Simple GUI wrapper around yt-dlp for Windows using AHK

Topics

Resources

License

Stars

Watchers

Forks