yt-dlp
yt-dlp is a powerful command-line tool for downloading audio and video from thousands of websites.
What is yt-dlp?
yt-dlp is a feature-rich command-line audio/video downloader that supports thousands of websites. It is a fork of youtube-dl and youtube-dlc, designed to download videos and audio from online platforms. The tool solves the problem of accessing and saving multimedia content from a wide array of streaming sites via a flexible command-line interface.
Users and developers who need to programmatically download videos or audio from supported websites, including system administrators, content archivists, and automation script writers. It is particularly suited for those comfortable with command-line tools and requiring batch processing or integration into workflows.
Developers choose yt-dlp for its extensive site support, active maintenance, and frequent updates that keep pace with website changes. Its unique selling points include advanced features like format selection, post-processing with ffmpeg, sponsor block support, and plugin extensibility, offering more reliability and functionality than many alternatives.
Overview
A feature-rich command-line audio/video downloader
Use Cases
Best For
- Downloading videos or audio from YouTube and thousands of other supported sites via command line.
- Batch downloading playlists or channels with options for concurrent fragments and retries.
- Extracting specific video formats or qualities and merging separate audio/video streams using ffmpeg.
- Automating downloads with configuration files, output templates, and scripting integration.
- Archiving videos with metadata, thumbnails, and subtitles for offline access.
- Bypassing geographic restrictions or downloading age-restricted content with authentication options.
Not Ideal For
- End-users seeking a point-and-click graphical interface without terminal commands
- Embedded systems or restricted environments that cannot install external binaries like ffmpeg or JavaScript runtimes
- Projects requiring official API compliance or legal certainty, as yt-dlp often works around site restrictions
- Real-time streaming applications, since it is designed for downloading, not live playback
Pros & Cons
Pros
Supports thousands of sites, with an actively updated list in supportedsites.md, making it versatile for downloading from obscure platforms beyond YouTube.
Offers multiple release channels (stable, nightly, master) with daily builds to quickly adapt to site changes, reducing breakage compared to abandoned forks.
Seamlessly integrates with ffmpeg for merging audio/video, converting formats, and adding metadata, with custom builds available to fix known bugs.
Provides powerful output templates, configuration files, and a plugin system, allowing deep automation and integration into scripts or other software.
Cons
Requires external tools like ffmpeg, a JavaScript runtime (e.g., deno), and yt-dlp-ejs for full functionality, adding complexity and potential installation hurdles on locked-down systems.
With over 100 options and dense documentation, new users face a steep learning curve, and misconfiguration can lead to errors or unintended behavior.
Often used to bypass DRM or terms of service, raising potential legal risks, and the README warns of licensing complexities in bundled binaries.
Nightly and master channels may introduce breaking changes, and the tool's reliance on reverse-engineering sites means frequent updates are needed but can disrupt workflows.
Open Source Alternative To
yt-dlp is an open-source alternative to the following products:
JDownloader is a free, open-source download manager written in Java that enables users to automatically download files from file-hosting sites like Rapidshare and Mega.
A desktop application for downloading high-quality videos from YouTube, Vimeo, and other platforms in up to 4K resolution.
Video DownloadHelper is a browser extension that allows users to download videos and media content from websites while browsing.
Frequently Asked Questions
Related Projects
youtube-dlCommand-line program to download videos from YouTube.com and other video sites
fuckMagnificent app which corrects your previous console command.
HTTPie🥧 HTTPie CLI — modern, user-friendly command-line HTTP client for the API era. JSON support, colors, sessions, downloads, plugins & more.
httpie🥧 HTTPie CLI — modern, user-friendly command-line HTTP client for the API era. JSON support, colors, sessions, downloads, plugins & more.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.