diff options
Diffstat (limited to 'network/youtube-dl/youtube-dl.1')
| -rw-r--r-- | network/youtube-dl/youtube-dl.1 | 38 |
1 files changed, 37 insertions, 1 deletions
diff --git a/network/youtube-dl/youtube-dl.1 b/network/youtube-dl/youtube-dl.1 index 73ae62c2f7..b52c7a8480 100644 --- a/network/youtube-dl/youtube-dl.1 +++ b/network/youtube-dl/youtube-dl.1 @@ -103,6 +103,11 @@ Do not mark videos watched (YouTube only) Do not emit color codes in output .RS .RE +.TP +.B \-\-abort\-on\-unavailable\-fragment +Abort downloading when some fragment is not available +.RS +.RE .SS Network Options: .TP .B \-\-proxy \f[I]URL\f[] @@ -272,7 +277,12 @@ Number of retries (default is 10), or "infinite". .TP .B \-\-fragment\-retries \f[I]RETRIES\f[] Number of retries for a fragment (default is 10), or "infinite" (DASH -only) +and hlsnative only) +.RS +.RE +.TP +.B \-\-skip\-unavailable\-fragments +Skip unavailable fragments (DASH and hlsnative only) .RS .RE .TP @@ -1663,6 +1673,32 @@ Each subsequent run will only download new videos if any: youtube\-dl\ \-\-download\-archive\ archive.txt\ "https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re" \f[] .fi +.SS Should I add \f[C]\-\-hls\-prefer\-native\f[] into my config? +.PP +When youtube\-dl detects an HLS video, it can download it either with +the built\-in downloader or ffmpeg. +Since many HLS streams are slightly invalid and ffmpeg/youtube\-dl each +handle some invalid cases better than the other, there is an option to +switch the downloader if needed. +.PP +When youtube\-dl knows that one particular downloader works better for a +given website, that downloader will be picked. +Otherwise, youtube\-dl will pick the best downloader for general +compatibility, which at the moment happens to be ffmpeg. +This choice may change in future versions of youtube\-dl, with +improvements of the built\-in downloader and/or ffmpeg. +.PP +In particular, the generic extractor (used when your website is not in +the list of supported sites by +youtube\-dl (http://rg3.github.io/youtube-dl/supportedsites.html) cannot +mandate one specific downloader. +.PP +If you put either \f[C]\-\-hls\-prefer\-native\f[] or +\f[C]\-\-hls\-prefer\-ffmpeg\f[] into your configuration, a different +subset of videos will fail to download correctly. +Instead, it is much better to file an issue (https://yt-dl.org/bug) or a +pull request which details why the native or the ffmpeg HLS downloader +is a better choice for your use case. .SS Can you add support for this anime video site, or site which shows current movies for free? .PP |