Skip to content
This repository was archived by the owner on Oct 24, 2025. It is now read-only.
/ ytdl Public archive

A feature-rich command-line Video/Audio Downloader for macOS, based on yt-dlp, built with bash.

License

Notifications You must be signed in to change notification settings

arghya339/ytdl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 

Repository files navigation

yt >_dl

A feature-rich command-line Video/Audio Downloader for macOS, 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 /HQ Video in MKV for Smaller file Sized
  • Preferred Video Codec VP09 for HQ video and AV01 Codec for FULL HD/ HD /SD video
  • Support up to highest quality such as 8K
  • Download images as PNG/JPG/SVG/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 (40 KB), allowing you to save space on your macOS

Prerequisites

  • macOS computer with working internet connection.

Usage

  • Open macOS Terminal and run the script with the following command:
curl -o "$HOME/.ytdl.sh" "https://raw.githubusercontent.com/arghya339/ytdl/refs/heads/main/ytdl.sh" && bash "$HOME/.ytdl.sh"

Run ytdl with these commands in Terminal:

ytdl

Tip

Please uncheck Resotre text when reopening windows option in 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, based on yt-dlp, built with bash.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages