From 6d8b4ca742d931634be19fb01d4310d7b7fb8de0 Mon Sep 17 00:00:00 2001 From: wm4 Date: Wed, 19 Feb 2020 16:33:48 +0100 Subject: 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. --- DOCS/man/options.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'DOCS/man') 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=`` 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 -- cgit v1.2.3