Copied to clipboard!
youtube-dl URLS
# Main
| Command | Input | Description |
|---|---|---|
| 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 Config | Do not read configuration files. More Info | |
| Config File Location | Location of the configuration file. More Info |
# Download
| Command | Input | Description |
|---|---|---|
| Limit Rate | Max download rate in bytes per second. 'K' suffix for Kilobytes, ‘M’ suffix for Megabytes. More Info | |
| Retries | Number of retries. Default: 10. "infinite" is also an option. More Info | |
| Buffer Size | Size of download buffer. Default: 1024. More Info | |
| No Buffer Resize | Do not automatically adjust the buffer size. More Info | |
No .part Files | Do not use .part files. Write directly to output file. More Info | |
| Use Native HLS Downloader | Use the native HLS downloader instead of FFmpeg. More Info | |
| Use FFMPEG | Use FFmpeg instead of native HLS downloader. Recommend: Use with FFmpeg Location option. More Info | |
| Playlist Reversed | Download playlist videos in reverse order. More Info | |
| Playlist Random | Download playlist videos in random order. More Info | |
| Include Ads | Download advertisements along with video. Experimental! More Info |
# Video Selection
| Command | Input | Description |
|---|---|---|
| Start of Playlist | Playlist video to start at. Default: 1. More Info | |
| End of Playlist | Playlist video to end at. Default: last. More Info | |
| Playlist Items | Playlist 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 Download | Abort 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 Before | Download only videos uploaded on or before this date (inclusive). Format Info | More Info | |
| Date | Download only videos uploaded on this date. Format Info | More Info | |
| Date After | Download 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 |
| Playlist Video Only | Download only the video, if the URL refers to a video and a playlist. More Info | |
| Playlist Only | Download only the playlist, if the URL refers to a video and a playlist. More Info | |
| Age Limit | Download only videos suitable for the given age. More Info |
# Video Format
| Command | Input | Description |
|---|---|---|
| Format Selection | Control how to format the downloaded video/audio. USES FORMAT. Format Info | |
| All Formats | Download all available video formats. More Info | |
| Prefer Free Formats | Prefer video formats with free containers over non-free ones. More Info |
# Post-processing
| Command | Input | Description |
|---|---|---|
| Convert to Audio | Convert video files to audio files. More Info | |
| Audio Format | Audio format to convert the audio to. MUST use with 'Convert to Audio'. More Info | |
| Re-encode Video | Encode video to another format. Uses FORMAT. Supported: mp4|flv|ogg|webm|mkv|avi. More Info | |
| Audio Quality | Specify audio quality. RANGE: 0 (better) to 9 (worse) for VBR. More Info | |
| Embed Subtitles | Embed subtitles in videos. Only for mp4, webm, and mkv files. More Info | |
| Embed Thumbnail | Embed thumbnail in the audio as cover art. More Info | |
| Add Metadata | Write metadata to the video file. More Info | |
| Prefer Avconv | Prefer avconv over FFmpeg for running post-processing. More Info | |
| Ffmpeg Location | Location of FFMPEG. Recommend: Use with Use FFMPEG option. More Info | |
| Convert Subtitles | Convert subtitles to other formats. More Info | |
| Keep Video | Keep the video file on disk after post-processing. More Info |
# File System
| Command | Input | Description |
|---|---|---|
| File of URLs | File containing URLS to download. One URL per line. More Info | |
| Don't Continue | Do not resume partially downloaded files. Default: continue. More Info | |
| Remove Filesystem Cache | Deletes all filesystem cache. More Info | |
| Save File Location(s) | Customize the output of downloaded files. USES TEMPLATE. Template Info | |
| Auto Start Number | Specify the start value for %(autonumber)s. Default: 1. More Info | |
| Don't Overwrite Files | Do not overwrite files. More Info |
# Distinct Player
| Command | Input | Description |
|---|---|---|
| Prefer Insecure | Use an unencrypted connection to retrieve information about the video. (YouTube). More Info | |
| Skip DASH Manifest | Do not download the DASH manifests and related data on YouTube videos. (YouTube). More Info | |
| Write Automatic Subtitle | Write automatically generated subtitle file. (YouTube). More Info | |
| Video Password | Languages of subtitles to download, separated by commas if more than one. (Vimeo, Youku) More Info |
# Work Around
| Command | Input | Description |
|---|---|---|
| Don't Check Certificate | Suppress 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 [Multi] | Specify a custom HTTP header and its value, separated by a :. More Info |
# Thumbnail Images
| Command | Input | Description |
|---|---|---|
| Write Thumbnail | Write thumbnail image to disk. More Info | |
| Write All Thumbnails | Write all thumbnail image formats to disk. More Info |
# Subtitles & Authentication
| Command | Input | Description |
|---|---|---|
| Write Subs | Write subtitle file. More Info | |
| Download All Subs | Download all available subtitles. More Info | |
| Cookies | The file to read cookies from. Use this to download private videos from your account. More Info | |
| Subtitle Format | Subtitle format. Use --list-subs for a list of all available subtitles. Format Info | More Info | |
| Subtitle Language | Languages 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
| Command | Input | Description |
|---|---|---|
| Last-modified Header | Do not use the Last-modified header to set the file modification time. More Info | |
| Write Info | Write video metadata to a .info.json file. More Info | |
| Write Video Description | Write video descriptions to a .description file. More Info | |
| Write Annotations | Write video annotations to a .annotations.xml file. More Info |