Concurrent Downloads
Number of fragments of a dash/hlsnative video that should be downloaded concurrentlyExample:
Rate Limiting
Maximum download rate in bytes per secondExample:
Minimum download rate in bytes per second below which throttling is assumed and the video data is re-extractedExample:
Retry Configuration
Number of retries, or “infinite”Example:
Number of times to retry on file access error, or “infinite”
Number of retries for a fragment, or “infinite” (DASH, hlsnative and ISM)
Time to sleep between retries in seconds (optionally) prefixed by the type of retryFormat:
[TYPE:]EXPRTypes: http (default), fragment, file_access, extractorEXPR can be:- A number
linear=START[:END[:STEP=1]]exp=START[:END[:BASE=2]]
Fragment Handling
Skip unavailable fragments for DASH, hlsnative and ISM downloadsAlias:
--no-abort-on-unavailable-fragmentsAbort download if a fragment is unavailableAlias:
--no-skip-unavailable-fragmentsKeep downloaded fragments on disk after downloading is finished
Delete downloaded fragments after downloading is finished
Buffer Configuration
Size of download bufferExample:
The buffer size is automatically resized from an initial value of
--buffer-sizeDo not automatically adjust the buffer size
Size of a chunk for chunk-based HTTP downloadingMay be useful for bypassing bandwidth throttling imposed by a webserver (experimental)Default is disabled.Example:
Playlist Options
Download playlist videos in random order
Process entries in the playlist as they are receivedThis disables
n_entries, --playlist-random and --playlist-reverseProcess videos in the playlist only after the entire playlist is parsed
HLS Options
Use the mpegts container for HLS videosAllows some players to play the video while downloading, and reduces the chance of file corruption if download is interrupted.This is enabled by default for live streams.
Do not use the mpegts container for HLS videosThis is default when not downloading live streams.
Download Sections
Download only chapters that match the regular expression
- A ”*” prefix denotes time-range instead of chapter
- Negative timestamps are calculated from the end
- “*from-url” can be used to download between the “start_time” and “end_time” extracted from the URL
External Downloader
Name or path of the external downloader to use (optionally) prefixed by the protocols to use it forFormat:
[PROTO:]NAMEProtocols: http, ftp, m3u8, dash, rstp, rtmp, mmsSupported downloaders: native, aria2c, axel, curl, ffmpeg, httpie, wgetYou can use this option multiple times to set different downloaders for different protocols.Alias: --external-downloaderExample:Give these arguments to the external downloaderFormat:
NAME:ARGSSpecify the downloader name and the arguments separated by a colon ”:”. For ffmpeg, arguments can be passed to different positions using the same syntax as --postprocessor-args.You can use this option multiple times to give different arguments to different downloaders.Alias: --external-downloader-argsExample: