yt-dlp guides & how-tos
Everything you need to install, run and master yt-dlp — plus practical recipes for downloading video, audio, playlists and entire channels.
Install & setup
How to Download yt-dlp (Windows, macOS & Linux)
How to download yt-dlp on Windows, macOS and Linux — the official binary, pip, Homebrew, winget, scoop and more, with ffmpeg setup so downloads merge and convert correctly.
How to Install yt-dlp on Windows
Install yt-dlp on Windows 10 or 11 in minutes — using winget, Scoop, Chocolatey, or the standalone yt-dlp.exe — plus how to add it to PATH and install ffmpeg.
How to Update yt-dlp
How to update yt-dlp to the latest version — yt-dlp -U for the binary, pip upgrade, package managers, and nightly builds when a site breaks.
Usage
How to Run yt-dlp
How to run yt-dlp from the terminal: open a shell, run your first download, point it at the right folder, and the handful of options you'll actually use.
How to Use yt-dlp: A Practical Guide
Learn how to use yt-dlp: download videos, pick formats and quality, extract MP3 audio, grab playlists and channels, set output filenames, and use a config file.
How to Use yt-dlp on Windows
Use yt-dlp on Windows 10/11 from CMD or PowerShell: run your first download, fix quoting issues, set the Downloads folder, extract MP3, and avoid common Windows gotchas.
Downloading
How to Download as MP3 with yt-dlp
Download any video as an MP3 with yt-dlp: the exact command, how to set the bitrate/quality, embed cover art and tags, and the ffmpeg requirement explained.
How to Download Audio Only with yt-dlp
Download just the audio track with yt-dlp — keep the original best-quality stream with -f bestaudio, or convert to MP3/M4A/Opus/FLAC with -x.
Download the Best Quality with yt-dlp
Always get the highest quality with yt-dlp: how default selection works, forcing 4K/8K and HDR, choosing codecs with -S, and merging video+audio with ffmpeg.
How to Download a Whole Channel with yt-dlp
Download an entire channel with yt-dlp, organise videos into folders, skip ones you already have with a download archive, and grab only the latest uploads.
yt-dlp Download MP3: Quick Command
The quick yt-dlp command to download MP3 audio from any video, with a one-line config tweak to make MP3 your default and the ffmpeg requirement covered.
yt-dlp Download MP4: Force a Compatible Video File
Force yt-dlp to output a universally compatible MP4: merge into MP4, prefer H.264/AAC for maximum device support, or remux/recode existing downloads.
How to Download a Playlist with yt-dlp
Download an entire playlist with yt-dlp, select a range of items, number files by playlist position, skip already-downloaded videos, and grab playlist audio as MP3.
How to Download a Video with yt-dlp
The fundamentals of downloading a single video with yt-dlp: the basic command, choosing quality and format, naming the file, subtitles, and thumbnails.
Reference
Where Does yt-dlp Download To?
yt-dlp downloads to your current working directory by default. Here's how to find exactly where your files went and how to change the destination.
yt-dlp Commands: The Essential Cheat Sheet
A practical yt-dlp commands cheat sheet: list formats, choose quality, extract MP3, download playlists and channels, write subtitles, use cookies, and more.
yt-dlp Config File: Set Your Defaults
Stop retyping options. Learn where the yt-dlp config file lives on Windows, macOS and Linux, the exact syntax, and a sensible starter configuration.
yt-dlp Default Download Location
What the yt-dlp default download location is, the default filename template, and how to permanently change where files are saved using -P and a config file.
yt-dlp Documentation: Where to Find Everything
A guided map of the yt-dlp documentation: the official README, --help, output templates, format selection, the config file, and the fastest way to find an option.
Setting the yt-dlp Download Location
Control exactly where yt-dlp saves files: set a folder with -P, build filenames and subfolders with -o output templates, and make it permanent in your config.
yt-dlp Examples: Copy-Paste Recipes
A collection of practical yt-dlp examples you can copy and paste: video, MP3, MP4, playlists, channels, subtitles, cookies, archives, time ranges and more.
Looking for a specific site downloader?
These guides cover the yt-dlp tool. For a one-click downloader with a step-by-step page, pick a platform — or browse all 1,727+ supported sites.