How to Download High-Quality Videos with yt-dlp from YouTube and Web Streams
Learn how to download high-quality videos from YouTube and supported web streams using yt-dlp. This practical guide covers installation, best video formats, subtitles, playlists, audio extraction, troubleshooting, and safe download tips.
Want clean, high-quality video files without relying on unreliable browser downloaders? yt-dlp is one of the most powerful command-line tools for saving videos, audio, subtitles, and playlists from YouTube and many other supported websites. It gives you control over resolution, codecs, filenames, subtitles, and download locations.
This guide goes beyond the usual copy-and-paste tutorial. It covers the best format commands, FFmpeg setup, playlist control, common errors, and practical fixes for audio-video merging. Only download content you own, have permission to save, or that the website and creator make available for offline use. yt-dlp does not and should not be used to bypass DRM, paywalls, private content, or access restrictions.
What Is yt-dlp?
yt-dlp is a maintained command-line video downloader based on youtube-dl. It supports YouTube and a wide range of other video platforms, including many sites that use separate video and audio streams. The tool can download the highest available quality and use FFmpeg to combine the streams into a normal MP4 or MKV file.
For the safest download, use the official yt-dlp GitHub repository. Avoid random repackaged executables from unknown websites.
Install yt-dlp and FFmpeg
Windows installation
- Download the Windows executable from the official yt-dlp releases page.
- Rename it to
yt-dlp.exeand place it in a simple folder such asC:\Tools\yt-dlp. - Install FFmpeg and place
ffmpeg.exein the same folder, or add FFmpeg to your Windows PATH. - Open PowerShell in that folder and run
.yt-dlp.exe --version.
macOS and Linux installation
On macOS, Homebrew users can run brew install yt-dlp ffmpeg. On Debian-based Linux systems, install FFmpeg with sudo apt install ffmpeg, then download the yt-dlp binary from its official release page. Confirm everything works with:
yt-dlp --version
ffmpeg -versionFFmpeg handles merging and conversion. You can review the official FFmpeg documentation if you need advanced codec or container options.
Download the Best Quality Video
Copy the video address, open Command Prompt, PowerShell, Terminal, or your preferred shell, and run:
yt-dlp -f "bv*+ba/b" --merge-output-format mp4 "VIDEO_URL"The bv*+ba/b selector requests the best video and best audio streams, then falls back to a combined format if separate streams are unavailable. The --merge-output-format mp4 option creates an MP4 when the selected streams can be merged without incompatible codecs.
Before downloading, inspect available formats with:
yt-dlp -F "VIDEO_URL"This displays resolution, frame rate, codecs, audio quality, and format IDs. To choose a specific format, use a command such as:
yt-dlp -f 137+140 "VIDEO_URL"Format IDs differ between videos, so always check the list first. For most users, the automatic best-quality command is easier and more reliable.
Control File Names and Download Folders
A tidy filename makes large collections much easier to manage. This command saves videos inside a folder named after the channel and includes the upload date:
yt-dlp -o "%(uploader)s/%(upload_date)s - %(title)s.%(ext)s" "VIDEO_URL"To save everything to a fixed Windows folder, use:
yt-dlp -P "C:\Videos" "VIDEO_URL"On macOS or Linux, use a path such as -P "~/Videos". Add --no-overwrites to prevent yt-dlp from replacing files you already downloaded.
Download Playlists, Subtitles, or Audio
Download an entire permitted playlist in the best available quality with:
yt-dlp -f "bv*+ba/b" --merge-output-format mp4 "PLAYLIST_URL"To download only selected entries, use --playlist-items 1-5. For subtitles, try:
yt-dlp --write-subs --sub-langs "en" --sub-format srt "VIDEO_URL"Automatic captions may be available with --write-auto-subs. For audio extraction, FFmpeg is required:
yt-dlp -x --audio-format mp3 --audio-quality 0 "VIDEO_URL"Use audio extraction only where you have permission, especially when dealing with copyrighted music or paid content.
Common yt-dlp Problems and Quick Fixes
- “Requested format is not available”: Run
yt-dlp -Fand choose an available format, or return to-f "bv*+ba/b". - Audio is missing: Install FFmpeg and confirm that
ffmpeg -versionworks from the same terminal. - Video downloads slowly: Try
--concurrent-fragments 5, but reduce the number if your connection becomes unstable. - “Sign in” or age restriction: Use cookies only for accounts and content you are authorized to access. Never share exported cookie files.
- Extractor error: Update yt-dlp with
yt-dlp -U, then retry. Websites change frequently, so updates matter.
Some web streams use DRM or require a paid subscription. yt-dlp cannot legally turn protected streams into downloadable files, and this guide does not cover DRM bypassing.
Frequently Asked Questions
Is yt-dlp safe to use?
The official yt-dlp project is widely used and open source. Download it from the official repository, keep it updated, and scan unfamiliar files before opening them. Tested & 100% Working commands should still be used responsibly.
Why do I need FFmpeg?
Many platforms provide video and audio as separate streams. FFmpeg merges them and can also convert media into MP4, MKV, MP3, or other formats.
Can yt-dlp download every web stream?
No. Support varies by website, and DRM-protected, private, or restricted streams may not be downloadable. Use yt-dlp only with content you are allowed to save.
Final Verdict
yt-dlp is a fast, flexible way to download high-quality videos from YouTube and supported web streams. Install FFmpeg, check formats before forcing a format ID, use clear output templates, and update the tool when websites change. Follow our simple step-by-step guide, respect creator rights, and you will have a dependable Extract and Play workflow with no crash issues.
Comments (0)
No comments yet. Be the first to start the discussion!