# Main

Error Downloading
Continue/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

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
No .part FilesDo not use .part files. Write directly to output file. More Info
Use Native HLS DownloaderUse the native HLS downloader instead of FFmpeg. More Info
Use FFMPEGUse FFmpeg instead of native HLS downloader. Recommend: 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

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



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



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



Do not download any videos with less/more than a certain amount of views. More Info
Playlist Video OnlyDownload only the video, if the URL refers to a video and a playlist. More Info
Playlist OnlyDownload only the playlist, if the URL refers to a video and a playlist. More Info
Age LimitDownload only videos suitable for the given age. More Info

# Video Format

Format SelectionControl how to format the downloaded video/audio. USES FORMAT. Format Info
All FormatsDownload all available video formats. More Info
Prefer Free FormatsPrefer video formats with free containers over non-free ones. More Info

# Post-processing

Convert to AudioConvert video files to audio files. More Info
Audio FormatAudio format to convert the audio to. MUST use with 'Convert to Audio'. More Info
Re-encode VideoEncode video to another format. Uses FORMAT. Supported: mp4|flv|ogg|webm|mkv|avi. More Info
Audio QualitySpecify audio quality. RANGE: 0 (better) to 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. Recommend: Use with Use FFMPEG option. More Info
Convert SubtitlesConvert subtitles to other formats. More Info
Keep VideoKeep the video file on disk after post-processing. More Info

# File System

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
Auto Start NumberSpecify the start value for %(autonumber)s. Default: 1. More Info
Don't Overwrite FilesDo not overwrite files. More Info

# Distinct Player

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

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

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

# Subtitles & Authentication

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

# Metadata

Last-modified HeaderDo not use the Last-modified header to set the file modification time. More Info
Write InfoWrite video metadata to a .info.json file. More Info
Write Video DescriptionWrite video descriptions to a .description file. More Info
Write AnnotationsWrite video annotations to a .annotations.xml file. More Info