Releases: nicolaasjan/yt-dlp
Releases · nicolaasjan/yt-dlp
Release list
2026.07.14.042219
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
Changelog
Extractor changes
- americastestkitchen: Fix season/series extraction (#17151) by bm1549
- ard: Remove dead extractor (#17158) by InvalidUsernameException
- showroom: Rework extractors (#17142) by doe1080
- youtube
Misc. changes
2026.07.05.042926
A description of the various files is in the README
The zipimport Unix executable contains 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 recommended Python version has been raised to 3.11
- Since Python 3.10 will reach its end-of-life in October 2026, support for it will be dropped soon. Read more - The official Windows release binaries will soon require Windows 10 or later. Read more
- Security: [CVE-2026-55404] Downstream command injection via improper sanitization of --write-link output
- Shortcut file data is now properly validated and sanitized when the--write-linkoptions are used
Changelog
Core changes
- Always include warnings in debug output (#17059) by bashonly
- Fix
allow-unsafe-extcompat option (#16920) by bashonly - Raise minimum recommended Python version to 3.11 (#17034) by bashonly
- Validate and escape values in
--write-linkoutput by bashonly - cookies: Use
'instead of"for SQL string quoting (#17078) by Grub4K - utils
- Deprecate
make_dirin favor ofmake_parent_dirs(#16931) by doe1080 HTTPHeaderDict: Fix__ior__(#16930) by doe1080parse_duration: Returnintwhen appropriate (#13899) by doe1080parse_resolution: Support fps suffixes (#17073) by doe1080pkcs1pad: Fix invalid PKCS#1 v1.5 padding bytes (#17035) by doe1080qualities: Avoid repeated index lookups (#17025) by doe1080random_user_agent: Bump version range 143-149 => 144-150 (#17117) by bashonly, dlp-bot
- Deprecate
Extractor changes
- Always include
idin request error output (#17068) by bashonly, HybridDog - Fix request logging (#17072) by bashonly
- arte: Fix playlist support (#13191) by 1100101
- bandcamp: weekly: Fix extractor (#16925) by bashonly (With fixes in 9055188)
- bilibili: Fix API extraction (#13730) by grqz
- instagram
- Detect when cookies are invalidated (#17126) by bashonly
- Rework extractor (#17075) by bashonly (With fixes in 8b8e3e3)
- linkedin: Remove broken login support (#17039) by 0xvd
- mgtv: Fix VIP stream extraction (#16982) by longcharmroeun
- mxplayer
- Fix extractors (#16988) by 0xvd
- Rework extractors (#17018) by doe1080
- niconico
- Fix error detection (#16991) by doe1080
- Support shorts (#16992) by doe1080
- omnyfm: Add extractors (#15942) by doe1080
- openrec: Rework extractors (#16857) by doe1080 (With fixes in 6694ef8)
- patreon: Support new URL format (#16926) by 0xvd
- peertube: Support password-protected videos (#16873) by selfhoster1312
- periscope: Improve metadata extraction (#16084) by doe1080
- reddit: Remove broken login support (#17038) by 0xvd
- soundcloud
- Extract
uploader_urlfor playlists (#16842) by noseb13eds - Extract comments (#16938) by 0xvd
- [Improve metadata extraction](yt-dlp@8bdfbfd4461a6...
- Extract
2026.07.01.042337
A description of the various files is in the README
The zipimport Unix executable contains 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
Changelog
Core changes
- Always include warnings in debug output (#17059) by bashonly
- Fix
allow-unsafe-extcompat option (#16920) by bashonly - Raise minimum recommended Python version to 3.11 (#17034) by bashonly
- cookies: Use
'instead of"for SQL string quoting (#17078) by Grub4K - utils
- Deprecate
make_dirin favor ofmake_parent_dirs(#16931) by doe1080 HTTPHeaderDict: Fix__ior__(#16930) by doe1080parse_duration: Returnintwhen appropriate (#13899) by doe1080parse_resolution: Support fps suffixes (#17073) by doe1080pkcs1pad: Fix invalid PKCS#1 v1.5 padding bytes (#17035) by doe1080qualities: Avoid repeated index lookups (#17025) by doe1080
- Deprecate
Extractor changes
- Always include
idin request error output (#17068) by bashonly, HybridDog - Fix request logging (#17072) by bashonly
- bandcamp: weekly: Fix extractor (#16925) by bashonly (With fixes in 9055188)
- instagram: Rework extractor (#17075) by bashonly
- linkedin: Remove broken login support (#17039) by 0xvd
- mgtv: Fix VIP stream extraction (#16982) by longcharmroeun
- mxplayer
- Fix extractors (#16988) by 0xvd
- Rework extractors (#17018) by doe1080
- niconico
- Fix error detection (#16991) by doe1080
- Support shorts (#16992) by doe1080
- patreon: Support new URL format (#16926) by 0xvd
- peertube: Support password-protected videos (#16873) by selfhoster1312
- periscope: Improve metadata extraction (#16084) by doe1080
- reddit: Remove broken login support (#17038) by 0xvd
- soundcloud
- svt: Fix extractor (#16288) by billauer, dirkf
- telewebion: Fix extractor (#16986) by BOplaid
- truth: Support share URLs (#16096) by InvalidUsernameException
- tviplayer: Fix extractor (#16527) by FranciscoPombal
- unsupported: Update unsupported sites (#17085) by bashonly
- youtube
- Fix
extract_relative_timefor abbreviated units (#16687) by dialmaster - Fix detection of forced preroll wait time (#17062) by bashonly
- Fix minor issues (#17060) by doe1080
- tab
- Fix flat extraction of collaborators (#17045) by bashonly
- Fix flat playlist metadata extraction (#16965) by bashonly
- Fix metadata extraction (#16976) by bashonly
- [Fix pagination](https://github.com/yt-dlp/y...
- Fix
2026.06.22.040728
A description of the various files is in the README
The zipimport Unix executable contains 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
Changelog
Core changes
- Fix
allow-unsafe-extcompat option (#16920) by bashonly - utils
- Deprecate
make_dirin favor ofmake_parent_dirs(#16931) by doe1080 HTTPHeaderDict: Fix__ior__(#16930) by doe1080
- Deprecate
Extractor changes
- bandcamp: weekly: Fix extractor (#16925) by bashonly (With fixes in 9055188)
- mxplayer: Fix extractors (#16988) by 0xvd
- niconico
- Fix error detection (#16991) by doe1080
- Support shorts (#16992) by doe1080
- patreon: Support new URL format (#16926) by 0xvd
- peertube: Support password-protected videos (#16873) by selfhoster1312
- periscope: Improve metadata extraction (#16084) by doe1080
- telewebion: Fix extractor (#16986) by BOplaid
- tviplayer: Fix extractor (#16527) by FranciscoPombal
- youtube
- zdf: Detect livestreams (#16954) by InvalidUsernameException
Downloader changes
- external:
curl: Support development versions (#16922) by syphyr - mhtml: Fix storyboard content-length calculation (#13998) by Masterjun3
Misc. changes
- build: Update 17 dependencies (#17014) by dlp-bot
- ci: Bump actions/checkout v6.0.3 => v7.0.0 (#17015) by dlp-bot
- cleanup: Fix invalid info dict fields (#17007) by seproDev
2026.06.14.040255
A description of the various files is in the README
The zipimport Unix executable contains 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
Changelog
Core changes
- Fix
allow-unsafe-extcompat option (#16920) by bashonly - utils
- Deprecate
make_dirin favor ofmake_parent_dirs(#16931) by doe1080 HTTPHeaderDict: Fix__ior__(#16930) by doe1080
- Deprecate
Extractor changes
- bandcamp: weekly: Fix extractor (#16925) by bashonly (With fixes in 9055188)
- patreon: Support new URL format (#16926) by 0xvd
- peertube: Support password-protected videos (#16873) by selfhoster1312
- youtube: tab: Fix pagination (#16948) by bashonly
Downloader changes
- external:
curl: Support development versions (#16922) by syphyr
2026.06.10.041924
A description of the various files is in the README
The zipimport Unix executable contains 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 supported versions of Deno, Node, and Bun have been raised.
The minimum required version of Deno is nowv2.3.0; supported Node versions arev22and up; Bun support has been deprecated and limited to versions1.2.11through1.3.14. - Security
- Usage of vulnerable conversions (e.g.
%()s) with the--execoption is an all-too-common pitfall. To remedy this,--execnow only allows safe conversions in its command templates.- Most users can simply replace
%(...)swith%(...)qin their--execargument(s). Numeric conversions are unaffected by this change. Using unsafe conversions with--execposes a significant security risk. Read more
- Most users can simply replace
- [CVE-2026-50019] File Downloader cookie leak with curl
- Impact is limited to users of
--downloader curl; cookies are now properly passed to curl so that it respects their scope
- Impact is limited to users of
- [CVE-2026-50023] Dangerous file type creation via insufficient filename sanitization
- Writing files with the extensions
.desktop,.url, or.weblocis now only allowed in the context of--write-linkfunctionality
- Writing files with the extensions
- [CVE-2026-50574] Arbitrary code execution via manifest downloads with aria2c
- Impact is limited to users of
--downloader aria2c - Support for downloading HLS and DASH formats with aria2c has been removed. Users affected by this change should migrate to use
-Nfor concurrent fragment downloads via the native downloader
- Impact is limited to users of
- Usage of vulnerable conversions (e.g.
Changelog
Core changes
- Add lockfile and pinned extras (#16421) by bashonly, Grub4K (With fixes in 88c8a68 by bashonly)
- Fix
defaultextra foriosplatforms (#16376) by bashonly - Remove
url,desktopandweblocfrom safe extensions by Grub4K - update: Bump GitHub REST API version to
2026-03-10(#16435) by bashonly - utils
random_user_agent
Extractor changes
- Extract supplemental codecs from DASH manifests (#16827) by chrisellsworth
_resolve_nuxt_array: Handle PiniaskipHydrate(#16447) by doe1080- abematv: Extract subtitles (#16502) by garret1317
- ard: Support new
ardsoundsdomain (#16381) by evilpie - bandcamp: weekly: Fix extractor (#16373) by bashonly
- iwara: Fix extractors (#16014) by vpertys
- monstercat: Support older URLs (#16780) by AnAwesomGuy
- onsen: Fix extraction (#16830) by doe1080
- pornhub: Support browser impersonation (#16794) by 0xvd
- reddit: Fix unauthenticated extraction (#16839) by 0xvd, bashonly, jdesgats
- rtp: Support multi-part episodes and
--no-playlist(#16299) by bashonly - s4c: Extract more metadata (#16813) by Suntooth
- soop: Adapt extractors to new domain (#16436) by thematuu
- soundcloud
- thisoldhouse: Fix extractor (#16909) by bashonly, dirkf
- twitch
- Remove dead
rechatsubtitles (#16660) by kasper93 - clips: Fix extractor (#16466) by Ventriduct
- Remove dead
- twitter: Fix
view_countextraction (#16814) by MemoKing34 - wikimedia: Rework extractor (#15413) by seproDev
- youtube
- Drop support for
bun<1.2.11andbun>1.3.14(#16786) by bashonly - [Drop support for
deno<2.3.0](https://github.com/yt-dlp/yt-dlp/commit/...
- Drop support for
2026.05.18.044642
A description of the various files is in the README
The zipimport Unix executable contains 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
Changelog
Core changes
- Add lockfile and pinned extras (#16421) by bashonly, Grub4K (With fixes in 88c8a68 by bashonly)
- Fix
defaultextra foriosplatforms (#16376) by bashonly - update: Bump GitHub REST API version to
2026-03-10(#16435) by bashonly
Extractor changes
_resolve_nuxt_array: Handle PiniaskipHydrate(#16447) by doe1080- ard: Support new
ardsoundsdomain (#16381) by evilpie - bandcamp: weekly: Fix extractor (#16373) by bashonly
- rtp: Support multi-part episodes and
--no-playlist(#16299) by bashonly - soop: Adapt extractors to new domain (#16436) by thematuu
- soundcloud: Improve error handling (#16602) by bashonly
- twitch: clips: Fix extractor (#16466) by Ventriduct
- youtube
Networking changes
- Request Handler
- curl_cffi
Misc. changes
- build
- Harden build/release workflows (#16358) by bashonly, Grub4K (With fixes in cdc465a by bashonly)
- Harden release workflow (#16444) by bashonly
- Rename requirements files to clean up dependency graph (#16740) by bashonly
- Update 28 dependencies (#16467) by bashonly
- Upgrade all Linux binaries to Python 3.14 (#16738) by bashonly
- ci
- Bump pytest to 9.x (#16470) by bashonly, Grub4K
- Update 8 actions in 7 workflows (#16384) by bashonly
- Update wiki via this repository (#16446) by bashonly (With fixes in 9f0fc9a)
- cleanup: Miscellaneous: 35684c1, 3a12be7 by bashonly
- devscripts
- Handle
ejsupdates for requirements files (#16374) by bashonly, Grub4K update_requirements: Add reporting functionality (#16454) by bashonly, Grub4K
- Handle
- test: Add default and curl-cffi extras to hatch-test env (#16397) by JSubelj
2026.04.20.075853
A description of the various files is in the README
The zipimport Unix executable contains 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
Changelog
Core changes
- Add lockfile and pinned extras (#16421) by bashonly, Grub4K (With fixes in 88c8a68 by bashonly)
- Fix
defaultextra foriosplatforms (#16376) by bashonly - update: Bump GitHub REST API version to
2026-03-10(#16435) by bashonly
Extractor changes
_resolve_nuxt_array: Handle PiniaskipHydrate(#16447) by doe1080- ard: Support new
ardsoundsdomain (#16381) by evilpie - bandcamp: weekly: Fix extractor (#16373) by bashonly
- rtp: Support multi-part episodes and
--no-playlist(#16299) by bashonly - soop: Adapt extractors to new domain (#16436) by thematuu
- twitch: clips: Fix extractor (#16466) by Ventriduct
- youtube
Networking changes
- Request Handler
- curl_cffi
Misc. changes
- build
- Harden build/release workflows (#16358) by bashonly, Grub4K (With fixes in cdc465a by bashonly)
- Harden release workflow (#16444) by bashonly
- ci: Update wiki via this repository (#16446) by bashonly (With fixes in 9f0fc9a)
- devscripts
- Handle
ejsupdates for requirements files (#16374) by bashonly, Grub4K update_requirements: Add reporting functionality (#16454) by bashonly, Grub4K
- Handle
- test: Add default and curl-cffi extras to hatch-test env (#16397) by JSubelj
2026.04.08.143024
A description of the various files is in the README
The zipimport Unix executable contains 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
Changelog
Core changes
- Add lockfile and pinned extras (#16421) by bashonly, Grub4K (With fixes in 88c8a68 by bashonly)
- Fix
defaultextra foriosplatforms (#16376) by bashonly - update: Bump GitHub REST API version to
2026-03-10(#16435) by bashonly
Extractor changes
_resolve_nuxt_array: Handle PiniaskipHydrate(#16447) by doe1080- bandcamp: weekly: Fix extractor (#16373) by bashonly
- rtp: Support multi-part episodes and
--no-playlist(#16299) by bashonly - youtube: Fix outdated quickjs-ng warning (#16437) by bashonly
Networking changes
- Request Handler
- curl_cffi
Misc. changes
- build
- Harden build/release workflows (#16358) by bashonly, Grub4K (With fixes in cdc465a by bashonly)
- Harden release workflow (#16444) by bashonly
- ci: Update wiki via this repository (#16446) by bashonly (With fixes in 9f0fc9a)
- devscripts: Handle
ejsupdates for requirements files (#16374) by bashonly, Grub4K - test: Add default and curl-cffi extras to hatch-test env (#16397) by JSubelj
2026.03.18.053738
A description of the various files is in the README
The zipimport Unix executable contains 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
Changelog
Extractor changes
- youtube
Misc. changes
- build: Use PyInstaller v6.19.0 for Windows (#16265) by bashonly
- ci: Bump actions pins (#16252) by bashonly
- docs: Fix
player_clientextractor-arg documentation (#16235) by bashonly - test: networking: Mark all CurlCFFIRH tests as flaky for any OS (#16266) by bashonly
