diff options
Diffstat (limited to 'DOCS/man')
-rw-r--r-- | DOCS/man/options.rst | 34 |
1 files changed, 33 insertions, 1 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index e9d5016074..fd19d3d25c 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -6603,7 +6603,39 @@ Miscellaneous ``--external-file=<file>`` CLI/config file only alias for ``--external-files-append``. Each use of this - option will add a new external files. + option will add a new external file. + +``--cover-art-files=<file-list>`` + Use an external file as cover art while playing audio. This makes it appear + on the track list and subject to automatic track selection. Options like + ``--audio-display`` control whether such tracks are supposed to be selected. + + (The difference to loading a file with ``--external-files`` is that video + tracks will be marked as being pictures, which affects the auto-selection + method. If the passed file is a video, only the first frame will be decoded + and displayed. Enabling the cover art track during playback may show a + random frame if the source file is a video. Normally you're not supposed to + pass videos to this option, so this paragraph describes the behavior + coincidentally resulting from implementation details.) + + This is a path list option. See `List Options`_ for details. + +``--cover-art-file=<file>`` + CLI/config file only alias for ``--cover-art-files-append``. Each use of this + option will add a new external file. + +``--cover-art-auto=<no|fuzzy>`` + Whether to load _external_ cover art automatically (default: fuzzy). Similar + to ``--sub-auto`` and ``--audio-file-auto``. However, it's currently limited + to picking up a whitelist of "album art" filenames (such as ``cover.jpg``), + so currently only the ``fuzzy`` choice is available. In addition, if a video + already has tracks (which are not marked as cover art), external cover art + will not be loaded. + + See ``--cover-art-files`` for details about what constitutes cover art. + + See ``--audio-display`` how to control display of cover art (this can be + used to disable cover art that is part of the file). ``--autoload-files=<yes|no>`` Automatically load/select external files (default: yes). |