How to Use YT-DLP: The Complete Guide (2024)

Audio Version (Press Play & Scroll Seamlessly Through the Article ▶️🎶)

In this YT-DLP guide (2024), we will explore what yt-dlp is and how to download and install it on your Windows or Linux machine. We’ll also cover the necessary dependencies, including FFmpeg, and walk through how to use yt-dlp to download videos.


Disclaimer: This material has been developed strictly for informational purposes. It does not constitute endorsement of any activities (including illegal activities), products or services. You are solely responsible for complying with the applicable laws, including intellectual property laws, when using our services or relying on any information herein. We do not accept any liability for damage arising from the use of our services or information contained herein in any manner whatsoever, except where explicitly required by law.

Table of Contents. 

  1. What is yt-dlp?
  2. How to download and install YT-DLP?
  3. Installing Dependencies: FFmpeg and FFProbe
  4. How to use YT-DLP in Windows and Linux. 
  5. Advanced uses for Plugin yt-dlp. 
  6. yt-dlp: Pros and Cons
  7. FAQ: yt-dlp
  8. Final Words. 

1. What is yt-dlp?

YT-DLP is a free and open-source software project created (as a fork) from the now-discontinued project, youtube-dlc. yt-dlp is based on the popular YouTube downloader, youtube-dlc, but now comes with additional features and improvements. This software is basically used to download videos from YouTube, Vimeo, and other similar websites. 

Downloading and installing yt-dlp is relatively easy, but learning how to use it properly, can take some time. YT-DLP is a command-line tool used on Windows, macOS, and Linux operating systems. Having no “beautiful” front-end GUI puts many people off, yet it is the most potent youtube downloader available. 

What are YT-DLP’s main features? 

  1. Network Options: Change how yt-dlp communicates with the network. This includes options such as setting a proxy, adjusting the timeout value, and specifying the user agent string.
  2. Bypass Geo Restriction: This feature allows you to bypass geographical restrictions that may prevent you from accessing specific videos based on location. You can use yt-dlp options with a VPN or a proxy to get around these restrictions.
  3. Video Selection: With yt-dlp, you can select the videos you want to download from a playlist or channel. In addition, you can also download entire playlists and channels. 
  4. Download Options: This feature allows you to control the downloading process. You can, for example, choose to download only audio, only video, or both. You can also set the video quality and download speed limits.
  5. Filesystem Options: With this feature, you can specify the output directory and filename templates for downloaded videos.
  6. Thumbnail Images: Download thumbnail images for videos along with the video itself. You can even specify the image format and size.
  7. Workarounds: This feature provides various workarounds for issues arising during the download process. For example, you can use the –no-check-certificate option to bypass SSL certificate verification. 
  8. Automatic retries for failed downloads. By default, yt-dlp will make three attempts to download a video before giving up and moving on to the next one. You can also configure this number of retries.
  9. Video Format Options: Yt-dlp lets you choose the video format you want to download, such as MP4, WebM, or FLV. You can also set the video quality and resolution.
  10. Subtitle Features: This yt-dlp option allows you to download subtitles (embed them) along with the video. You can specify the subtitle format and language.
  11. Authentication Options: Authenticate with certain websites, such as YouTube or Vimeo. You can use options such as username and password or API key to authenticate.
  12. Post-processing Options: Perform various post-processing tasks on downloaded videos, such as merging or splitting video files, adding metadata, or converting the video to a different format.
  13. Integrates with SponsorBlock: This feature enables you to mark/remove sponsor sections in YouTube videos through the SponsorBlock API.

2. How to download and install YT-DLP?

  • Go to yt-dlp official GitHub repository:
  • Scroll down to the bottom of the page, where the download button is visible. This internal (anchor) link will take you to:
downloading and installing Yt-dlp
Photo by Github
  • On this installation page, scroll down and find the latest release files. Locate the executable files, yt-dlp (zip import binary recommended for Linux or BSD), yt-dlp.exe (for Windows), or yt-dlp_macOS (for Windows). If your OS does not support any of these release files, scroll down on this page ‘alternatives’ to find more options. 
  • Choose your platform or Operating system and download the appropriate release file. 
downloading and installing Yt-dlp
Photo by Github

a. Downloading and Installing yt-dlp on Windows.

  • For illustration purposes, we will download and run yt-dlp.exe for a Windows 2022 Server. 
  • Once downloaded, verify the size, version, and company. Take a look at the screenshot below.
downloading and installing Yt-dlp

Note: The yt-dlp.exe file is not an installer; it’s the executable file for yt-dlp itself. In the context of Windows, an executable file (with an .exe extension) is a program that can run directly once it’s clicked or executed from the command line. For yt-dlp, you simply place the yt-dlp.exe file in a directory of your choice (for instance C:\ytdlp) and run it directly from there.

b. Downloading and Installing yt-dlp in Linux (Ubuntu).

  • For illustration purposes, we will download and install the latest release of yt-dlp in Ubuntu 22.04. Ensure your Ubuntu machine is up to date. 
  • The following command downloads the latest release of the yt-dlp program from GitHub and installs it in the /usr/local/bin directory with the filename yt-dlp. 
downloading and installing Yt-dlp
  • The following  command sets the permissions of the yt-dlp file in the /usr/local/bin directory to allow all users (owner, group, and others) to read and execute the file. 
  • This command is necessary to allow users to run the yt-dlp command from the command line.
downloading and installing Yt-dlp

3. Installing Dependencies: FFmpeg and FFProbe

Before moving on with yt-dlp, it is highly recommended that you install FFmpeg and FFprobe. There are other ‘optional’ dependencies regarding the network, metadata, and miscellaneous, but FFmpeg and FFProbe are almost “mandatory”

  • FFmpeg is a multimedia framework for handling video, audio, and other multimedia files. It is used by yt-dlp to perform various multimedia operations, including merging different formats of video or audio files.  Without it, yt-dlp won’t be able to merge requested formats. For instance, you may download a 1080p video without audio. 
  • FFProbe is the command-line tool that comes with FFmpeg. FFProbe is used to analyze and extract information from multimedia files such as video and audio. Yt-dlp needs to use FFProbe to extract metadata from the multimedia files being downloaded. This metadata includes information such as the video or audio codec, the resolution, the duration, the bit rate, and other technical details about the multimedia file. Without FFprobe, yt-dlp would not be able to extract this metadata, and some of its features may not work correctly.
downloading and installing Yt-dlp's dependencies
Photo by Github
  • Before installing FFmpeg and FFProbe, ensure that your machine is up to date.

a. Installing FFmpeg and FFprobe on Linux.

To install FFmpeg on a Linux machine (Ubuntu 22.04), use the following command: 

  • To check the installation and current version, use the following command: 
downloading and installing Yt-dlp's dependencies

FFprobe installation? FFprobe comes when you install the  FFmpeg package. There is no need to do additional installation for FFprobe. To test whether FFprobe is installed, issue the “ffprobe” command:

downloading and installing Yt-dlp's dependencies

b. Installing FFmpeg and FFprobe on Windows

  • Go to and download the package (.EXE file) for Windows. Release builds are usually more stable than Git Master build, which are released more often 
  • Choose your release, download the 7z or zip file and uncrompress it. 
downloading and installing Yt-dlp's dependencies
Photo by Github
  • Download the package and save it anywhere you want.
  • We created a new folder called “PATH_Programs-ytdpl” where we will move and unzip the FFmpeg package. 
  • Under ffmpeg-(name of the file) > bin > you’ll see the three tools: ffmpeg, ffplay, and ffprobe. Move (unzip) the three applications to your new folder. 
downloading and installing Yt-dlp's dependencies
  • Record the path (for example: C:\PATH_Programs -ytdlp) and head over to “Edit the system environment variables.” This Windows utility allows you to modify the environment variables that are used by the operating system and applications running on your computer. The PATH environment variable we will define next specifies a list of directories that the operating system should search when looking for executable files.
  • To open this, go to the search bar on Windows and type “path”
downloading and installing Yt-dlp's dependencies
  • In System Properties > Advanced, head over to “Environment Variables”
downloading and installing Yt-dlp's dependencies
  • In Environment Variables, under “User variables for Administrators” choose Path (1) > then click on “Edit”. 
downloading and installing Yt-dlp's dependencies
  • The new “Edit Enviromnet variable” window will open. Click on New (1) > Enter the Path where FFmpeg is stored (2) > Click on Ok (3). 
downloading and installing Yt-dlp's dependencies
  • Now, whenever you want to run FFmpeg from any folder or location, the computer will know where it is and allow you to use it. 
  • Now, test the FFmpeg configuration from the Windows command prompt. Open the “cmd” and type ‘ffmpeg’. You should get an output such as the one below. 
downloading and installing Yt-dlp's dependencies
  • FFprobe comes with the FFmpeg installation (as you might have noticed above). To test FFprove, do the same as ffmpeg. Simply go to the command prompt and type ‘ffprobe’.

Ready to Boost Your Downloads with Seedbox?

Discover how RapidSeedbox enhances your YT-DLP experience with: Fast & Secure Downloads, Easy Streaming, Ample Storage, and 24/7 Access


4. How to use YT-DLP in Windows and Linux.

As you might already know, yt-dlp is a command-line tool, so to use it (in Windows or Linux), you will have to go through the command prompt or terminal. If you have already downloaded, and installed it along with its dependencies, go ahead and open your terminal. 

Disclaimer: Downloading videos from YouTube using tools like yt-dlp may potentially infringe upon the terms of service, copyrights, and intellectual property rights of content creators. It is important to recognize and comply with the applicable laws and regulations regarding the downloading and distribution of copyrighted material in your jurisdiction. This note does not constitute legal advice and should not be relied upon as such.

a. How to use yt-dlp in Windows? 

  • Yt-dlp runs on the command line (it has no frontend GUI). When you run it from the cmd.exe for the first time (without any arguments), you will notice an error message (such as the following): “yt-dlp.exe: error: You must provide at least one URL”
using Yt-dlp
  • Let’s go ahead and access the help menu. To see a list of all the options, use type the “yt-dlp –help” command. A menu such as the following will appear in your terminal (or command prompt):
using Yt-dlp
  • To use yt-dlp, ensure you are in the same location where yt-dlp.exe is, and use it with “yt-dlp (following the youtube URL), for instance: 
using Yt-dlp
  • Yt-dlp allows you to use arguments to empower you with more options when downloading your youtube videos. 
  • For example, you can tell yt-dlp exactly the format you want and how to download it. To do this, you might have to first find out what formats are available: Use the following command:
using Yt-dlp
  • Now, you might want to download a youtube video (i.e. with the format (-f) best quality video and best audio available (with specific format); to do this use the following command:
using Yt-dlp
  • To learn more about these arguments and how to use them properly, use the yt-dlp –help” command. 
  • And that’s it; we downloaded two youtube videos using yt-dlp.
using Yt-dlp

b. yt-dlp commands for Linux

  • Same as Windows, in Ubuntu Linux, if you type yt-dlp [without arguments] in the terminal console, you’ll get an error message. 
using Yt-dlp
  • If need to see the yt-dlp help menu, use the following command yt-dlp –help
  • If you want to download a youtube video with the best quality video and best audio available, use the following command:
using Yt-dlp

Note: If you see the following WARNING message: “You have requested merging of multiple formats (of video and audio), but FFmpeg is not installed. The formats won’t be merged.” it means that you have not yet installed FFmpeg… To learn how to install FFmpeg, go back to the section (installing FFmpeg). 

  • Now, what if you want to download a specific format for your youtube video? A useful Format command is the “-F –list-formats.” For example, we would like to list the available formats on the video > 
using Yt-dlp
  • For example, from the above output, you can see that this youtube video is available for download with video and audio at the resolutions 144p, 360p, and 720p. Now, let’s specify which format we want to download. 
  • We will use another video as an example. First (as shown before) see the available formats and then use the command “-f ‘bv*[height=…]+ba’” to specify the format. For instance, 
using Yt-dlp
  • Using the above set of commands will help you be more specific about which youtube video format you would want to download. Instead of downloading the highest (4K, for example), you can specify the audio and video format. 
  • In addition, you’ll notice that the FFmpeg WARNING message is not showing. This is because at this point, we already have installed FFmpeg correctly. 

5. Advanced uses for Plugin yt-dlp.

Below we will show you two more advanced uses for the yt-dlp plugin. We will show you these examples on Linux.  

a. Configuring the yt-dlp.conf file. 

The plugin yt-dlp also offers the option to establish a range of defaults that it will automatically implement, including a preferred video format such as mkv, mp4, webm, etc. To create a configuration file that yt-dlp can use, enter supported commands into the configuration file. The config file can be loaded from the system (/etc/yt-dlp.conf), user configuration, home configuration, portable or main configuration. 

  • Open (or create) the yt-dlp.conf from your terminal using the text editor: 
  • Or 
  • The below configuration file is an example (but you can customize it to your own preferences). Using the below configuration, yt-dlp will automatically save all videos in a particular path (/Youtube) and renames them to the Title.extension. By default, yt-dlp saves youtube videos to its default path and gives the URL as the main title. 

The configuration will also embed a thumbnail, metadata, and English subtitles. 

using Yt-dlp
  • Now let’s try our brand new yt-dlp configuration: 
using Yt-dlp

With this configuration file, you can automate your entire youtube download process. This saves you time, as you no longer have to enter configuration for each line of video download. The configuration file will use your personalized download format for the process.

Note (For Windows users): It is recommended to put this config file in “${APPDATA}/yt-dlp/config” and save it as .txt. The AppData folder is under “C:\Users\<user name>\AppData\” and is usually a hidden folder. Setting configuration lines in this config file is similar to what we did with Linux in this section.

b. Use Bashrc files. 

Another way you can optimize your download process with yt-dlp is to use bashrc files. These files contain shell (command-line interface) settings for the Bash shell. The bashrc file is executed every time a new terminal session is opened, and it can be used to configure various settings and aliases for the shell. The bashrc file can be very useful for yt-dlp, because you can use it to set up aliases or shell functions that simplify the usage of yt-dlp. For example, you can create an alias that automatically downloads a video in your preferred format and quality by typing a single command in the terminal. This can save you time and make it easier to use yt-dlp regularly.

  • To locate the .bashrc (in Ubuntu) go to home/ubunu > .bashrc
using Yt-dlp
  • Open the .bashrc with any of the following text editors. 


  • Enter the bashrc aliases for yt-dlp that you would like. For example:
using Yt-dlp
  • To activate the aliases, either close and reopen the terminal window or run the following command:
  • Now, let’s test our alias. This should make our lives easier when downloading youtube videos with yt-dlp. Use an alias; for example, by entering “ydlmp4” you are saving yourself on writing long commands such as bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best
  • There are many things happening now! As you can see from the below output… Our alias is working, the configuration is trying to embed thumbnails, subtitles, metadata, etc. Plus, the video is being saved in (and with) /Youtube/%(title)s.%(ext)s – where the title is the name of the video rather than the URL. 
using Yt-dlp

c. Manage and download large amounts of data with yt-dlp into a seedbox. 

If you download and manage large amounts of data with yt-dlp, then a seedbox can be a fantastic solution. A seedbox is a remote VPS or dedicated server designed for anonymous download and upload of digital files, such as torrents, NZBs, videos, and music. Plus, since seedboxes are designed for downloading and uploading, they usually offer high speeds. 

For instance, you can remotely connect to your seedbox and use its powerful resources to download videos with yt-dlp. Seedboxes also offer streaming platforms like Plex or Kodi and other wonderful ways to manage your media collection. Plus, if you decide later to change the format, compress, or encode, seedboxes also come with robust media converters like Handbrake. You can later download all your media content easily with FTP or Sync protocols.

This combination allows fast and efficient downloads and easy management of all your downloaded content.

6. yt-dlp: Pros and Cons

Although yt-dlp has many great features and characteristics that make it one of the best youtube downloaders, it also has a few disadvantages that you should know about. Here are some pros and cons of using yt-dlp.

a. Pros:

  • Free and open-source: yt-dlp is 100% free. It is also an open-source project maintained by a solid community of developers.
  • Multi-platform support: yt-dlp is available for Windows, Linux, and macOS. This multi-platform support makes it accessible to a wide range of users.
  • Variety of download options: Although yt-dlp is one of the best for what it does, “download youtube videos,” it also has additional options that are hard to see in other video downloaders. These download options include video format, subtitle selection, and thumbnail images.
  • Automatic retries: yt-dlp has some fantastic automation capabilities. One of the best features it that it can automatically retry failed downloads, saving you time and effort.
  • Support for more sites and extensions: yt-dlp supports more sites other than youtube, including Vimeo and Youku. It also supports browser extensions like SponsorBlock, to allow you to skip sponsored segments in YouTube videos.


  • No GUI: One turndown for many people when using yt-dlp is the lack of GUI. yt-dlp is a command-line tool, which may not be ideal for users who prefer a graphical user interface.
  • Configuration required: As you might have noticed from our step-by-step guide to configure and use yt-dlp, the tool requires some knowledge for its configuration. To use yt-dlp, you must learn the configuration lines to get the desired output format, audio quality, or other options. 
  • No official packages: yt-dlp does not have official packages for some platforms. If you have the skills and the patience to build it from a source or rely on third-party repositories, then having no official package may not disadvantage you. 
  • Legal concerns: Downloading Youtube videos is technically against their Terms of Service. So literally, the company could sue you. Still, many users decide to do so, and the company has shown no desire to penalize users for downloading their videos. However, it is still vital for you to be aware of the legal implications of downloading copyrighted material.


Q: What are the advantages of using yt-dlp over youtube-dl?

A: yt-dlp offers additional features and options not available in youtube-dl. It also has an active development community that ensures that bugs are quickly fixed and new features are added. Check our previous section: Pros & Cons.

Q: How do I install yt-dlp?

A: You can install yt-dlp on Linux, Windows, or macOS by downloading the binary executable file or by installing it via your operating system’s package manager. To learn how to install yt-dlp, go back to the “how to download and install yt-dlp” section 

Q: Can I download videos in different formats using yt-dlp?

A: Yes, you can download videos in different formats using yt-dlp. You can specify the format using command-line options or editing the configuration file.

Q: Is it legal to use yt-dlp to download Youtube videos?

A: Some content on YouTube may be copyrighted, and downloading it without permission may be illegal. Downloading videos from Youtube is against’s Youtube ToS. But still, many people do so, and Youtube has decided to take no action. 

Q: Can I download entire playlists with yt-dlp?

A: Yes, yt-dlp lets you download entire playlists by specifying the playlist’s URL.

Q: Does yt-dlp support subtitles?

A: Yes, yt-dlp supports subtitles in various formats. You can embed subtitles in your downloads and specify the preferred subtitle language.

Q: Can I download audio-only files using yt-dlp?

A: Yes, yt-dlp allows you to download audio-only files in various formats, such as MP3 and AAC.

Q: Is yt-dlp actively maintained?

A: Yes, yt-dlp is actively maintained by a team of professional developers who regularly release updates and bug fixes.

8. Final Words.

In conclusion, yt-dlp is a powerful and feature-rich video downloader. With its extensive list of options and support for various formats and video sites, it’s no wonder why yt-dlp is the leading youtube downloader platform.

If you haven’t already, we encourage you to try yt-dlp. You’ll quickly see why yt-dlp is becoming the go-to choice for downloading videos.

We suggest contacting the yt-dlp project’s maintainer on GitHub if you encounter any issues or have suggestions for new features. But if you have any questions or suggestions about this yt-dlp guide, please let us know in the comments box below.

Ready to Boost Your Downloads with Seedbox?

Discover how RapidSeedbox enhances your YT-DLP experience with: Fast & Secure Downloads, Easy Streaming, Ample Storage, and 24/7 Access


About author Diego Asturias

Avatar for Diego Asturias

Diego Asturias is a tech journalist who translates complex tech jargon into engaging content. He has a degree in Internetworking Tech from Washington DC, US, and tech certifications from Cisco, McAfee, and Wireshark. He has hands-on experience working in Latin America, South Korea, and West Africa. He has been featured in SiliconANGLE Media, Cloudbric, Pcwdld, Hackernoon, ITT Systems, SecurityGladiators, Rapidseedbox, and more.

Join 40K+ Newsletter Subscribers

Get regular updates regarding Seedbox use-cases, technical guides, proxies as well as privacy/security tips.

  1. Thank you for the article, very useful.
    There is a small error…
    “Open the .bashrc with any of the following text editors.
    sudo vi ~/.bahsrc
    sudo nano ~/.bahsrc”
    It will create a separate file that is not .bashrc

    1. Thanks for your observation, Maxime.

      If you open the .bashrc file using the sudo vi ~/.bashrc or sudo nano ~/.bashrc command, it will open the existing .bashrc file located in your home directory with root user privileges, allowing you to make changes to the file.

      But, if you accidentally save the file using a different name or in a different location, it will indeed create a new file.

      1. @Maxime is pointing-out that you have a typo in your code examples. You need to edit the post to correct those examples.

        1. Ooooh… I get you… that typo! I missed it! Thanks, JCH and Maxime!

  2. The example code snippet for downloading the best audio & video has an error.

    You have: ./yt-dlp -f “bestvideo[ext=mp4]+bestaudio[ext=m4a]”

    The correct way is: ./yt-dlp -f “bestvideo[ext=mp4]+bestaudio[ext=m4a]”

      1. There is a space between -f and “best vid…” You missed the space.

    1. 136+140 for your resolution. mp4 720p
      in my script
      $yt –add-metadata \
      –write-auto-subs \
      -f “$res” \
      -o ‘%(title)s.%(ext)s’ “$video_url”

    2. Hey there James,

      try the following:
      yt-dlp –format ‘best[height=720]’ <video_url>

  3. Hello, I am trying to download an (.mp4) audio file from MixCloud and am wondering how would you specify a “best audio” command for that?

    1. Hi there Noah!

      Have you tried the following?
      yt-dlp –format bestaudio < MixCloud_audio_url >

  4. Hi, I want to catch some video quality KPIs. Can I call and How can I get with yt-dlp?

    1. Hi there Tan.. Yt-dlp focuses on video downloads… is the best for that… but still, you can also get detailed information about the available video formats, including resolution, bitrate, codec, and file size.

      For example, if you run yt-dlp [video_url] in the command line, you would get a list of available formats along with their attributes (KPIs)..

  5. Can you add a date stamp to the file name?
    (a ten (10) character date stamp YYYYMMDDa_)


    yt-dlp –version

    Kubuntu 22.04

    yt-dlp –restrict-filenames –write-description –write-comments –write-thumbnail –write-link -P /home/x/Downloads/ https://www…./

    1. Hey there Joseph,

      You can add a date stamp to the file name in yt-dlp by using the -o option with a template that includes the date stamp in the format you are looking for (YYYYMMDDa). Here’s an example of your command with the -o option, (first check your yt-dlp version):

      yt-dlp –version
      yt-dlp –restrict-filenames -o “%(upload_date>%Y%m%d)a_%(title)s-%(id)s.%(ext)s” –write-description –write-comments –write-thumbnail –write-link -P /home/x/Downloads/ https://www…/

      Please, if you manage, let us know your results.

      1. Hello Diego,

        yt-dlp –version

        sudo yt-dlp –update

        Usage: yt-dlp [OPTIONS] URL [URL…]
        yt-dlp: error: yt-dlp’s self-update mechanism is disabled on Debian.
        Please update yt-dlp using apt(8).
        See for the latest packaged version.

        How to update yt-dlp?
        from 2022.04.08
        __to 2023.09.24-1

        Is above update problem a funciton of Operating System?
        Kubuntu 22.04.3

        ERROR: ‘upload_date>%%Y-%%m-%%d’

        yt-dlp –restrict-filenames -o “%(upload_date>%Y-%m-%d)a_%(title)s-%(id)s.%(ext)s” –write-description –write-comments –write-thumbnail –write-link -P /home/x_/Downloads/ https://www

        1. Joseph, thanks for giving me more context. Try the following
          It seems you need to update your yt-dlp instance: sudo apt update && sudo apt upgrade yt-dlp

          The template for the date stamp, it should be %(upload_date)s. Try the following command:
          yt-dlp –restrict-filenames -o “%(upload_date>s{YYYYMMDD})a_%(title)s-%(id)s.%(ext)s” –write-description –write-comments –write-thumbnail –write-link -P /home/x/Downloads/ https://www…/

          I hope that helps!

          1. Good day Diego,

            Strange, the sudo … command did not update yt-dlp.
            Details below:

            yt-dlp –version

            sudo apt update && sudo apt upgrade yt-dlp

            Hit:1 jammy InRelease
            Get:2 jammy-updates InRelease [119 kB]
            Get:3 jammy-security InRelease [110 kB]
            Hit:4 jammy-backports InRelease
            Get:5 jammy-updates/main i386 Packages [503 kB]
            Get:6 jammy-updates/main amd64 Packages [1,058 kB]
            Get:7 jammy-updates/universe amd64 Packages [989 kB]
            Get:8 jammy-updates/universe i386 Packages [658 kB]
            Fetched 3,437 kB in 1s (3,568 kB/s)
            Reading package lists… Done
            Building dependency tree… Done
            Reading state information… Done
            1 package can be upgraded. Run ‘apt list –upgradable’ to see it.
            Reading package lists… Done
            Building dependency tree… Done
            Reading state information… Done
            yt-dlp is already the newest version (2022.04.08-1).
            Calculating upgrade… Done
            Get more security updates through Ubuntu Pro with ‘esm-apps’ enabled:
            vlc-plugin-qt libvlc5 vlc-data libvlccore9 vlc imagemagick vlc-bin vlc-l10n
            libavdevice58 ffmpeg libopenexr25 libpostproc55 libmagickcore-6.q16-6-extra
            vlc-plugin-samba libavcodec58 libmagickwand-6.q16-6 vlc-plugin-notify
            libavutil56 imagemagick-6.q16 libswscale5 libeditorconfig0
            libmagickcore-6.q16-6 vlc-plugin-access-extra vlc-plugin-skins2
            vlc-plugin-video-splitter libswresample3 imagemagick-6-common
            vlc-plugin-video-output libavformat58 libvlc-bin vlc-plugin-base
            vlc-plugin-visualization libavfilter7
            Learn more about Ubuntu Pro at
            The following packages will be upgraded:
            1 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
            Need to get 43.3 kB of archives.
            After this operation, 25.6 kB of additional disk space will be used.
            Do you want to continue? [Y/n]
            Get:1 jammy-updates/main amd64 alsa-ucm-conf all [43.3 kB]
            Fetched 43.3 kB in 0s (302 kB/s)
            (Reading database … 228013 files and directories currently installed.)
            Preparing to unpack …/alsa-ucm-conf_1.2.6.3-1ubuntu1.8_all.deb …
            Unpacking alsa-ucm-conf ( over ( …
            Setting up alsa-ucm-conf ( …

            yt-dlp –version

            restart computer

            yt-dlp –version

            Stil old version of yt-dlp, No updating
            from 2022.04.08
            __to 2023.09.24-1

            Would a BIOS setting effect the sudo command?
            sudo apt update && sudo apt upgrade yt-dlp

  6. Interesante articulo, di con el en busca de como podia hacer con yt-dlp para descargar un video desde una pagina web accediendo con su id. El video esta en un div de la pagina web. Se entiende la pregunta ?


    1. Hola Norberto.

      Me alegra que encuentres interesante nuestro articulo de YT-DLP.
      No se si entiendo bien tu pregunta… Pero puedes acceder al video si tienes el id… intenta usar el siguiente commando:

      yt-dlp [URL o ID_del_video]

      Espero que te funcione.

  7. Hi, nice article.
    You could have included how the aspect ratio, and frame rate of video will be getting downloaded when you use this software. mp4and m4a examples are formats of video and audio. will the video downloaded will be as in the same frame rate and aspect ratio. plase tell

    1. Hi there Jraju.

      Thanks for feedback. We will surely include these informaiton on our coming update for this article.

      1. Good day Diego,

        yt-dlp –version

        Kubuntu 22.04

        What is the yt-dlp command? The command to get:
        20231131a_Title_of_Video-z2Ba75OrtIKN.mp4 but actual result is:

        yt-dlp –restrict-filenames -o “%(upload_date>s{YYYYMMDD})a_%(title)s-%(id)s.%(ext)s” –write-description –write-comments –write-thumbnail –write-link -P /home/xx/Downloads/ https://www

        side note:
        the web page converts
        — = 2 dashes to 1 dash –
        ” = square quotes to curly quotes “ ”

        end —

    1. 🙁 We dont like errors! Jorge, what happend? …. give more context/details?

  8. Hola, una pregunta, podria cambiar la ruta de descarga? los videos descargan directamente a esta ruta:
    C:\Users\Mi Usuario

    como puedo cambiar la ruta y darle otra ubicacion para los videos o la lista de videos descargados??

    1. Hola Bryan,

      Para cambiar la ruta de descarga en yt-dlp, debes especificar un nuevo directorio en el comando de descarga. Por ejemplo, si deseas descargar en la carpeta “D:\Mis Videos”, tu comando sería algo como yt-dlp -o “D:\Mis Videos\%(title)s.%(ext)s” [URL del video]. Esto indicará a yt-dlp que guarde los videos en la carpeta especificada. Es importante asegurarte de que la ruta exista y de tener los permisos necesarios para guardar archivos en ella.

      Mucha suerte… espero que te sirva!

  9. I only get an error when I try to test the Path of FFmpeg or FFProbe

    “‘ffprobe’ is not recognized as an internal or external command,
    operable program or batch file.”

    I use path “C:\PATH_Programs -ytdpl” and CMD is set up for C:\Users\Me>

    If I use cd and go to C:\PATH_Programs -ytdpl and test I get results like the screenshot when you did it.

    1. Hi James…

      So, if the system’s PATH environment variable does not include the directory where ffprobe and ffmpeg are located… try the following:

      > Ensure ffmpeg.exe and ffprobe.exe are in C:\PATH_Programs -ytdpl.
      > Update the PATH Environment Variable:

      Open System Properties > Advanced > Environment Variables.
      Under System variables, find and select Path, then click Edit.
      Click New and add C:\PATH_Programs -ytdpl to the list.

      Close and reopen CMD, then test by running ffmpeg -version and ffprobe -version from any directory.

      Just make sure you’ve correctly spelled the path when adding it to the PATH variable and restart CMD to apply the changes.

      I hope that helps!

  10. What are the terminal commands to
    install latest version of yt-dlp?

    Kubuntu 22.04.3

    yt-dlp –version

    i understand 2022.04.08 is an old version of yt-dlp.

    1. Joseph, we always recommend updating Yt-dlp to the latest version… but if you’re looking to specifically install the version 2022.04.08 of yt-dlp on Kubuntu 22.04.3, you’ll need to manually download that version from the yt-dlp GitHub repository’s release archives. >>>

      Find the direct link to that specific release, by browsing thorugh that “Releases” section, and look for the 2022.04.08 version.

      Once found, download the appropriate binary for Linux, and make it executable. You’ll need to manually install it, rather than automatically update it

      To make it executable:
      sudo chmod a+rx /usr/local/bin/yt-dlp

      Then verify by running yt-dlp –version.

  11. What is the yt-dlp command?
    How to add a date stamp to the file name?
    (a ten (10) character date stamp YYYYMMDDa_ )


    yt-dlp –version

    Kubuntu 22.04

    Command with no date stamp:
    yt-dlp –restrict-filenames –write-link -P /home/xx/Downloads/ https://www…./

    How to add a date stamp to the file name?

    1. Hi there Joseph;

      To add a date stamp to the filename in yt-dlp, you can try the output template option. Just, modify your command to include –output “%(upload_date)s_Video_title-[%(id)s].%(ext)s”, replacing %(upload_date)s with the appropriate date format.

      In your particular case, it would be for a 10-character date stamp like YYYYMMDDa_, you’d likely need to use %(upload_date)s directly, and then manually adjust it to your specific needs, as yt-dlp might not support custom date formats directly.

      I hope that helps!

  12. Bonjour, j’essaie d’installer yt-dlp pour l’utiliser, sous Windows 11. J’ai bien suivi toutes les étapes mais dès que je rentre une commande avec “yt-dlp” j’ai ce message :

    yt-dlp : Le terme «yt-dlp» n’est pas reconnu comme nom d’applet de commande, fonction, fichier de script ou programme exécutable. Vérifiez l’orthographe du nom, ou si un chemin d’accès existe, vérifiez que le chemin d’accès est correct et réessayez.

    J’ai pourtant “exécuter en tant qu’administrateur” le fichier. J’arrive bien jusqu’à l’utilisation de FFmpeg, c’est vraiment à partir de l’étape 4. Comment utiliser YT-DLP sous Windows et Linux que ça coince. Je pense que j’ai loupé quelque chose mais j’ai repris toutes les étapes 3 fois… Est-ce que vous auriez une piste ?

    1. Bonjour Amandine,

      Il semble que le système ne reconnaisse pas “yt-dlp” comme une commande. Cela se produit généralement lorsque l’exécutable du programme n’est pas dans la variable d’environnement PATH de votre système. Pour résoudre cela, vous devez ajouter le répertoire contenant yt-dlp.exe à votre PATH. Voici un guide simplifié :

      Localisez yt-dlp.exe sur votre ordinateur.
      Copiez le chemin d’accès au dossier où se trouve yt-dlp.exe.
      Recherchez “Variables d’environnement” dans les paramètres de Windows 11.
      Modifiez la variable PATH pour inclure le chemin d’accès que vous avez copié.
      Ouvrez une nouvelle invite de commande et essayez à nouveau la commande yt-dlp.
      J’espère que cela vous aide !

      À bientôt !

  13. Thanks for info guys!
    Can I download all files from urls, when they are in a .txt file.
    (I have a txt file, – inside 20 urls from Youtube) in which format urls must be written? by ENTER< or by COMA?

    1. Hi there Oleksly,

      Please try the following:

      “To download all files from a list of URLs in a .txt file using yt-dlp, the URLs should be written line by line, separated by an Enter (newline), not by a comma. You can use the command yt-dlp -a yourfile.txt to download from all the URLs listed in your text file (yourfile.txt).”

      I hope that helps!

  14. Hi Diego, I want to deploy yt-dlp to azure as an endpoint of an api.
    Everything is fine, but it seems youtube is blocking my azure VM. Do you know how to configure so I don’t get blocked by YouTube? Do I need a proxy?

    Thanks a lot

    1. Hi John; The block likely means that you’re somehow exceeding an unseen threshold. Try adjusting your request rate limit using –sleep-interval and –max-sleep-interval. A proxy might work if you use it to distribute your requests across a bunch of IP addresses. Hope this helps!

  15. Hi Diego

    I can’t download your example video:

    yt-dlp -f ‘bv*+ba’
    [youtube] Extracting URL:
    [youtube] 1PmJeP-TphM: Downloading webpage
    [youtube] 1PmJeP-TphM: Downloading ios player API JSON
    [youtube] 1PmJeP-TphM: Downloading android player API JSON
    WARNING: [youtube] Skipping player responses from android clients (got player responses for video “aQvGIIdgFDM” instead of “1PmJeP-TphM”)
    ERROR: [youtube] 1PmJeP-TphM: Private video. Sign in if you’ve been granted access to this video

    I don’t know what the ios and Android lines are about as I’m using Linux but that ‘ERROR’ LINE is telling me I need to sign in so how do I add my YouTube details to the comand please?

    1. Hi Mike, the error code is due to the video now being private. You can try with a different video instead; it should work fine. As for the warnings, that seem part of a yt-dlp bug that was addressed with a nightly build. Try updating yt-dlp with “–update-to nightly”. Hope this helps!

  16. Hi, On Step 2, a, you say to double click on the .exe file in Windows to install. When I double click on it, it tells me that there is an error and that instead of double clicking on the .exe file, I need to call it from the command line.

    1. Hi there.

      Thanks for noting that… We had an error in this exact installation step. Sorry for confusing you.
      Yes, you need to call it from the command line, not double-click as the article used to say.

      We added the following note:

      The yt-dlp.exe file is not an installer; it’s the executable file for yt-dlp itself. In the context of Windows, an executable file (with an .exe extension) is a program that can run directly once it’s clicked or executed from the command line. For yt-dlp, you simply place the yt-dlp.exe file in a directory of your choice (for instance C:\ytdlp) and run it directly from there.

  17. Buenos días Diego,
    Gracias por publicar estas instrucciones. Han sido de mucha utilidad. Sin embargo me encuentro que cuando ejecuto el siguiente comando del tutorial para hacerlo ejecutable en Ubuntu 20.04: $ sudo chmod a+rx /usr/local/bin/yt-dlp, me devuelve un mensaje de error “no existe el archivo o directorio”. Cuando accedo al directorio /usr/local/bin/ me encuentro allí un único archivo llamado yt-dl (sin la ‘p’ final) ¿Me estaría faltando un archivo? Te aclaro que he seguido los pasos del tutorial. Quedo a la espera de lo que puedas comentarme. Gracias de antemano. Un saludo

    1. Hi Bruno, prueba esto:

      1. Verifique si yt-dl es la herramienta correcta enumerando el contenido del directorio. Si es así, cámbiele el nombre a yt-dlp:
      sudo mv /usr/local/bin/yt-dl /usr/local/bin/yt-dlp
      2. Si cambiar el nombre no funciona, vuelve a descargar yt-dlp:
      sudo wget -O /usr/local/bin/yt-dlp
      3. Hazlo ejecutable:
      sudo chmod a+rx /usr/local/bin/yt-dlp
      4. Verifique la instalación:
      yt-dlp –versión

Speak your mind

Leave a Reply

Your email address will not be published. Required fields are marked *