Install yt-dlp on Windows
A quick guide to set up yt-dlp.exe on Windows 11/10, add it to PATH, verify, update, and enable FFmpeg for 4K/8K and MP3.
Step-by-step
- Download yt-dlp.exe from the official GitHub release: latest build.
- Move it to a folder like
C:\\Tools\\yt-dlporC:\\Users\\YOU\\Downloads. - (Optional) Add the folder to your PATH:
- GUI method: Start → search "Environment Variables" → Edit environment variables → under User variables open Path → New → paste your folder (e.g.,
C:\\Tools\\yt-dlp) → OK. - PowerShell (current user): setx PATH "%PATH%;C:\\Tools\\yt-dlp" (restart terminal afterwards).
- GUI method: Start → search "Environment Variables" → Edit environment variables → under User variables open Path → New → paste your folder (e.g.,
- Open PowerShell in the folder (Explorer → Address bar → type
powershell→ Enter) and run:yt-dlp --version - Keep it updated:
yt-dlp -U
FFmpeg (recommended)
FFmpeg enables merging separate video/audio streams (4K/8K) and audio conversions (e.g., MP3).
- Download ffmpeg.exe from official sources.
- Place ffmpeg.exe next to yt-dlp.exe in the same folder.
- Verify by downloading a video in high quality; yt-dlp should auto-detect FFmpeg and merge formats.
Full details: FFmpeg setup for Windows.
Post-install sanity checks
Run a quick test in PowerShell:
Check the version and update status:
Run from any folder
Once the folder is in PATH, you can run yt-dlp anywhere. Otherwise, run it from its folder or reference the full path:
Troubleshooting
- SmartScreen warning? Click More info → Run anyway. This is common for portable open-source tools.
- “Command not found” after PATH update? Close and reopen your terminal (PATH is loaded on session start).
- “Access is denied” or blocked? Right‑click yt-dlp.exe → Properties → check Unblock if present → OK.
- Merge errors at 4K/8K? Ensure ffmpeg.exe is in the same folder as yt-dlp.exe.
See also: Commands cheatsheet • Full troubleshooting
FAQ
Do I need admin rights to install?
No. yt-dlp.exe is portable. Admin is only needed if you add PATH for all users; for your user, use the GUI method or setx.
Will this work on Windows 7/8 or ARM?
yt-dlp primarily targets modern Windows versions. Some older systems may require Python-based setups. For ARM64, check the official release notes for compatibility.
How do I update to the latest version?
Run yt-dlp -U. This updates the executable in place.