Copied to clipboard!
yt-dlp URLS
# Main
| Command | Input | Description |
|---|---|---|
| Create URL File | Write an internet shortcut file, depending on the current platform. More Info | |
| Configuration Location [Multi] | PATH to main configuration file(s). Config Info | More Info |
# Download
| Command | Input | Description |
|---|---|---|
| Downloader [Multi] | Name or path of the external downloader to use. More Info | |
| Downloader Args [Multi] | Arguments to provide the external downloader. More Info | |
| New! Download Sections [Multi] | Download chapters whose title matches [REGEX] or use a *[TIME RANGE] instead. More Info | |
| Playlist Reversed | Download playlist videos in reverse order. More Info | |
| Playlist Random | Download playlist videos in random order. More Info | |
No .part Files | Do not use .part files. Write directly to output file. More Info | |
| Limit Rate | Max download rate in bytes per second. 'K' suffix for Kilobytes, ‘M’ suffix for Megabytes. More Info | |
| Throttle Rate | Minimum download rate in bytes per second before throttling is assumed. '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 | |
| HTTP Chunk Size | Size of a chunk for chunk-based HTTP downloading. Experimental! More Info | |
| Concurrent Fragments | Number of fragments of a dash/hlsnative video that should be downloaded concurrently. Default: 1. More Info | |
| Max Downloads | Abort after downloading a certain number of files. More Info | |
| Abort on Error | Abort downloading of videos if an error occurs. 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 |
| Match Filter | Select videos that matches the specified filter. Filters | Output Template | 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 |
| Age Limit | Download only videos suitable for the given age. More Info | |
| Playlist Skips | Number of failures allowed before the rest of the playlist is skipped. 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 |
# Video Format
| Command | Input | Description |
|---|---|---|
| Format Selection | Control how to format the downloaded video/audio. USES FORMAT. Default: bestvideo*+bestaudio/best. Format Info | More Info | |
| Format Sorting | Sort formats by a certain criteria. Sorting | More 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 | |
| Merge Multiple Video Streams | Allow multiple video streams to be merged into a single file. More Info | |
| Merge Multiple Audio Streams | Allow multiple audio streams to be merged into a single file. More Info | |
| Merge Output Format | If a merge is required (Ex: bestvideo+bestaudio) output to a given container format. 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|mkv|flv|webm|mov|avi|mp3|mka|m4a|ogg|opus. More Info | |
| Re-mux Video | Remux the video into another container. Uses FORMAT. Supported: mp4|mkv|flv|webm|mov|avi|mp3|mka|m4a|ogg|opus. More Info | |
| Audio Quality | Specify audio quality. RANGE: 0 (better) to 10 (worse) for VBR. Default: 5.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 | |
| 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 | |
| Disable Caching | Disable filesystem caching. More Info | |
| Save File Location [Multi] | The path(s) where the files should be downloaded. Examples | More Info | |
| Custom Filename [Multi] | Customize the filename of downloaded files. Template Info | Examples | |
| Restrict Filename to ASCII | Restrict filenames to only ASCII characters, and avoid "&" and spaces. More Info | |
| Windows Filenames | Force filenames to be Windows-compatible. More Info | |
| Limit Filename | Limit the filename to a specified number of characters. More Info | |
| Don't Overwrite Files | Do not overwrite any files. More Info |
# Distinct Player
| Command | Input | Description |
|---|---|---|
| Download Livestreams | Download livestreams from start. (YouTube). Experimental! More Info | |
| 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 | |
| Video Password | Languages of subtitles to download, separated by commas if more than one. (Vimeo, Youku) More Info |
# Work Around
| Command | Input | Description |
|---|---|---|
| User Agent | Specify a custom user agent. More Info | |
| Custom Header [Multi] | Specify a custom HTTP header and its value, separated by a :. 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 | |
| Don't Check Certificates | Suppress HTTPS certificate validation. More Info | |
| Legacy Connection | Allow HTTPS connection to servers that do not support RFC 5746 secure renegotiation. More Info | |
| Sleep Subtitles | Number of seconds to sleep before each subtitle download. 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 | |
| Write Auto Subs | Write automatically generated subtitle file. More Info | |
| Subtitle Format | Subtitle format. Use --list-subs for a list of all available subtitles. Format Info | More Info | |
| Subtitle Languages | Languages of subtitles to download, separated by commas if more than one. Can also use all. More Info | |
| Cookies | The file to read cookies from. Use this to download private videos from your account. More Info | |
| Use Browser Cookies | Extract cookies from a web browser. FORMAT: BROWSER[+KEYRING][:PROFILE]. More Info |
# Metadata
| Command | Input | Description |
|---|---|---|
| Modify Metadata [Multi] | Parse additional metadata from other fields. Modify Metadata | More Info | |
| Replace Metadata [Multi] | Replace text in any metadata field. Modify Metadata | More Info | |
| Embed Metadata | Embed metadata to the video file. More Info | |
| Embed Chapters | Add chapter markers to the video file. More Info | |
| 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 | |
Don't Clean .info.json | Write all fields to the .info.json file. Use with Write Info. More Info | |
| Write Video Description | Write video descriptions to a .description file. More Info | |
| Write Comments | Retrieve video comments to be placed in the .info.json file. More Info |
# SponsorBlock
| Command | Input | Description |
|---|---|---|
| Mark Chapters | Create chapters for SponsorBlock categories. Use commas to separate categories. Category Descriptions | More Info | |
| Remove Categories | Remove SponsorBlock categories from video file. Use commas to separate categories. Category Descriptions | More Info | |
| API Location | SponsorBlock API location. Default: https://sponsor.ajay.app. More Info | |
| Disable SponsorBlock | Disable SponsorBlock. More Info |
# Extractor
| Command | Input | Description |
|---|---|---|
| Extractor Args [Multi] | Arguments to pass to the extractor. Arguments | More Info | |
| Retries | Number of retries for extractor errors. Accepts: infinite & [NUMBER]. More Info | |
| Ignore Dynamic DASH Manifest | Do not process dynamic DASH manifests. More Info | |
| HLS Split Discontinuity | Split HLS playlists to different formats at discontinuities such as ad breaks. More Info |