Skip to content

We aim to provide an accessible way of using youtube-dlp thanks to this frontend scripts

License

Notifications You must be signed in to change notification settings

Sprinter05/ytdlp-handler

Repository files navigation

YT-DLP Handler

A frontend for yt-dlp created by Sprinter05 with a Linux/MacOS version created by tulip-sudo.

Installation

Dependencies

Windows 10/11

Automatic Installation

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.

Manual Installation

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).

Linux/BSD

Install Python 3.7+ from your package manager.

Rolling Release Distributions

Download both FFMPEG and yt-dlp from your package manager.

Stable Release Distributions

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.

MacOS

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.

Post-Dependencies

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.

Settings

Program Settings

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.

YouTube Download

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).

Video Processing

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).

Audio Processing

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.

License

ytdlp-handler is released under the LGPLv3 license. Please refer to the LICENSE file for more information