diff options
author | wm4 <wm4@nowhere> | 2020-02-19 16:33:48 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2020-02-19 16:33:48 +0100 |
commit | 6d8b4ca742d931634be19fb01d4310d7b7fb8de0 (patch) | |
tree | 9c97db4e42a8c181992b2172b08dbd339d3de61b /DOCS/man/options.rst | |
parent | 43c13e5ea23230edca38426d4a9eed049a70890e (diff) | |
download | mpv-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/man/options.rst')
-rw-r--r-- | DOCS/man/options.rst | 17 |
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 |