1

youtube-dl 

URLS


# Main

CommandInputDescription
Error DownloadingContinue/Abort downloading when an error occurs. For example if ignored is active, unavailable videos in a playlist will be skipped instead. More Info
Ignore ConfigDo not read configuration files. More Info
Config File LocationLocation of the configuration file. More Info

# Download

CommandInputDescription
Limit RateMax download rate in bytes per second. 'K' suffix for Kilobytes, ‘M’ suffix for Megabytes. More Info
RetriesNumber of retries Default: 10. "infinite" is also an option. More Info
Buffer SizeSize of download buffer. Default: 1024. More Info
No Buffer ResizeDo not automatically adjust the buffer size. More Info
Use Native HLS DownloaderUse the native HLS downloader instead of FFmpeg. More Info
Use FFMPEGUse FFmpeg instead of native HLS downloader. Recommend to use with FFmpeg Location option. More Info
Playlist ReversedDownload playlist videos in reverse order. More Info
Playlist RandomDownload playlist videos in random order. More Info
Include AdsDownload advertisements along with video. Experimental! More Info

# Video Selection

CommandInputDescription
Start of PlaylistPlaylist video to start at. Default: 1. More Info
End of PlaylistPlaylist video to end at. Default: last. More Info
Playlist ItemsPlaylist video items to download. Ex: '1-3,6' downloads videos 1 through 3. Also the 6th video. More Info
Match/Reject Titles

Match:

Reject:

Download/skip matching titles. USES REGEX. More Info
Max To DownloadAbort after downloading a certain number of files. More Info
Min/Max File Size

Min:

Max:

Do not download any videos smaller/larger than a certain size. ‘k’ suffix for Kilobytes, ‘m’ suffix for Megabytes. More Info
Date BeforeDownload only videos uploaded on or before this date (inclusive). Format Info | More Info
DateDownload only videos uploaded on this date. Format Info | More Info
Date AfterDownload only videos uploaded on or after this date (inclusive). Format Info | More Info
Min/Max Views

Min:

Max:

Do not download any videos with less/more than a certain amount of views. More Info
No PlaylistDownload only the video, not the playlist. More Info
Age LimitDownload only videos suitable for the given age. More Info

# Video Format

CommandInputDescription
Format SelectionControl how to format the downloaded video/audio. USES FORMAT. Format Info
All FormatsDownload all available video formats. More Info
Prefer Free FormatsPrefer free video formats. More Info

# Post-processing

CommandInputDescription
Convert to AudioConvert video files to audio files. More Info
Audio FormatSpecify audio format: best, aac, flac, mp3, m4a, opus, vorbis, orwav. Default: best; MUST use 'Convert to Audio'. More Info
Recode VideoEncode video to another [Format]. More Info
Audio QualitySpecify audio quality. Insert a value between 0 (better) and 9 (worse) for VBR. More Info
Embed SubtitlesEmbed subtitles in videos. Only for mp4, webm, and mkv files. More Info
Embed ThumbnailEmbed thumbnail in the audio as cover art. More Info
Add MetadataWrite metadata to the video file. More Info
Prefer AvconvPrefer avconv over FFmpeg for running post-processing. More Info
Ffmpeg LocationLocation of FFmpeg. More Info
Convert SubtitlesConvert subtitles to other formats. Formats: srt, ass, vtt, lrc. More Info
Keep VideoKeep the video file on disk after post-processing. More Info

# File System

CommandInputDescription
File of URLSFile containing URLS to download. One URL per line. More Info
Don't ContinueDo not resume partially downloaded files Default: continue.More Info
Remove Filesystem CacheDeletes all filesystem cache. More Info
Save File Location(s)Customize the output of downloaded files. USES TEMPLATE. Template Info
Write InfoWrite video metadata to a .info.json file. More Info
Write AnnotationsWrite video annotations to a .annotations.xml file. More Info
Write Video DescriptionWrite video descriptions to a .description file. More Info
Auto Start NumberSpecify the start value for %(autonumber)s. Default: 1. More Info

# Distinct Player

CommandInputDescription
Prefer InsecureUse an unencrypted connection to retrieve information about the video. (YouTube). More Info
Skip DASH ManifestDo not download the DASH manifests and related data on YouTube videos. (YouTube). More Info
Write Automatic SubtitleWrite automatically generated subtitle file. (YouTube). More Info
Video PasswordLanguages of subtitles to download, separated by commas if more than one. (Vimeo, Youku) More Info

# Work Around

CommandInputDescription
Don't Check CertificateSuppress HTTPS certificate validation. More Info
User Agent Specify a custom user agent. More Info
Sleep Interval Number of seconds to sleep before each download. If used with Max Sleep Interval this is the lower bound. More Info
Max Sleep Interval Maximum number of seconds to sleep. Must be used with Sleep Interval. More Info
Geo Bypass Force bypass geographic restriction by providing the ISO Country Code. More Info
Custom Header
Specify a custom HTTP header and its value, separated by a :. More Info

# Thumbnail Images

CommandInputDescription
Write ThumbnailWrite thumbnail image to disk. More Info
Write All ThumbnailsWrite all thumbnail image formats to disk. More Info

# Subtitles & Authentication

CommandInputDescription
Write SubsWrite subtitle file. More Info
Download All SubsDownload all available subtitles. More Info
CookiesThe file to read cookies from. Use this to download private videos from your account. More Info
Subtitle FormatSubtitle format. Use --list-subs for a list of all available subtitles. Format Info | More Info
Subtitle LanguageLanguages of subtitles to download, separated by commas if more than one. Use --list-subs for a list of all available language tags. More Info