A feature-rich command-line audio/video downloader

★ 208,059⑂ 18,354👁 979⑃ 5,035● 12,293▤ 138
PythonUnlicenseCreated 2020-10-26discord.gg/H5MNcFW63r
Download: yt-dlp 2026.10.26yt-dlp-2026.10.26 ↓2026.10.262026-10-26
+268
Daily
+1,716
Weekly
208,059
stars
18,354
forks
979
watchers
5,035
prs
12,293
issues
138
releases

README

yt-dlp is a feature-rich command-line audio/video downloader with support for thousands of sites. The project is a fork of youtube-dl based on the now inactive youtube-dlc.




 INSTALLATION
     Detailed instructions
     Release Files
     Update
     Dependencies
     Compile
 USAGE AND OPTIONS
     General Options
     Network Options
     Geo-restriction
     Video Selection
     Download Options
     Filesystem Options
     Thumbnail Options
     Internet Shortcut Options
     Verbosity and Simulation Options
     Workarounds
     Video Format Options
     Subtitle Options
     Authentication Options
     Post-processing Options
     SponsorBlock Options
     Extractor Options
     Preset Aliases
 CONFIGURATION
     Configuration file encoding
     Authentication with netrc
     Notes about environment variables
 OUTPUT TEMPLATE
     Output template examples
 FORMAT SELECTION
     Filtering Formats
     Sorting Formats
     Format Selection examples
 MODIFYING METADATA
     Modifying metadata examples
 EXTRACTOR ARGUMENTS
 PLUGINS
     Installing Plugins
     Developing Plugins
 EMBEDDING YT-DLP
     Embedding examples
 CHANGES FROM YOUTUBE-DL
     New features
     Differences in default behavior
     Deprecated options
 CONTRIBUTING
     Opening an Issue
     Developer Instructions
 WIKI
     FAQ



 INSTALLATION











You can install yt-dlp using the binaries, pip or one using a third-party package manager. See the wiki for detailed instructions



 RELEASE FILES

 Recommended

File|Description
:---|:---
yt-dlp|Platform-independent zipimport binary. Needs Python (recommended for Linux/BSD)
yt-dlp.exe|Windows (Win10+) standalone x64 binary (recommended for Windows)
yt-dlp_macos|Universal MacOS (10.15+) standalone executable (recommended for MacOS)

 Alternatives

File|Description
:---|:---
yt-dlp_linux|Linux (glibc 2.17+) standalone x86_64 binary
yt-dlp_linux.zip|Unpackaged Linux (glibc 2.17+) x86_64 executable (no auto-update)
yt-dlp_linux_aarch64|Linux (glibc 2.17+) standalone aarch64 binary
yt-dlp_linux_aarch64.zip|Unpackaged Linux (glibc 2.17+) aarch64 executable (no auto-update)
yt-dlp_linux_armv7l.zip|Unpackaged Linux (glibc 2.31+) armv7l executable (no auto-update)
yt-dlp_musllinux|Linux (musl 1.2+) standalone x86_64 binary
yt-dlp_musllinux.zip|Unpackaged Linux (musl 1.2+) x86_64 executable (no auto-update)
yt-dlp_musllinux_aarch64|Linux (musl 1.2+) standalone aarch64 binary
yt-dlp_musllinux_aarch64.zip|Unpackaged Linux (musl 1.2+) aarch64 executable (no auto-update)
yt-dlp_x86.exe|Windows (Win10+) standalone x86 (32-bit) binary
yt-dlp_win_x86.zip|Unpackaged Windows (Win10+) x86 (32-bit) executable (no auto-update)
yt-dlp_arm64.exe|Windows (Win10+) standalone ARM64 binary
yt-dlp_win_arm64.zip|Unpackaged Windows (Win10+) ARM64 executable (no auto-update)
yt-dlp_win.zip|Unpackaged Windows (Win10+) x64 executable (no auto-update)
yt-dlp_macos.zip|Unpackaged MacOS (10.15+) executable (no auto-update)

 Misc

File|Description
:---|

Top issues

Latest release

yt-dlp 2026.10.26 2026.10.26 2026-10-26
A description of the various files is in the README

The zipimport Unix executable and release tarball contain code licensed under ISC and MIT. The PyInstaller-bundled executables are subject to these and other licenses, all of which are compiled in THIRD_PARTY_LICENSES.txt

---

 Important changes
- The minimum required Python version has been raised to 3.11
    - Python 3.10 has reached its end-of-life as of October 2026, and yt-dlp has now removed support for it. Read more
- The official Windows release binaries now require Windows 10 or later. Read more
- Security: The recent brotli and ce

News & coverage (21)

Hacker NewsYt-dlp: Upcoming new requirements for YouTube downloads▲ 1,244 · 611 comments · 2025-09-24Hacker NewsYt-dlp: External JavaScript runtime now required for full YouTube support▲ 1,106 · 627 comments · 2025-11-12Hacker NewsYt-dlp – A YouTube-dl fork with additional features and fixes▲ 822 · 332 comments · 2021-08-26Hacker NewsBun support is now limited and deprecated▲ 594 · 608 comments · 2026-05-22Hacker NewsYouTube DRM added on ALL videos with TV (TVHTML5) clients▲ 410 · 239 comments · 2025-03-10Hacker NewsYouTube-dl fork with additional features and fixes▲ 187 · 113 comments · 2023-09-11Hacker NewsYouTube is returning 403 to NewPipe and other 3rd party players▲ 30 · 13 comments · 2024-07-09torrentfreakIFPI Wants Open Source YouTube Downloader yt-dlp on EU Piracy Watch List2026-09-29MUO on MSNYt-dlp is powerful, but this upgrade makes it a joy to use2026-07-19GIGAZINE'YT-DLP Web Player' replaces videos on web pages with ads via yt-dlp for free.2026-07-12
11 morenoteyt-dlp Environment Setup Guide: A Complete Walkthrough for Installation on Windows 112026-03-26noteFree Distribution and Usage Guide for yt-dlp BAT Files | Build an Automated Download Environment in 5 Minutes Even for Beginners [Windows 10, 11]2026-03-26GIGAZINEFinally, to fully utilize the YouTube download function of yt-dlp, a JavaScript runtime such as Deno is required, and the installation procedure is like this2025-11-11GIGAZINEProcedure to clip and download the specified time of the movie with the strongest YouTube downloader 'yt-dlp'2022-06-21GIGAZINESummary of how to use 'yt-dlp' that can download movies such as YouTube and Nico Nico video with the highest image quality and high sound quality, age-restricted movies can ...2022-01-01It's FOSSYT-DLP is Being Treated as a Piracy Tool By The IFPI2026-10-01mediasat.infoMusic industry asks EU to add YouTube downloader yt-dlp to its piracy watch list2026-10-01GIGAZINEA summary of the installation procedure for the video downloader 'yt-dlp': it can be installed quickly using the winget command.2026-07-07GIGAZINEThe video downloader 'yt-dlp' has deprecated Bun, due to concerns about the risks associated with Bun's over-reliance on AI coding.2026-05-25Plisioyt-dlp Guide 2026 : Install, Commands, Legal Status2026-05-08MakeUseOfHow to Download YouTube Videos on Linux Using yt-dlp2022-10-27

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON