he2a / av-dl

A simple yt-dlp script to download audio or video off youtube, soundcloud or other sources.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

av-dl - An Audio/Video Downloader Script

Small script to download audio or video off youtube, soundcloud and other sites supported by yt-dlp. Made for use in WSL environment in windows, but should work in any linux distro (including termux in android) without any problem.

Features

This script has two basic behaviours for different content.

  • For video, downloads the best possible quality available and embeds subtitle if possible.
  • For audio, selectively downloads the best possible audio stream, crops the thumbnail to 1:1 ratio while trimming any black bars, then embeds it in V0 MP3 output.

Requirement

  • yt-dlp for downloading video/audio.
  • python 3.6+ for running yt-dlp.
  • ffmpeg for media conversion.

Installation

Make sure you have yt-dlp and ffmpeg already installed and updated. Clone this repo using git clone https://github.com/he2a/av-dl av-dl. Inside you will find av-dl.sh file. Run chmod +x av-dl.sh inside the directory to make it executable. Now, open the script using your text editor and change the download path to your choice and you are ready to use it.

Settings

# Set output path for music.
music=~/storage/music

# Set output path for video.
video=~/storage/movies

# Number of retry attempts.
attempt=3

# Force default choice of download. Set 'audio' for audio / 'video' for video / blank for manual choice.
defchoice=

# Set true to embed cover for audio download.
embedcover=true

# Set true to use thumbnail as cover for audio download or false to use default cover.
coverthumb=true

# Link to the cover image for use as default cover, including https:// part.
thumblink=

# Set true to autotrim cover to square for audio download.
autotrimthumb=true

# Set true to embed subtitles for video download.
embedsubs=true

# Set true to embed auto translated subtitles for youtube videos.
autosubs=false

# Set false to show a text instead of logo.
showlogo=true

# Set true to enable verbose mode mainly for debugging the script.
verbose=false

About

A simple yt-dlp script to download audio or video off youtube, soundcloud or other sources.

License:GNU General Public License v3.0


Languages

Language:Shell 100.0%