Skip to content
This repository was archived by the owner on Aug 26, 2026. It is now read-only.
arghya339Public archive

About

A feature-rich command-line Video/Audio Downloader for macOS/Android/Fedora, based on yt-dlp, written in bash.

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

yt >_dl

A feature-rich command-line Video/Audio Downloader for macOS/Android/Fedora, based on yt-dlp.


Purpose

  • This script automates the process of downloading video/audio using yt-dlp.

Feature

  • based on yt-dlp that support downloading video/audio from 1,500+ of website
  • written in bash shell script
  • Aria2 as downloader for high quality video instedad of default (curl)
  • SponsorBlock Filtering for audio source
  • Embed Metadata to audio file
  • Thumbnail as covert art
  • Crop Thumbnail into square for YT audio downloads
  • Playlist Name as Album Metadata if data is not present
  • Custom Audio/Video Quality
  • MP3 as Audio Format
  • Save Subtitles into .vtt or .srt file
  • Mark YT sponsorblock segments as chapters for video
  • Download SD Video Format in MP4 and HD /FULL HD /FHD /HQ /UHD Video in MKV for Smaller file Sized
  • Preferred Video Codec VP09 for UHD/ HQ video and AV01 Codec for FULL HD/ HD /SD video
  • Support up to highest quality such as 8K
  • Download images as PNG/JPG/WEBP/GIF from various websites (cloudflare unprotect site only), tested on YT and YT Music.
  • Built in Updating feature
  • User Friendly and FOSS
  • Smaller size script (lessthen 40 KB), allowing you to save space on your device

Prerequisites

  • macOS / Android / Fedora device with working internet connection.

Usage

Android macOS Fedora

Open macOS/Fedora Terminal or Termux and run the script with the following command:

curl -L --progress-bar -o "$HOME/.ytdl.sh" "https://raw.githubusercontent.com/arghya339/ytdl/refs/heads/main/bash/ytdl.sh" && bash ~/.ytdl.sh

Run ytdl with these commands in Terminal:

ytdl

Tip

Please uncheck Resotre text when reopening windows option in macOS Terminal > Settings > Profiles > Window

Note

This script was tested on an Intel Mac running macOS Sonoma (14) with Terminal v2.14(453) with bash v3.2.57.

Alternative

Android

Seal

ytdlnis

macOS

MacYTDL formatSlectionNotAvailable

yt-dlp-gui qualitySelectionNotAvailable

youtube-dl-gui notWorkOnMac

ezytdl notWorkOnMac

Windows

yt-dlp-gui

Linux

yt-dlp-gui

Dependencies

"bash" [GNU 3.0], "brew" [BSD 2.0], "Python" [PSF / GPL], "yt-dlp" [GNU 3.0], "ffmpeg" [GPL 2.0], "imagemagick" [Apache 2.0], "Aria2" [GPL 2.0], "jq" [MIT]

"VLC" [GPL 2.0], "Aural Player" [MIT]

"FreeTube" [GNU 3.0], "YT Music" [MIT]

How it works (Demo on YouTube)

image

Devoloper info

About

A feature-rich command-line Video/Audio Downloader for macOS/Android/Fedora, based on yt-dlp, written in bash.

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages