Skip to main content

​
Basic Authentication

​
-u, --username
string
Login with this account IDExample:
yt-dlp -u myusername URL
​
-p, --password
string
Account passwordIf this option is left out, yt-dlp will ask interactivelyExample:
yt-dlp -u myusername -p mypassword URL
​
-2, --twofactor
string
Two-factor authentication codeExample:
yt-dlp -u myusername -p mypassword -2 123456 URL

​
Netrc Authentication

​
-n, --netrc
flag
Use .netrc authentication dataSee “Authentication with netrc” for more details
​
--netrc-location
string
Location of .netrc authentication data; either the path or its containing directoryDefaults to ~/.netrcExample:
yt-dlp --netrc-location ~/.config/netrc URL
​
--netrc-cmd
string
Command to execute to get the credentials for an extractorExample:
yt-dlp --netrc-cmd 'gpg --decrypt ~/.authinfo.gpg' URL

​
Video-Specific Password

​
--video-password
string
Video-specific passwordExample:
yt-dlp --video-password secret123 URL

​
Adobe Pass Authentication

​
--ap-mso
string
Adobe Pass multiple-system operator (TV provider) identifierUse --ap-list-mso for a list of available MSOsExample:
yt-dlp --ap-mso Verizon URL
​
--ap-username
string
Multiple-system operator account login
​
--ap-password
string
Multiple-system operator account passwordIf this option is left out, yt-dlp will ask interactively
​
--ap-list-mso
flag
List all supported multiple-system operators

​
Client Certificate Authentication

​
--client-certificate
string
Path to client certificate file in PEM formatMay include the private keyExample:
yt-dlp --client-certificate /path/to/cert.pem URL
​
--client-certificate-key
string
Path to private key file for client certificateExample:
yt-dlp --client-certificate cert.pem --client-certificate-key key.pem URL
​
--client-certificate-password
string
Password for client certificate private key, if encryptedIf not provided, and the key is encrypted, yt-dlp will ask interactively