summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2020-02-19 16:33:48 +0100
committerwm4 <wm4@nowhere>2020-02-19 16:33:48 +0100
commit6d8b4ca742d931634be19fb01d4310d7b7fb8de0 (patch)
tree9c97db4e42a8c181992b2172b08dbd339d3de61b /DOCS
parent43c13e5ea23230edca38426d4a9eed049a70890e (diff)
downloadmpv-6d8b4ca742d931634be19fb01d4310d7b7fb8de0.tar.bz2
mpv-6d8b4ca742d931634be19fb01d4310d7b7fb8de0.tar.xz
ytdl_hook: add all_formats option
Pretty worthless I guess. I only tested one site (and 2 videos), it's somewhat likely that it will break with other sites. Even if you leave the option disabled (the default). Slightly related to #3548. This will allows you to use the bitrate stream selection mechanism, that was added for HLS, with normal videos.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/options.rst17
1 files changed, 17 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index f0543c7275..6ef710137f 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -823,6 +823,19 @@ Program Behavior
should use ``%`` before any of the characters ``^$()%|,.[]*+-?`` to match
that character.
+ The ``all_formats`` script option accepts a boolean 'yes' or 'no',
+ and if 'yes' will attempt to add all formats found reported by youtube-dl
+ (default: no). Each format is added as a separate track. In addition, they
+ are delay-loaded, and actually opened only when a track is selected (this
+ should keep load times as low as without this option). It also adds average
+ bitrate metadata, if available, which means ``--hls-bitrate`` will decide
+ which track to select. (HLS used to be the only format whose alternative
+ quality streams were exposed in a similar way, thus the option name.) The
+ ``--ytdl-format`` option is essentially ignored. Although this mechanism
+ makes it possible to switch streams at runtime, it's not suitable for this
+ purpose for various technical reasons. In general, this option is not
+ useful, and was only added to show that it's possible.
+
.. admonition:: Examples
- ``--script-opts=ytdl_hook-exclude='^youtube%.com'``
@@ -837,6 +850,10 @@ Program Behavior
formats like HLS and DASH, if available, allowing for video/audio selection
in runtime. It's disabled ("no") by default for performance reasons.
+ .. admonition:: Why do the option names mix ``_`` and ``-``?
+
+ I have no idea.
+
``--ytdl-format=<ytdl|best|worst|mp4|webm|...>``
Video format/quality that is directly passed to youtube-dl. The possible
values are specific to the website and the video, for a given url the