Repository files navigation

yt-dlp-adv is a remake of the original yt-dlp-adv, written in Python.A clean CLI script to download videos, audio, and thumbnails from YouTube.

This Script utilizesyt-dlp for downloading content from YouTube.

• Requirements
• Installation
  • Automatic Installation (Experimental)
  • Manual Installation
• Usage
• Features
  • Filename Creator / Playlist Name Creator
  • Config Editor
• Screenshots
• License
• Acknowledgements

• An operating system with aUnix filesystem.¹

• Python 3.12 or higher

• FFmpeg

• ImageMagick

Install yt-dlp-adv2 using one of the following commands:

The installation script can add an alias to your bashrc/zshrc file to execute yt-dlp-adv2:

alias yt-dlp-adv="\"/Install/Location/yt-dlp-adv/.venv/bin/python\"\"/Install/Location/yt-dlp-adv/main.py\""

To install the program manually, run the following command in your terminal:

git clone https://github.com/AstroLightz/yt-dlp-adv2.gitcd yt-dlp-adv2python3 -m venv .venvsource .venv/bin/activatepip install -r requirements.txt

Then see theUsage section below.

To use the program, run the following command in your terminal:

source .venv/bin/activatepython3 main.py

• Download videos, audio, and thumbnails from YouTube

• Download playlists or single items

• Choose what file format to use

• If you are downloading a playlist, choose a playlist name format

• Choose filename format to use

  • e.g. (uploader) - (title).(ext)

• Dynamic directory location for each type of download²

  • Music: ~/Music/YouTube Downloads
  • Videos: ~/Videos/YouTube Downloads
  • Artwork: ~/Pictures/YouTube Downloads

• Custom download status messages

• See overview of download after download is complete

Don't like the default filename format presets? Make your own using theCustom option in the menu.

There are two modes to use:

• Simple: Menu-driven creation where you get to pick format parts to assemble your format.
• Advanced: You can enter your own output template. Seetheyt-dlp documentation for more info onoutput templates.

Filename Creator can be accessed through the Downloader, Config Editor, or by passing-f or--format-editor as anargument tomain.py

Playlist Name Creator, like Filename Creator, allows you to make your own playlist name format.Choose fromSimple orAdvanced mode to create your playlist name format.

Playlist Name Creator can be accessed through the Downloader when downloading a Playlist, Config Editor, or bypassing-f or--format-editor as an argument tomain.py

Customize how yt-dlp-adv works through theConfig Editor. View, edit, and reset your config file throughuser-friendly menus.

Your config file is stored in script's directory asconfig.yml.³

Config Editor can be accessed by passing-c or--config as an argument tomain.py

Info on development can be found in theTODO file.

This project is released under theUnlicense. ChecktheLICENSE file for more information.

• yt-dlp: Backbone of this whole project
• Wand: Thumbnail conversion
• termcolor: Colored output
• ruamel.yaml: YAML loader/dumper