v1.0.0 · Shell Script · macOS & Linux

yt-dlp
media-tools

A beginner-friendly terminal downloader for videos, audio, and playlists — powered by yt-dlp. No commands to memorize.

shell · bash macOS & Linux v1.0.0 Personal Use
Get Started View on GitHub
bash — yt-dlp-media-tools.sh
$ ./yt-dlp-media-tools.sh
Save folder [~/Desktop]: ~/Music URL: https://youtube.com/playlist?list=... Format: 3) MP3 Browser cookies: 1) Chrome ✔ 001 - Artist - Song Title.mp3 ✔ 002 - Artist - Song Title.mp3
$
// features

Everything you need.
Nothing you don't.

💬
Interactive step-by-step
No commands to memorize — just answer the prompts
🎛️
5 download formats
MP4 · WEBM · MP3 · M4A · FLAC
🌐
Browser cookies
Chrome · Firefox · Safari · Edge · Brave — or skip
🏷️
Auto naming
Files saved as index + artist + title automatically
⏭️
Archive tracking
Skips already-downloaded files on repeat runs
🔧
Auto installer
Detects OS, installs yt-dlp & ffmpeg — brew, apt, dnf, pacman, zypper
// formats

Pick your format.

Format
Type
Best for
Thumbnail
MP4
Video
Most video players — best quality
Embedded
WEBM
Video
Native YouTube quality, no re-encoding
Saved as JPG
MP3
Audio
Cars, phones, speakers — universal
Embedded
M4A
Audio
Good quality, smaller file size
Embedded
FLAC
Audio
Lossless conversion from source
No thumbnail

! FLAC is lossless, but cannot improve quality beyond the original source.

// installation

Up and running
in minutes.

01

Install Homebrew

$/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
02

Add Homebrew to Terminal

$echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
$eval "$(/opt/homebrew/bin/brew shellenv)"
03

Install Git

$brew install git
04

Clone and install

$git clone https://github.com/corado-bogos/yt-dlp-media-tools
$cd yt-dlp-media-tools
$chmod +x install.sh && ./install.sh
05

Start the tool

Every time you want to run the program, open the folder first, then start it:

$cd yt-dlp-media-tools
$./yt-dlp-media-tools.sh
// usage

Four steps.
Done.

01
Save folder
Default is ~/Desktop. Press Enter to use it, or paste any existing folder path.
~/Desktop (default)
~/Music
~/Downloads
02
Paste URL
Single video or full playlist. Must start with http:// or https://
https://youtube.com/watch?v=...
https://youtube.com/playlist?...
03
Choose format
Pick from 5 formats — video or audio.
1) MP4   2) WEBM
3) MP3   4) M4A   5) FLAC
04
Browser cookies
Optional — helps with restricted content, large playlists, rate limits.
0) Skip   1) Chrome
2) Firefox   3) Safari
4) Edge   5) Brave
~/Music — output structure
Music/
|-- 001 - Artist - Song Title.mp3
|-- 002 - Artist - Song Title.mp3
|-- 003 - Artist - Song Title.mp3
`-- archive.txt  ← tracks downloaded items, skips duplicates

! Type back at any prompt to return to the previous step. Type exit to close the program.

// support

Need help?

Bug reports & questions
Open an issue ->
Common fixes & troubleshooting
TROUBLESHOOTING.md ->
Private contact
corado.dev@icloud.com ->