From 77b87f0519719c4264f400f5627da86c12f48bca Mon Sep 17 00:00:00 2001
From: Max Teegen <870074+max-te@users.noreply.github.com>
Date: Sun, 13 Jun 2021 16:25:19 +0200
Subject: Add all format filtering operators also to `--match-filter`

PR: https://github.com/ytdl-org/youtube-dl/pull/27361

Authored by: max-te
---
 README.md | 34 +++++++++++++++-------------------
 1 file changed, 15 insertions(+), 19 deletions(-)

(limited to 'README.md')

diff --git a/README.md b/README.md
index 5a51bdf5f..1967d216c 100644
--- a/README.md
+++ b/README.md
@@ -338,25 +338,21 @@ Then simply run `make`. You can also run `make yt-dlp` instead to compile only t
                                      COUNT views
     --max-views COUNT                Do not download any videos with more than
                                      COUNT views
-    --match-filter FILTER            Generic video filter. Specify any key (see
-                                     "OUTPUT TEMPLATE" for a list of available
-                                     keys) to match if the key is present, !key
-                                     to check if the key is not present,
-                                     key>NUMBER (like "view_count > 12", also
-                                     works with >=, <, <=, !=, =) to compare
-                                     against a number, key = 'LITERAL' (like
-                                     "uploader = 'Mike Smith'", also works with
-                                     !=) to match against a string literal and &
-                                     to require multiple matches. Values which
-                                     are not known are excluded unless you put a
-                                     question mark (?) after the operator. For
-                                     example, to only match videos that have
-                                     been liked more than 100 times and disliked
-                                     less than 50 times (or the dislike
-                                     functionality is not available at the given
-                                     service), but who also have a description,
-                                     use --match-filter "like_count > 100 &
-                                     dislike_count <? 50 & description"
+    --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
+                                     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'"
     --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
-- 
cgit v1.2.3