ytdl-org/youtube-dl

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/ytdl-org/youtube-dl.svg?style=card)](https://bestofgithub.dev/repo/ytdl-org/youtube-dl)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/ytdl-org/youtube-dl.svg)](https://bestofgithub.dev/repo/ytdl-org/youtube-dl)

Loading README…

INSTALLATION

DESCRIPTION

OPTIONS

Network Options:

Geo Restriction:

Video Selection:

Download Options:

Filesystem Options:

Thumbnail Options:

Verbosity / Simulation Options:

Workarounds:

Video Format Options:

Subtitle Options:

Authentication Options:

Adobe Pass Options:

Post-processing Options:

CONFIGURATION

Authentication with .netrc file

OUTPUT TEMPLATE

Output template and Windows batch files

Output template examples

FORMAT SELECTION

Format selection examples

VIDEO SELECTION

FAQ

How do I update youtube-dl?

youtube-dl is extremely slow to start on Windows

I'm getting an error Unable to extract OpenGraph title on YouTube playlists

I'm getting an error when trying to use output template: error: using output template conflicts with using title, video ID or auto number

Do I always have to pass -citw?

Can you please put the -b option back?

I get HTTP error 402 when trying to download a video. What's this?

Do I need any other programs?

I have downloaded a video but how can I play it?

I extracted a video URL with -g, but it does not play on another machine / in my web browser.

ERROR: no fmt_url_map or conn information found in video info

ERROR: unable to download video

Video URL contains an ampersand and I'm getting some strange output [1] 2839 or 'v' is not recognized as an internal or external command

ExtractorError: Could not find JS function u'OF'

HTTP Error 429: Too Many Requests or 402: Payment Required

SyntaxError: Non-ASCII character

What is this binary file? Where has the code gone?

The exe throws an error due to missing MSVCR100.dll

On Windows, how should I set up ffmpeg and youtube-dl? Where should I put the exe files?

How do I put downloads into a specific folder?

How do I download a video starting with a -?

How do I pass cookies to youtube-dl?

How do I stream directly to media player?

How do I download only new videos from a playlist?

Should I add --hls-prefer-native into my config?

Can you add support for this anime video site, or site which shows current movies for free?

How can I speed up work on my issue?

How can I detect whether a given URL is supported by youtube-dl?

Why do I need to go through that much red tape when filing bugs?

DEVELOPER INSTRUCTIONS

Adding support for a new site

youtube-dl coding conventions

Mandatory and optional metafields

Example

Provide fallbacks

Example

Regular expressions

Don't capture groups you don't use

Example

Make regular expressions relaxed and flexible

Example

Long lines policy

Inline values

Example

Collapse fallbacks

Example

Trailing parentheses

Example

Use convenience conversion and parsing functions

More examples

Safely extract optional description from parsed JSON

Safely extract more optional metadata

Safely extract nested lists

EMBEDDING YOUTUBE-DL

BUGS

Authentication with `.netrc` file

I'm getting an error `Unable to extract OpenGraph title` on YouTube playlists

I'm getting an error when trying to use output template: `error: using output template conflicts with using title, video ID or auto number`

Do I always have to pass `-citw`?

Can you please put the `-b` option back?

I extracted a video URL with `-g`, but it does not play on another machine / in my web browser.

Video URL contains an ampersand and I'm getting some strange output `[1] 2839` or `'v' is not recognized as an internal or external command`

The exe throws an error due to missing `MSVCR100.dll`

How do I download a video starting with a `-`?

Should I add `--hls-prefer-native` into my config?