Releases: nicolaasjan/yt-dlp
Releases · nicolaasjan/yt-dlp
Release list
2026.08.28.073407
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
Core changes
- update
Extractor changes
- adn: Add
profile_idextractor-arg (#17522) by arobase-che - bandcamp: Fix extractors (#17546) by bashonly
- globalplayer: Fix extractors (#17442) by LillieH1000
- go: Improve error handling (#15882) by norepro
- niconico: channel: Support channels (#17398) by doe1080
- showroom: Fix extractor (#17488) by doe1080, wlerin
- ted: Fix extractor (#17510) by InvalidUsernameException
- tubitv
- Improve extractor (#16428) by InvalidUsernameException
- series: Fix extractor (#17545) by InvalidUsernameException
- twitch: clips: Fix extractor (#17554) by bashonly
Misc. changes
- cleanup: Remove obsolete Python compatibility code (#17357) by doe1080
- test: Fix handshake error matching for OpenSSL 4.x (#17491) by mikelolasagasti
2026.08.20.045433
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
Core changes
- utils
- Deprecate
number_of_digits(#17300) by doe1080 - Deprecate
random_uuidv4(#17301) by doe1080 float_or_none: CatchOverflowError(#17299) by doe1080random_user_agent: Bump version range 144-150 => 145-151 (#17344) by dlp-bot
- Deprecate
Extractor changes
- americastestkitchen: Fix season/series extraction (#17151) by bm1549
- apple: Rework extractors (#17277) by bashonly
- ard: Remove dead extractor (#17158) by InvalidUsernameException
- bandcamp: Support browser impersonation (#17422) by InvalidUsernameException
- bfmtv: Fix extractor (#16905) by 0xvd
- instagram: Fix logged-in extraction (#17278) by bashonly
- showroom: Rework extractors (#17142) by doe1080
- tiktok
- Fix extractor (#17452) by bashonly (With fixes in 2c0bf96)
- Fix formats extraction (#17460) by bashonly
- Support share URLs (#17459) by bashonly
- twitter: broadcast: Fix events handling (#17323) by doe1080
- vimeo: Remove
iosandmacosclients (#17290) by bashonly - whyp: Fix extractor (#17467) by bashonly
- youtube
- Add
visionosplayer client (#17184) by bashonly - Add
web_embeddedclient fallbacks (#17462) by bashonly - Extract
channel_follower_countfor collaborators (#17363) by bashonly - Fix live adaptive fragments generation (#17262) by bashonly
- Player client maintenance (#17261) by bashonly
- Remove
android_vrfrom default clients (#17461) by bashonly - Update player client versions (#17185) by bashonly
- tab: Always extract channel metadata (#17386) by bashonly, bbilly1
- Add
Downloader changes
Networking changes
- Request Handler: curl_cffi: Support
curl_cffi0.16.x (#17439) by bashonly, coletdjnz (With fixes in 5f22baf by bashonly)
Misc. changes
- Fix third party license information (#17150) by bashonly, seproDev
- build
- ci
- cleanup
- Miscellaneous
- [4e969d3](yt-dlp@4e969d3...
- Miscellaneous
2026.08.16.082019
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
Core changes
- utils:
random_user_agent: Bump version range 144-150 => 145-151 (#17344) by dlp-bot
Extractor changes
- americastestkitchen: Fix season/series extraction (#17151) by bm1549
- apple: Rework extractors (#17277) by bashonly
- ard: Remove dead extractor (#17158) by InvalidUsernameException
- instagram: Fix logged-in extraction (#17278) by bashonly
- showroom: Rework extractors (#17142) by doe1080
- vimeo
- youtube
Downloader changes
Networking changes
- Request Handler: curl_cffi: Support
curl_cffi0.16.x (#17439) by bashonly, coletdjnz (With fixes in 5f22baf by bashonly)
Misc. changes
- Fix third party license information (#17150) by bashonly, seproDev
- build
- ci
- cleanup: Miscellaneous: 4e969d3 by bashonly, BOplaid, dialmaster, gamer191
- test
- networking: Fix logging handler removal test (#17379) by doe1080
- socks: Fix compatibility with
websockets>=17(#17433) by doe1080
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
