soulhotel / yor-ytdlp

Your very own YT-DLP Tool TUI

This script simplifies the use of yt-dlp for scenarios where the User often desires multiple different outputs. It does so through its user-friendly "menu's" that guide the user with simple 1-2-3 steps. By guiding the user through commonly requested options with clear prompts, this script makes using yt-dlp a minimal effort task for the typical entry-level power user.

Also its lightweight! 7kb compared to the alternative of GUI applications that can exceed 100mb (like electron apps..).

How it works

0. The script operates through "pages", listed below in 1-7.

1. The User can input a URL or press ENTER to default to URLs in ~/Downloads/ytdlp/url.txt

   • ✔ The script validates URLs and creates the directory for you
   • ✔ Multiple URLs in the url.txt can batch custom download
   • ✔ Entering a Playlist URL can batch custom download
   • ✔ Drag & Drop URLs into the script to select it

2. The User selects audio or video.

3. The User decides if they want a playlist or single file (if applicable).

4. The User determines what quality they would like.

5. Subtitles, yes, no, embedded? (for videos).

6. Restrict file name? keeping it short.

7. Finally, destination. Press ENTER to default to Downloads/ytdlp/ or Specify a folder path.

Note: This script (by default) downloads the best format available for videos, it may result in recieving an .mkv file for one video and .mp4 file for another video. Meanwhile, mp3s defaults to best quality possible with embed thumbnail/cover-art.

See it in action

2024-06-05.15-38-51-mc.mp4

Usage

• Ensure that you already have yt-dlp on your system.
• Git clone this repo or download the source above.
• Make the script an executable then run it.
• Drag a URL in, or use the text file.
• Make your choices.
• Profit.

git clone https://github.com/soulhotel/yor-ytdlp.git

cd yor-ytdlp
chmod +x yor-ytdlp.sh

To have it show up in your applications list and searches

• place the .desktop file in the appropriate directory, usually /home/user/.local/share/applications.
• If you place the script somewhere other than ~/yor-ytdlp/ then open the .desktop file and make sure the Exec path is set accordingly.

Other

• See a Media Conversion Tool (script) utilizing the ffmpeg library.
• See ./starterfiles. My personal collection of scripts and resources.