A frontend for yt-dlp created by Sprinter05 with a Linux/MacOS version created by tulip-sudo.
Download the setup.bat file from the releases page and run it. Open the ytdlp-handler folder and run start.cmd once the installation has completed.
Download FFMPEG essentials and place the ffmpeg
and ffprobe
binaries (located inside the bin folder) within your PATH. Then download the yt-dlp .exe file (If you get any problems, it is recommended to try the x86 binary, but remember to rename it when using it) and also place it within your PATH (Unless you want to use LEGACY
mode, in which case you will need the youtube-dl binaries).
Install Python 3.7+ from your package manager.
Download both FFMPEG and yt-dlp from your package manager.
Download FFMPEG (from your package manager) and then download yt-dlp from pip using python3 -m pip install --user -U yt-dlp
(Note: This won't be in PATH by default. Make sure to add it!)
This is recommended as on some distributions (Like Ubuntu 22.04 LTS), the version of yt-dlp that is provided has bugs relating to downloading .mkv files.
Install Python 3.7+ from your package manager.
Install a package manager (e.g. Brew) then install FFMPEG.
Next, install yt-dlp either from pip (python3 -m pip install --user -U yt-dlp
) or from your installed package manager.
After installing the necessary dependencies, execute the file specific to your OS after downloading it from the releases page.
For Windows 10/11, the executable is the start.cmd file.
For older versions of Windows, the executable is the start_win.cmd file.
For both Linux and MacOS, the executable is the start.sh file.
NOTE: start_win.cmd has been deprecated since 3.0 and the installer/updater will already fit the needs of the Windows version.
LEGACY
- Enables Legacy mode which uses youtube-dl instead of the default yt-dlp binaries. Some settings might not work in Legacy mode (check .ini file for more information).
MUSICDIR
- This is where audio-only downloads are stored. Value is a path.
VIDEODIR
- This is where video files are stored. Value is a path.
EXPLORER
- Opens your file browser after download audio/video. Value is a number that is either 1 or 0 (1 being enabled).
REOPEN
- Launches the executable again after finishing the operation instead of closing the program (if the value is set to 1).
CHECKUPD
- Checks for updates when the program (start.cmd) is ran. Requires a changelog.txt file in order to work.
RATELIMIT
- Determines if a download speed limiter should be applied. Value is a number that is either 1 or 0 (1 being enabled).
SPEED
- Affects the download speed limit if RATELIMIT
is enabled. Value should be a number followed by a single letter to indicate the unit being used (K for Kilobytes, M for Megabytes etc.)
VIDEOQUALITY
- Determines which resolution should be downloaded for videos with the value specifically being the video height. Value is a positive whole number.
THUMBNAIL
, SUBTITLES
, METADATA
- Enables downloading the specific feature. Value is a number that is either 1 or 0 (1 being enabled).
CHAPTERS
- Divides the download into multiple files depending on the amount of chapters (if available).
REMUX
- Determines if a downloaded MP4 should be remuxed instead of being entirely re-encoded. Disable if you want to import the MP4 to a video editing software. Value is a number that is either 1 or 0 (1 being enabled).
POSTPROCESSING
- Enables post-processing for MP4 files. Affected by PPARGS
. Value is a number that is either 1 or 0 (1 being enabled). It is recommended to read the yt-dlp README before modifying this and PPARGS.
PPARGS
- FFMPEG post-processing arguments (It is recommended to read the FFMPEG docs before messing with this.
DEBUG
- Enables verbose logging. Helpful if an error occurs! Value is a number that is either 1 or 0 (1 being enabled).
AUDIOQUALITY
- Affects the quality of audio downloaded. This only affects FFMPEG conversion from m4a to any other audio format and does not affect video audio. Accepts a number between 0 and 10 (inclusive). The best is 0 and the worst is 10. The default (5) is 128K.
ytdlp-handler is released under the LGPLv3 license. Please refer to the LICENSE
file for more information