Add any social profile / channel / page
Paste any YouTube channel, Instagram profile, Facebook page, LinkedIn page, or direct video URL. yt-dlp handles all of these natively.
Profile queue 0 ✓ SAVED
🔗
No profiles added yet.
Generated command
Command Prompt
Add profiles above to generate commands.
Download mode
Download all: fetches every video from the profile/channel. Use date filters or playlist flags below to limit scope.
Format & quality
Format / quality
Date limit (optional)
Output folder
Filename template
Custom template (editable)
Extra flags
Saved presets 0
🕓
No history yet — generate commands in the Output tab and they'll appear here.
History is stored in your browser's local storage. Clear all history
Scan a page for media
Paste any page URL to extract video, audio, and media links. Known platforms (YouTube, TikTok, Instagram, etc.) are detected instantly — other pages are fetched via a CORS proxy.
Operating System
1
Install Python 3.10+
Download from python.org/downloads. During install, tick "Add Python to PATH" — this is required. Verify in CMD:
python --version
2
Install yt-dlp
Open Command Prompt (Win+R → cmd) and run:
python -m pip install yt-dlp
To update later:
python -m pip install -U yt-dlp
3
Install FFmpeg (required for merging video+audio)
Download from ffmpeg.org (Windows build by BtbN or gyan.dev). Extract the zip, copy the bin folder path, and add it to your System PATH (Search → "Environment Variables" → Path → New). Verify:
ffmpeg -version
4
Optional: install browser cookies support
Required for LinkedIn, private Instagram, and age-restricted content.
python -m pip install yt-dlp[default]
5
Test it
python -m yt_dlp --version
You're ready! Go to the Profiles tab, add a URL, and generate your first command.
1
Install Homebrew
Homebrew is the package manager for macOS. Open Terminal (Spotlight → Terminal) and run:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Follow the prompts — it will ask for your macOS password. When done, verify:
brew --version
⚠️ On Apple Silicon (M1/M2/M3), Homebrew installs to /opt/homebrew/ instead of /usr/local/. The installer will print a command to add to your shell profile (~/.zprofile) — run it, then restart Terminal, or commands won't be found.
2
Install Python 3
macOS ships with an old system Python — install a current version via Homebrew:
brew install python
Verify. On macOS, Homebrew registers it as python3:
python3 --version
Also confirm pip is available:
pip3 --version
You should see Python 3.12.x and pip 24.x. If either says "not found", restart Terminal — Homebrew needs a fresh shell session to update PATH.
3
Install FFmpeg
Required for merging separate video and audio streams (needed for 1080p+ on YouTube):
brew install ffmpeg
Verify:
ffmpeg -version
4
Install yt-dlp
Via Homebrew (recommended — stays updated with brew upgrade):
brew install yt-dlp
Or via pip3:
python -m pip install yt-dlp
Verify:
python -m yt_dlp --version
5
Optional: cookie support (LinkedIn, private content)
python -m pip install yt-dlp[default]
6
Update everything later
brew upgrade python ffmpeg yt-dlp
You're ready! Go to Profiles → add a URL → generate your command.
1
Install Python 3, pip & FFmpeg
Open a terminal and run:
sudo apt update && sudo apt install python3 python3-pip ffmpeg -y
Verify Python and pip:
python3 --version && pip3 --version
On non-Debian distros (Fedora, Arch, etc.) replace apt with dnf or pacman -S.
2
Install yt-dlp
python -m pip install yt-dlp
Or the standalone binary (always latest):
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp
3
Verify
python -m yt_dlp --version && ffmpeg -version
You're ready! Go to Profiles → add a URL → generate your command.
yt-dlp runs natively on Android via Termux — a full Linux terminal emulator. Install it once, then use KZ Downloader to generate commands, copy them, and paste into Termux.
1
Install Termux from F-Droid
Download from f-droid.org/packages/com.termux — the Google Play version is outdated and unsupported. Install the APK, open Termux, and update packages:
pkg update && pkg upgrade -y
2
Install Python, pip & FFmpeg
pkg install python ffmpeg -y
Verify:
python --version && ffmpeg -version
3
Install yt-dlp
python -m pip install yt-dlp
Verify:
python -m yt_dlp --version
4
Grant storage access (save to Downloads)
Run this once — it shows an Android permission prompt to allow Termux access to your phone's storage:
termux-setup-storage
Then set your output folder in Options to:
/sdcard/Download/KZ Downloads
5
Run commands from KZ Downloader
Add your URLs in Profiles → Output tab → tap 📋 Copy or 📤 Share → switch to Termux → paste → Enter.
You're ready! Downloads land in your phone's Downloads folder.
6
Update yt-dlp later
python -m pip install -U yt-dlp
⚠️ yt-dlp cannot run natively on iOS — Apple's sandbox prevents executing arbitrary binaries. However, there are two practical workflows:
A
SSH into a Mac or Linux machine
If you have a Mac, Linux server, or Raspberry Pi with yt-dlp installed, you can SSH into it from your iPhone and run commands there. Good SSH clients for iOS:
Generate your command in KZ Downloader → Copy → paste in your SSH client terminal.
B
Use a-Shell (limited, experimental)
a-Shell is a terminal emulator for iOS that includes Python. yt-dlp can be installed but FFmpeg is unavailable, so only audio-only or pre-merged formats work. Not recommended for video.
python -m pip install yt-dlp
Without FFmpeg, 1080p/720p video+audio merging will fail. Use format best[ext=mp4] in Options instead.
C
Self-hosted remote server
Run yt-dlp on a VPS, NAS, or home server and trigger downloads remotely via SSH or a web UI like YoutubeDL-Material. KZ Downloader generates the commands; you paste them via SSH from iOS.
Tip: set your output folder in Options to the server's download path, not a local iOS path.
Useful yt-dlp references
▶ yt-dlp GitHub (docs & releases) ▶ Format selection reference ▶ Output template variables ▶ Cookies & authentication docs