How to update yt-dlp
You update yt-dlp by running yt-dlp -U in Terminal or PowerShell, or by reinstalling through your package manager (pip, Homebrew, winget). YouTube changes its player often; an outdated yt-dlp build throws errors like "Video unavailable," HTTP 403, or "Sign in to confirm you're not a bot." Updating fixes most of that. If you don't want to maintain a CLI tool, a browser YouTube to MP3 converter sidesteps the whole update cycle for one-off downloads.
When you need to update
Update if you see any of these:
ERROR: [youtube] ... HTTP Error 403: ForbiddenWARNING: [youtube] Unable to extract uploader idERROR: Unsupported URLon a link that worked last month- Version more than a few weeks old (
yt-dlp --version)
YouTube isn't static. Neither should your downloader be.
Method 1: Built-in self-update (fastest)
Works when yt-dlp was installed as a standalone binary or via pip with update support.
yt-dlp -U
On Windows PowerShell:
yt-dlp -U
Success prints the new version number. Run yt-dlp --version to confirm.
If -U fails: your install method might not support self-update—use Method 2 for your platform.
Method 2: Update by install method
| How you installed | Update command |
|---|---|
| pip (any OS) | pip install -U yt-dlp |
| pipx | pipx upgrade yt-dlp |
| Homebrew (Mac/Linux) | brew upgrade yt-dlp |
| winget (Windows) | winget upgrade yt-dlp |
| apt (Debian/Ubuntu) | sudo apt update && sudo apt upgrade yt-dlp |
| Manual .exe | Download latest from GitHub Releases and replace the old file |
After pip upgrade on Mac, I still run yt-dlp --version because macOS sometimes caches an old path in a different shell session.
Method 3: Update ffmpeg (often paired)
Audio extraction and merging need ffmpeg. If video downloads but MP3 step fails, update ffmpeg too:
- Mac:
brew upgrade ffmpeg - Windows: download new build from ffmpeg.org or
winget upgrade ffmpeg - Linux: distro package manager
Then retry:
yt-dlp -x --audio-format mp3 "YOUTUBE_URL"
Windows step-by-step
- Open PowerShell (not necessarily admin).
- Run
yt-dlp --version— note the date in the output. - Run
yt-dlp -U. If error, runwinget upgrade yt-dlporpip install -U yt-dlp. - Close and reopen PowerShell.
- Test:
yt-dlp -f ba -x --audio-format mp3 "https://www.youtube.com/watch?v=dQw4w9WgXcQ"(use any public test URL).
For first-time Windows setup, see how to use yt-dlp on Windows.
Mac step-by-step
- Open Terminal.
brew upgrade yt-dlpif you used Homebrew, elsepip3 install -U yt-dlp.yt-dlp --version- Test download to Desktop:
yt-dlp -o ~/Desktop/%(title)s.%(ext)s "URL"
Linux step-by-step
Distro packages lag behind. Power users often prefer pip:
python3 -m pip install -U yt-dlp
Or nightly for bleeding edge:
python3 -m pip install -U "yt-dlp[default]"
Check is yt-dlp safe if you're unsure about install sources—always GitHub or trusted package managers.
After updating: still broken?
| Problem | Fix |
|---|---|
| Age-restricted video | --cookies-from-browser chrome (logged-in browser) |
| Bot check loop | Update again; try different network; avoid VPN datacenter IPs |
| Live stream mid-broadcast | Wait for VOD after stream ends |
| Private video | yt-dlp can't bypass permissions |
For a single public MP3 when you're tired of debugging: paste the URL into YouTube to MP3. Videozify's servers handle extractor updates—you don't.
How often to update
I update when downloads fail, or monthly if I automate playlists. YouTube can break extractors overnight during big platform changes—there's no fixed schedule.
Conclusion
Run yt-dlp -U or upgrade through pip, brew, or winget whenever YouTube downloads start failing. Keep ffmpeg current for audio rips. Or skip the maintenance and convert one link in the browser.
No CLI needed: Free YouTube to MP3 — paste URL, download, done.