4 # Instuctions for creating release
7 * Update Changelog.md and CONTRIBUTORS
8 * Change "Merged with ytdl" version in Readme.md if needed
9 * Commit to master as
`Release <version>`
10 * Push to origin/release - build task will now run
11 * Update version.py using devscripts\update-version.py
12 * Run
`make issuetemplates`
13 * Commit to master as
`[version] update :ci skip all`
14 * Push to origin/master
15 * Update changelog in /releases
25 * [youtube] Use new browse API for continuation page extraction by [colethedj](https://github.com/colethedj) and
[pukkandan](https://github.com/pukkandan)
26 * Fix HLS playlist downloading by
[shirt](https://github.com/shirt-dev)
27 * **Merge youtube-dl:** Upto
[2021.03.03](https://github.com/ytdl-org/youtube-dl/releases/tag/2021.03.03)
29 * [nick] Fix extractor by [DennyDai](https://github.com/DennyDai)
30 * [mxplayer] Add new extractor by [codeasashu](https://github.com/codeasashu)
31 * [youtube] Throw error when
`--extractor-retries` are exhausted
32 * Reduce default of
`--extractor-retries` to
3
33 * Fix packaging bugs by
[hseg](https://github.com/hseg)
37 * Allow specifying path in
`--external-downloader`
38 * Add option
`--sleep-requests` to sleep b/w requests
39 * Add option
`--extractor-retries` to retry on known extractor errors
40 * Extract comments only when needed
41 * `--get-comments` doesn't imply
`--write-info-json` if
`-J`,
`-j` or
`--print-json` are used
42 * Fix
`get_executable_path` by
[shirt](https://github.com/shirt-dev)
43 * [youtube] Retry on more known errors than just HTTP-
5xx
44 * [youtube] Fix inconsistent
`webpage_url`
45 * [tennistv] Fix format sorting
46 * [bilibiliaudio] Recognize the file as audio-only
47 * [hrfensehen] Fix wrong import
48 * [viki] Fix viki play pass authentication by [RobinD42](https://github.com/RobinD42)
49 * [readthedocs] Improvements by [shirt](https://github.com/shirt-dev)
50 * [hls] Fix bug with m3u8 format extraction
51 * [hls] Enable
`--hls-use-mpegts` by default when downloading live-streams
52 * [embedthumbnail] Fix bug with deleting original thumbnail
53 * [build] Fix completion paths, zsh pip completion install by [hseg](https://github.com/hseg)
54 * [ci] Disable download tests unless specifically invoked
55 * Cleanup some code and fix typos
59 * Moved project to an organization
[yt-dlp](https://github.com/yt-dlp)
60 * **Completely changed project name to yt-dlp** by
[Pccode66](https://github.com/Pccode66) and
[pukkandan](https://github.com/pukkandan)
61 * Also,
`youtube-dlc` config files are no longer loaded
62 * **Merge youtube-dl:** Upto
[commit/4460329](https://github.com/ytdl-org/youtube-dl/commit/44603290e5002153f3ebad6230cc73aef42cc2cd) (except tmz, gedi)
63 * [Readthedocs](https://yt-dlp.readthedocs.io) support by
[shirt](https://github.com/shirt-dev)
64 * [youtube] Show if video was a live stream in info (
`was_live`)
65 * [Zee5] Add new extractor by [Ashish](https://github.com/Ashish) and
[pukkandan](https://github.com/pukkandan)
66 * [jwplatform] Add support for
`hyland.com`
67 * [tennistv] Fix extractor
68 * [hls] Support media initialization by [shirt](https://github.com/shirt-dev)
69 * [hls] Added options `--hls-split-discontinuity` to better support media discontinuity by [shirt](https://github.com/shirt-dev)
70 * [ffmpeg] Allow passing custom arguments before -i using
`--ppa "ffmpeg_i1:ARGS"` syntax
71 * Fix
`--windows-filenames` removing
`/` from UNIX paths
72 * [hls] Show warning if pycryptodome is not found
73 * [documentation] Improvements
74 * Fix documentation of
`Extractor Options`
75 * Document
`all` in format selection
76 * Document
`playable_in_embed` in output templates
80 * **Merge youtube-dl:** Upto
[commit/cf2dbec](https://github.com/ytdl-org/youtube-dl/commit/cf2dbec6301177a1fddf72862de05fa912d9869d) (except kakao)
81 * [viki] Fix extractor
82 * [niconico] Extract `channel` and `channel_id` by [kurumigi](https://github.com/kurumigi)
83 * [youtube] Multiple page support for hashtag URLs
84 * [youtube] Add more invidious instances
85 * [youtube] Fix comment extraction when comment text is empty
86 * Option
`--windows-filenames` to force use of windows compatible filenames
87 * [ExtractAudio] Bugfix
88 * Don't raise
`parser.error` when exiting for update
89 * [MoveFiles] Fix for when merger can't run
90 * Changed
`--trim-file-name` to
`--trim-filenames` to be similar to related options
91 * Format Sort improvements:
92 * Prefer
`vp9.2` more than other
`vp9` codecs
93 * Remove forced priority of
`quality`
94 * Remove unnecessary
`field_preference` and misuse of
`preference` from extractors
96 * Fix hash output by
[shirt](https://github.com/shirt-dev)
97 * Lock python package versions for x86 and use
`wheels` by
[shirt](https://github.com/shirt-dev)
98 * Exclude
`vcruntime140.dll` from UPX by
[jbruchon](https://github.com/jbruchon)
99 * Set version number based on UTC time, not local time
100 * Publish on PyPi only if token is set
101 * [documentation] Better document
`--prefer-free-formats` and add
`--no-prefer-free-format`
105 * **Merge youtube-dl:** Upto
[2021.02.10](https://github.com/ytdl-org/youtube-dl/releases/tag/2021.02.10) (except archive.org)
106 * [niconico] Improved extraction and support encrypted/SMILE movies by [kurumigi](https://github.com/kurumigi),
[tsukumi](https://github.com/tsukumi),
[bbepis](https://github.com/bbepis),
[pukkandan](https://github.com/pukkandan)
107 * Fix HLS AES-
128 with multiple keys in external downloaders by
[shirt](https://github.com/shirt-dev)
108 * [youtube_live_chat] Fix by using POST API by [siikamiika](https://github.com/siikamiika)
109 * [rumble] Add support for video page
110 * Option
`--allow-unplayable-formats` to allow downloading unplayable video formats
111 * [ExtractAudio] Don't re-encode when file is already in a common audio format
112 * [youtube] Fix search continuations
113 * [youtube] Fix for new accounts
114 * Improve build/updater: by
[pukkandan](https://github.com/pukkandan) and
[shirt](https://github.com/shirt-dev)
115 * Fix SHA256 calculation in build and implement hash checking for updater
116 * Exit immediately in windows once the update process starts
117 * Fix updater for
`x86.exe`
118 * Updater looks for both
`yt-dlp` and
`youtube-dlc` in releases for future-proofing
119 * Change optional dependency to
`pycryptodome`
120 * Fix issue with unicode filenames in aria2c by
[shirt](https://github.com/shirt-dev)
121 * Fix
`allow_playlist_files` not being correctly passed through
122 * Fix for empty HTTP head requests by
[shirt](https://github.com/shirt-dev)
123 * Fix
`get_executable_path` in UNIX
124 * [sponskrub] Print ffmpeg output and errors to terminal
125 * `__real_download` should be false when ffmpeg unavailable and no download
126 * Show
`exe`/
`zip`/
`source` and
32/
64bit in verbose message
130 * **aria2c support for DASH/HLS**: by
[shirt](https://github.com/shirt-dev)
131 * **Implement Updater** (
`-U`) by
[shirt](https://github.com/shirt-dev)
132 * [youtube] Fix comment extraction
133 * [youtube_live_chat] Improve extraction
134 * [youtube] Fix for channel URLs sometimes not downloading all pages
135 * [aria2c] Changed default arguments to
`--console-log-level=warn --summary-interval=0 --file-allocation=none -x16 -j16 -s16`
136 * Add fallback for thumbnails
137 * [embedthumbnail] Keep original thumbnail after conversion if write_thumbnail given
138 * [embedsubtitle] Keep original subtitle after conversion if write_subtitles given
139 * [pyinst.py] Move back to root dir
140 * [youtube] Simplified renderer parsing and bugfixes
141 * [movefiles] Fix compatibility with python2
142 * [remuxvideo] Fix validation of conditional remux
143 * [sponskrub] Don't raise error when the video does not exist
144 * [documentation] Crypto is an optional dependency
148 * **Merge youtube-dl:** Upto
[2021.02.04.1](https://github.com/ytdl-org/youtube-dl/releases/tag/2021.02.04.1)
149 * **Date/time formatting in output template:**
150 * You can use
[`strftime`](https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes) to format date/time fields. Example:
`%(upload_date>%Y-%m-%d)s`
151 * **Multiple output templates:**
152 * Separate output templates can be given for the different metadata files by using
`-o TYPE:TEMPLATE`
153 * The allowed types are:
`subtitle|thumbnail|description|annotation|infojson|pl_description|pl_infojson`
154 * [youtube] More metadata extraction for channel/playlist URLs (channel, uploader, thumbnail, tags)
155 * New option
`--no-write-playlist-metafiles` to prevent writing playlist metadata files
156 * [audius] Fix extractor
157 * [youtube_live_chat] Fix
`parse_yt_initial_data` and add
`fragment_retries`
158 * [postprocessor] Raise errors correctly
159 * [metadatafromtitle] Fix bug when extracting data from numeric fields
160 * Fix issue with overwriting files
161 * Fix "Default format spec" appearing in quiet mode
162 * [FormatSort] Allow user to prefer av01 over vp9 (The default is still vp9)
163 * [FormatSort] fix bug where
`quality` had more priority than
`hasvid`
164 * [pyinst] Automatically detect python architecture and working directory
165 * Strip out internal fields such as
`_filename` from infojson
169 * **Features from
[animelover1984/youtube-dl](https://github.com/animelover1984/youtube-dl)**: by
[animelover1984](https://github.com/animelover1984) and
[bbepis](https://github.com/bbepis)
170 * Add
`--get-comments`
171 * [youtube] Extract comments
172 * [billibilli] Added BiliBiliSearchIE, BilibiliChannelIE
173 * [billibilli] Extract comments
174 * [billibilli] Better video extraction
175 * Write playlist data to infojson
176 * [FFmpegMetadata] Embed infojson inside the video
177 * [EmbedThumbnail] Try embedding in mp4 using ffprobe and
`-disposition`
178 * [EmbedThumbnail] Treat mka like mkv and mov like mp4
179 * [EmbedThumbnail] Embed in ogg/opus
180 * [VideoRemuxer] Conditionally remux video
181 * [VideoRemuxer] Add
`-movflags +faststart` when remuxing to mp4
182 * [ffmpeg] Print entire stderr in verbose when there is error
183 * [EmbedSubtitle] Warn when embedding ass in mp4
184 * [anvato] Use NFLTokenGenerator if possible
185 * **Parse additional metadata**: New option
`--parse-metadata` to extract additional metadata from existing fields
186 * The extracted fields can be used in
`--output`
187 * Deprecated
`--metadata-from-title`
188 * [Audius] Add extractor
189 * [youtube] Extract playlist description and write it to
`.description` file
190 * Detect existing files even when using
`recode`/
`remux` (
`extract-audio` is partially fixed)
191 * Fix wrong user config from v2021.01
.24
192 * [youtube] Report error message from youtube as error instead of warning
193 * [FormatSort] Fix some fields not sorting from v2021.01
.24
194 * [postprocessor] Deprecate
`avconv`/
`avprobe`. All current functionality is left untouched. But don't expect any new features to work with avconv
195 * [postprocessor] fix
`write_debug` to not throw error when there is no
`_downloader`
196 * [movefiles] Don't give "cant find" warning when move is unnecessary
197 * Refactor
`update-version`,
`pyinst.py` and related files
198 * [ffmpeg] Document more formats that are supported for remux/recode
202 * **Merge youtube-dl:** Upto
[2021.01.24](https://github.com/ytdl-org/youtube-dl/releases/tag/2021.01.16)
203 * Plugin support (
[documentation](https://github.com/yt-dlp/yt-dlp#plugins))
204 * **Multiple paths**: New option
`-P`/
`--paths` to give different paths for different types of files
205 * The syntax is
`-P "type:path" -P "type:path"` (
[documentation](https://github.com/yt-dlp/yt-dlp#:~:text=-P,%20--paths%20TYPE:PATH))
206 * Valid types are: home, temp, description, annotation, subtitle, infojson, thumbnail
207 * Additionally, configuration file is taken from home directory or current directory (
[documentation](https://github.com/yt-dlp/yt-dlp#:~:text=Home%20Configuration))
208 * Allow passing different arguments to different external downloaders (
[documentation](https://github.com/yt-dlp/yt-dlp#:~:text=--downloader-args%20NAME:ARGS))
209 * [mildom] Add extractor by [nao20010128nao](https://github.com/nao20010128nao)
210 * Warn when using old style
`--external-downloader-args` and
`--post-processor-args`
211 * Fix
`--no-overwrite` when using
`--write-link`
212 * [sponskrub] Output
`unrecognized argument` error message correctly
213 * [cbs] Make failure to extract title non-fatal
214 * Fix typecasting when pre-checking archive
215 * Fix issue with setting title on UNIX
216 * Deprecate redundant aliases in
`formatSort`. The aliases remain functional for backward compatibility, but will be left undocumented
217 * [tests] Fix test_post_hooks
218 * [tests] Split core and download tests
222 * [TrovoLive] Add extractor (only VODs)
223 * [pokemon] Add
`/#/player` URLs
224 * Improved parsing of multiple postprocessor-args, add
`--ppa` as alias
225 * [EmbedThumbnail] Simplify embedding in mkv
226 * [sponskrub] Encode filenames correctly, better debug output and error message
227 * [readme] Cleanup options
231 * **Merge youtube-dl:** Upto
[2021.01.16](https://github.com/ytdl-org/youtube-dl/releases/tag/2021.01.16)
232 * **Configuration files:**
233 * Portable configuration file:
`./yt-dlp.conf`
234 * Allow the configuration files to be named
`yt-dlp` instead of
`youtube-dlc`. See
[this](https://github.com/yt-dlp/yt-dlp#configuration) for details
239 * Added option
`--break-on-reject`
240 * [roosterteeth.com] Fix for bonus episodes by [Zocker1999NET](https://github.com/Zocker1999NET)
241 * [tiktok] Fix for when share_info is empty
242 * [EmbedThumbnail] Fix bug due to incorrect function name
243 * [documentation] Changed sponskrub links to point to [yt-dlp/SponSkrub](https://github.com/yt-dlp/SponSkrub) since I am now providing both linux and windows releases
244 * [documentation] Change all links to correctly point to new fork URL
245 * [documentation] Fixes typos
249 * [roosterteeth.com] Add subtitle support by [samiksome](https://github.com/samiksome)
250 * Added
`--force-overwrites`,
`--no-force-overwrites` by
[alxnull](https://github.com/alxnull)
251 * Changed fork name to
`yt-dlp`
252 * Fix typos by
[FelixFrog](https://github.com/FelixFrog)
253 * [ci] Option to skip
254 * [changelog] Added unreleased changes in blackjack4494/yt-dlc
258 * [archive.org] Fix extractor and add support for audio and playlists by [wporr](https://github.com/wporr)
259 * [Animelab] Added by [mariuszskon](https://github.com/mariuszskon)
260 * [youtube:search] Fix view_count by [ohnonot](https://github.com/ohnonot)
261 * [youtube] Show if video is embeddable in info
262 * Update version badge automatically in README
263 * Enable
`test_youtube_search_matching`
264 * Create
`to_screen` and similar functions in postprocessor/common
268 * [youtube] Fix bug in automatic caption extraction
269 * Add
`post_hooks` to YoutubeDL by
[alexmerkel](https://github.com/alexmerkel)
270 * Batch file enumeration improvements by
[glenn-slayden](https://github.com/glenn-slayden)
271 * Stop immediately when reaching
`--max-downloads` by
[glenn-slayden](https://github.com/glenn-slayden)
272 * Fix incorrect ANSI sequence for restoring console-window title by
[glenn-slayden](https://github.com/glenn-slayden)
273 * Kill child processes when yt-dlc is killed by
[Unrud](https://github.com/Unrud)
277 * **Merge youtube-dl:** Upto
[2021.01.08](https://github.com/ytdl-org/youtube-dl/releases/tag/2021.01.08)
278 * Extractor stitcher (
[1](https://github.com/ytdl-org/youtube-dl/commit/bb38a1215718cdf36d73ff0a7830a64cd9fa37cc),
[2](https://github.com/ytdl-org/youtube-dl/commit/a563c97c5cddf55f8989ed7ea8314ef78e30107f)) have not been merged
279 * Moved changelog to seperate file
283 * [Akamai] fix by [nixxo](https://github.com/nixxo)
284 * [Tiktok] merge youtube-dl tiktok extractor by [GreyAlien502](https://github.com/GreyAlien502)
285 * [vlive] add support for playlists by [kyuyeunk](https://github.com/kyuyeunk)
286 * [youtube_live_chat] make sure playerOffsetMs is positive by [siikamiika](https://github.com/siikamiika)
287 * Ignore extra data streams in ffmpeg by
[jbruchon](https://github.com/jbruchon)
288 * Allow passing different arguments to different postprocessors using
`--postprocessor-args`
289 * Deprecated
`--sponskrub-args`. The same can now be done using
`--postprocessor-args "sponskrub:<args>"`
290 * [CI] Split tests into core-test and full-test
294 * Removed priority of
`av01` codec in
`-S` since most devices don't support it yet
295 * Added
`duration_string` to be used in
`--output`
296 * Created First Release
300 * **Changed defaults:**
302 * Disabled
`--video-multistreams` and
`--audio-multistreams`
303 * Changed default format selection to
`bv*+ba/b` when
`--audio-multistreams` is disabled
304 * Changed default format sort order to
`res,fps,codec,size,br,asr,proto,ext,has_audio,source,format_id`
305 * Changed
`webm` to be more preferable than
`flv` in format sorting
306 * Changed default output template to
`%(title)s [%(id)s].%(ext)s`
307 * Enabled
`--list-formats-as-table`
311 * **Format Sort:** Added
`--format-sort` (
`-S`),
`--format-sort-force` (
`--S-force`) - See [Sorting Formats](README.md#sorting-formats) for details
312 * **Format Selection:** See [Format Selection](README.md#format-selection) for details
313 * New format selectors:
`best*`,
`worst*`,
`bestvideo*`,
`bestaudio*`,
`worstvideo*`,
`worstaudio*`
314 * Changed video format sorting to show video only files and video+audio files together.
315 * Added
`--video-multistreams`,
`--no-video-multistreams`,
`--audio-multistreams`,
`--no-audio-multistreams`
316 * Added
`b`,
`w`,
`v`,
`a` as alias for
`best`,
`worst`,
`video` and
`audio` respectively
317 * **Shortcut Options:** Added
`--write-link`,
`--write-url-link`,
`--write-webloc-link`,
`--write-desktop-link` by
[h-h-h-h](https://github.com/h-h-h-h) - See [Internet Shortcut Options](README.md#internet-shortcut-options) for details
318 * **Sponskrub integration:** Added
`--sponskrub`,
`--sponskrub-cut`,
`--sponskrub-force`,
`--sponskrub-location`,
`--sponskrub-args` - See [SponSkrub Options](README.md#sponskrub-sponsorblock-options) for details
319 * Added
`--force-download-archive` (
`--force-write-archive`) by
[h-h-h-h](https://github.com/h-h-h-h)
320 * Added
`--list-formats-as-table`,
`--list-formats-old`
321 * **Negative Options:** Makes it possible to negate most boolean options by adding a
`no-` to the switch. Usefull when you want to reverse an option that is defined in a config file
322 * Added
`--no-ignore-dynamic-mpd`,
`--no-allow-dynamic-mpd`,
`--allow-dynamic-mpd`,
`--youtube-include-hls-manifest`,
`--no-youtube-include-hls-manifest`,
`--no-youtube-skip-hls-manifest`,
`--no-download`,
`--no-download-archive`,
`--resize-buffer`,
`--part`,
`--mtime`,
`--no-keep-fragments`,
`--no-cookies`,
`--no-write-annotations`,
`--no-write-info-json`,
`--no-write-description`,
`--no-write-thumbnail`,
`--youtube-include-dash-manifest`,
`--post-overwrites`,
`--no-keep-video`,
`--no-embed-subs`,
`--no-embed-thumbnail`,
`--no-add-metadata`,
`--no-include-ads`,
`--no-write-sub`,
`--no-write-auto-sub`,
`--no-playlist-reverse`,
`--no-restrict-filenames`,
`--youtube-include-dash-manifest`,
`--no-format-sort-force`,
`--flat-videos`,
`--no-list-formats-as-table`,
`--no-sponskrub`,
`--no-sponskrub-cut`,
`--no-sponskrub-force`
323 * Renamed:
`--write-subs`,
`--no-write-subs`,
`--no-write-auto-subs`,
`--write-auto-subs`. Note that these can still be used without the ending "s"
324 * Relaxed validation for format filters so that any arbitrary field can be used
325 * Fix for embedding thumbnail in mp3 by
[pauldubois98](https://github.com/pauldubois98) (
[ytdl-org/youtube-dl#21569](https://github.com/ytdl-org/youtube-dl/pull/21569))
326 * Make Twitch Video ID output from Playlist and VOD extractor same. This is only a temporary fix
327 * **Merge youtube-dl:** Upto
[2021.01.03](https://github.com/ytdl-org/youtube-dl/commit/8e953dcbb10a1a42f4e12e4e132657cb0100a1f8) - See
[blackjack4494/yt-dlc#280](https://github.com/blackjack4494/yt-dlc/pull/280) for details
328 * Extractors
[tiktok](https://github.com/ytdl-org/youtube-dl/commit/fb626c05867deab04425bad0c0b16b55473841a2) and
[hotstar](https://github.com/ytdl-org/youtube-dl/commit/bb38a1215718cdf36d73ff0a7830a64cd9fa37cc) have not been merged
329 * Cleaned up the fork for public use
332 ### Unreleased changes in [blackjack4494/yt-dlc](https://github.com/blackjack4494/yt-dlc)
333 * Updated to youtube-dl release
2020.11.26
335 * Implemented all Youtube Feeds (ytfav, ytwatchlater, ytsubs, ythistory, ytrec) and SearchURL
336 * Fix ytsearch not returning results sometimes due to promoted content
337 * Temporary fix for automatic captions - disable json3
338 * Fix some improper Youtube URLs
339 * Redirect channel home to /video
340 * Print youtube's warning message
341 * Multiple pages are handled better for feeds
342 * Add --break-on-existing by
[gergesh](https://github.com/gergesh)
343 * Pre-check video IDs in the archive before downloading
344 * [bitwave.tv] New extractor
345 * [Gedi] Add extractor
346 * [Rcs] Add new extractor
347 * [skyit] Add support for multiple Sky Italia website and removed old skyitalia extractor
348 * [france.tv] Fix thumbnail URL
349 * [ina] support mobile links
350 * [instagram] Fix extractor
351 * [itv] BTCC new pages' URL update (articles instead of races)
352 * [SouthparkDe] Support for English URLs
353 * [spreaker] fix SpreakerShowIE test URL
354 * [Vlive] Fix playlist handling when downloading a channel
355 * [generic] Detect embedded bitchute videos
356 * [generic] Extract embedded youtube and twitter videos
357 * [ffmpeg] Ensure all streams are copied
358 * Fix for os.rename error when embedding thumbnail to video in a different drive
359 * make_win.bat: don't use UPX to pack vcruntime140.dll