yt-dlp·Beginner·Last tested: 2026-03·~5 min read
yt-dlp
yt-dlp is a feature-rich command-line audio/video downloader supporting thousands of sites. It's a fork of youtube-dl with enhanced features and active maintenance.
Key Features
- Download videos and audio from 1000+ sites including YouTube, Vimeo, TikTok
- Format selection and quality control
- SponsorBlock integration to skip sponsored segments
- Playlist and channel downloading
- Subtitle extraction and embedding
- Post-processing with FFmpeg integration
- Extensive output templating and metadata handling
- Plugin system for extensibility
Installation
Using pip:
pip install yt-dlp
Pre-built binaries:
- Windows: Download
yt-dlp.exefrom releases - Linux/BSD: Download
yt-dlpbinary - macOS: Download
yt-dlp_macos
Info
The platform-independent zipimport binary requires Python but works across all systems.
Basic Usage
Download a video:
yt-dlp "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Extract audio only:
yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Download best quality under 720p:
yt-dlp -f "best[height<=720]" "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Download entire playlist:
yt-dlp "https://www.youtube.com/playlist?list=PLxxxxxx"
Notable Details
- License: Unlicense (public domain)
- Language: Python
- Community: 152k+ GitHub stars, active Discord server
- Maintenance: Actively developed with frequent releases
- Dependencies: Optional FFmpeg for post-processing
Tip
Use yt-dlp --update to keep the tool current with site changes and new features.