diff --git a/README.md b/README.md index e167995eb8..ae60413f28 100644 --- a/README.md +++ b/README.md @@ -2336,7 +2336,7 @@ Some of yt-dlp's default options are different from that of youtube-dl and youtu * Passing `--simulate` (or calling `extract_info` with `download=False`) no longer alters the default format selection. See [#9843](https://github.com/yt-dlp/yt-dlp/issues/9843) for details. * yt-dlp no longer applies the server modified time to downloaded files by default. Use `--mtime` or `--compat-options mtime-by-default` to revert this. -For ease of use, a few more compat options are available: +For convenience, there are some compat option aliases available to use: * `--compat-options all`: Use all compat options (**Do NOT use this!**) * `--compat-options youtube-dl`: Same as `--compat-options all,-multistreams,-playlist-match-filter,-manifest-filesize-approx,-allow-unsafe-ext,-prefer-vp9-sort` @@ -2344,7 +2344,10 @@ For ease of use, a few more compat options are available: * `--compat-options 2021`: Same as `--compat-options 2022,no-certifi,filename-sanitization` * `--compat-options 2022`: Same as `--compat-options 2023,playlist-match-filter,no-external-downloader-progress,prefer-legacy-http-handler,manifest-filesize-approx` * `--compat-options 2023`: Same as `--compat-options 2024,prefer-vp9-sort` -* `--compat-options 2024`: Same as `--compat-options mtime-by-default`. Use this to enable all future compat options +* `--compat-options 2024`: Same as `--compat-options 2025,mtime-by-default` +* `--compat-options 2025`: Currently does nothing. Use this to enable all future compat options + +Using one of the yearly compat option aliases will pin yt-dlp's default behavior to what it was at the *end* of that calendar year. The following compat options restore vulnerable behavior from before security patches: diff --git a/yt_dlp/options.py b/yt_dlp/options.py index 4e81761f56..9658a9da51 100644 --- a/yt_dlp/options.py +++ b/yt_dlp/options.py @@ -574,7 +574,8 @@ def create_parser(): '2021': ['2022', 'no-certifi', 'filename-sanitization'], '2022': ['2023', 'no-external-downloader-progress', 'playlist-match-filter', 'prefer-legacy-http-handler', 'manifest-filesize-approx'], '2023': ['2024', 'prefer-vp9-sort'], - '2024': ['mtime-by-default'], + '2024': ['2025', 'mtime-by-default'], + '2025': [], }, }, help=( 'Options that can help keep compatibility with youtube-dl or youtube-dlc '