mirror of
https://github.com/yt-dlp/yt-dlp.git
synced 2025-10-03 21:33:23 -04:00
Add regex to --match-filter
This does not fully deprecate `--match-title`/`--reject-title` since `--match-filter` is only checked after the extraction is complete, while `--match-title` can often be checked from the flat playlist. Fixes: https://github.com/ytdl-org/youtube-dl/issues/9092, https://github.com/ytdl-org/youtube-dl/issues/23035
This commit is contained in:
27
README.md
27
README.md
@@ -340,19 +340,22 @@ Then simply run `make`. You can also run `make yt-dlp` instead to compile only t
|
||||
COUNT views
|
||||
--match-filter FILTER Generic video filter. Any field (see
|
||||
"OUTPUT TEMPLATE") can be compared with a
|
||||
number or a quoted string using the
|
||||
operators defined in "Filtering formats".
|
||||
You can also simply specify a field to
|
||||
match if the field is present and "!field"
|
||||
to check if the field is not present.
|
||||
Multiple filters can be checked using "&".
|
||||
For example, to only match videos that are
|
||||
not live, has a like count more than 100, a
|
||||
dislike count less than 50 (or the dislike
|
||||
number or a string using the operators
|
||||
defined in "Filtering formats". You can
|
||||
also simply specify a field to match if the
|
||||
field is present and "!field" to check if
|
||||
the field is not present. In addition,
|
||||
Python style regular expression matching
|
||||
can be done using "~=", and multiple
|
||||
filters can be checked with "&". Use a "\"
|
||||
to escape "&" or quotes if needed. Eg:
|
||||
--match-filter "!is_live & like_count>?100
|
||||
& description~=\'(?i)\bcats \& dogs\b\'"
|
||||
matches only videos that are not live, has
|
||||
a like count more than 100 (or the like
|
||||
field is not available), and also has a
|
||||
description that contains "python", use
|
||||
--match-filter "!is_live & like_count>100 &
|
||||
dislike_count<?50 & description*='python'"
|
||||
description that contains the phrase "cats
|
||||
& dogs" (ignoring case)
|
||||
--no-match-filter Do not use generic video filter (default)
|
||||
--no-playlist Download only the video, if the URL refers
|
||||
to a video and a playlist
|
||||
|
Reference in New Issue
Block a user