summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2020-02-20 14:51:48 +0100
committerwm4 <wm4@nowhere>2020-02-20 14:54:09 +0100
commit89203cc994bb0f2009f8553f611da67486330cd2 (patch)
tree41efa0feb341758e2c9a406d7298d7b4a0858a3c /DOCS/man/options.rst
parentc2e62817f610d5b73cc918d77603b23d9feef671 (diff)
downloadmpv-89203cc994bb0f2009f8553f611da67486330cd2.tar.bz2
mpv-89203cc994bb0f2009f8553f611da67486330cd2.tar.xz
ytdl_hook: attempt to filter out muxed streams if all_formats is used
See manpage additions. We would have to extend delay_open to support multiple sub-tracks (for audio and video), and we'd still don't know (?) whether it might contain more than one stream each (thinking of HLS master streams). And if it's a true interleaved file (such as a "normal" mp4 file provided as fallback for more primitive players), we'd either have to signal such "bundled" tracks, or waste bandwidth. This restructures a lot. The if/else tree in add_single_video for format selection was a bit annoying, so it's split into separate if blocks, where it checks each time whether a URL was determined yet.
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 6720b34831..59cab84619 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -846,6 +846,18 @@ Program Behavior
purpose for various technical reasons. In general, this option is not
useful, and was only added to show that it's possible.
+ The ``skip_muxed`` script option is a boolean (default: yes). It is used
+ only if ``all_formats`` is set. If set to 'yes', it will skip formats that
+ have both audio and video streams. Some sites that provide multiple
+ qualities will do so with separated audio and video streams (which is what
+ ``all_formats`` is supposed to make use of), still provide formats that
+ include both audio and video. We assume that they do so for compatibility
+ reasons, and ``skip_muxed`` filters them out. This will make loading faster,
+ and potentially avoid wasting bandwidth by using only one stream of a muxed
+ stream. On the other hand, if muxed streams are present, but the separate
+ streams lack either video or audio or do not exist at all, then the stream
+ selection as done by youtube-dl (via ``--ytdl-format``) is used.
+
The ``use_manifests`` script option makes mpv use the master manifest URL for
formats like HLS and DASH, if available, allowing for video/audio selection
in runtime. It's disabled ("no") by default for performance reasons.