player: add cover-art-whitelist option

This allows more fine grained control over which cover art to load. With
--cover-art-auto=exact and --cover-art-whitelist=yes, you can now load
cover art with the exact media filename and the whitelisted filenames,
but not cover art that contains the media filename
(--cover-art-auto=fuzzy).

1 files changed, 8 insertions, 2 deletions

diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index bca96ac2fb..21ff76708f 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -6905,8 +6905,7 @@ Miscellaneous
 
     :no:    Don't automatically load cover art.
     :exact: Load the media filename with an image file extension.
-    :fuzzy: Load all cover art containing the media filename and filenames
-            in an internal whitelist, such as ``cover.jpg`` (default).
+    :fuzzy: Load all cover art containing the media filename (default).
     :all:   Load all images in the current directory.
 
     See ``--cover-art-files`` for details about what constitutes cover art.
@@ -6914,6 +6913,13 @@ Miscellaneous
     See ``--audio-display`` how to control display of cover art (this can be
     used to disable cover art that is part of the file).
 
+``--cover-art-whitelist=<no|yes>``
+    Whether to load filenames in an internal whitelist, such as ``cover.jpg``,
+    as cover art. If ``cover-art-auto`` is set to ``no``, the whitelisted
+    filenames are never loaded even if this option is set to ``yes``.
+
+    Default: ``yes``.
+
 ``--autoload-files=<yes|no>``
     Automatically load/select external files (default: yes).