{{Header}}
{{#seo:
|description=Using the yt-dlp command line downloader.
|image=Youtubedownload.png
}}
{{title|title=
yt-dlp YouTube Video Downloader in {{project_name_long}}
}}
<div class="mininav">
* [[YouTube|Watching YouTube Videos in {{project_name_short}}]]
* [[yt-dlp|Downloading YouTube Videos in {{project_name_short}}]]
</div>
[[File:Yt-dlp.svg|thumb|<code>yt-dlp</code> logo]]
{{intro|
<code>yt-dlp</code> is a command-line program to download videos from YouTube.com and a few more sites.

<code>yt-dlp</code> is a software fork of <code>youtube-dl</code>.
}}
= Introduction =
<code>yt-dlp</code> is simple to use in {{project_name_short}}. Simply follow the instructions to install it below, identify the relevant YouTube video URL, then run the application in a terminal to download the video. Once it has finished downloading, VLC Media Player (installed by default) can be used to view the video.

= Installation =

The {{project_name_short}} wiki normally recommends that additional software is {{kicksecure_wiki
|wikipage=Install_Software#Install_from_Debian_stable
|text=Installed from Debian stable
}}, but in the case of <code>yt-dlp</code> there is often a significant difference between the stable and backports versions. Since the developers frequently update the software to address broken functionality when attempting downloads from various websites, an upgrade of <code>yt-dlp</code> from Debian backports may be required.

{{Install Backport|package=
yt-dlp
}}

Pip? If the user knows that python pip is, see footnote. Otherwise ignore this. <ref>
Pip cannot be recommended without disclaimer. {{kicksecure_wiki
|wikipage=Install_Software#Best_Practices
|text=Avoid Third Party Package Manager
}}
</ref>

= Usage =

First identify the relevant YouTube video URL in Tor Browser, then right-click the link and select "Copy Link Location". In the example below it is "Why Do so Many People Hate Windows 10?" (https://youtube.com/watch?v=KpEb8M23LsU)

'''Figure:''' ''Example YouTube Video to Download''

[[File:Whyhatewindows10.png]]

Next, open a terminal. To download the relevant YouTube video, run.

Note: Replace <code>link-to-video</code> with the chosen URL.

{{CodeSelect|code=
yt-dlp link-to-video
}}

Finally, open VLC Media Player and select the relevant file to play: <code><u>M</u>edia</code> &rarr; <code><u>O</u>pen File...</code> &rarr; <code>Open the video file</code>

'''Figure:''' ''VLC Media Player''

[[File:Youtubedownloadinvlc.png]]

[https://github.com/ytdl-org/youtube-dl/blob/master/README.md Extensive documentation] is available describing a host of possible options, including:
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* general options
* network options
* geo restriction
* video selection
* download options
* filesystem options
* thumbnail images
* verbosity/simulation options
* workarounds
* video format options
* subtitle options
* authentication options
* Adobe pass options
* post-processing options
</div>

In addition the documentation describes numerous configuration settings, output templates, format selection and video selection among other topics. Many readers will be interested in how to select preferred video quality; see [https://askubuntu.com/questions/486297/how-to-select-video-quality-from-yt-dlp here] for a quick overview.

= Alternatives =
* [[YouTube#Invidious|Invidious]]

= See Also =
* [[YouTube|Watching YouTube Videos in {{project_name_short}}]]

= Footnotes =
{{reflist|close=1}}

{{Footer}}

[[Category:Documentation]]