Installation

You can install yt-dlp either using one of the official releases, or with your favorite package manager

---

Using the release binary

You can simply download the correct binary file for your OS

In UNIX-like OSes (MacOS, Linux, BSD), you can also install the same in one of the following ways:

sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp  # Make executable

sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp  # Make executable

sudo aria2c https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp --dir /usr/local/bin -o yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp  # Make executable

To update, run:

sudo yt-dlp -U

With PIP

You can install the PyPI package with:

python3 -m pip install -U yt-dlp

You can install without any of the optional dependencies using:

python3 -m pip install --no-deps -U yt-dlp

If you want to be on the cutting edge, you can also install the master branch with:

python3 -m pip install --force-reinstall https://github.com/yt-dlp/yt-dlp/archive/master.tar.gz

On some systems, you may need to use py or python instead of python3

To update, run:

python3 -m pip install -U yt-dlp

Third-party package managers

Note: These packages are manitained by third-parties and may not be up-to-date. Please report any issues to the respective package maintainers

Linux/MacOS

Homebrew

macOS or Linux users that are using Homebrew can also install it by:

brew install yt-dlp

To update, run:

brew upgrade yt-dlp

pacman

Arch Linux users can install it from the official community repository:

pacman -Syu yt-dlp

pacman will now automatically download the correct dependencies and keep the package up-to-date whenever you update your system with:

pacman -Syu

APT

You can download and install yt-dlp for Ubuntu and other related Debian-based distributions by adding the stable PPA

sudo add-apt-repository ppa:yt-dlp/stable    # Add ppa repo to apt
sudo apt update                              # Update package list
sudo apt install yt-dlp                      # Install yt-dlp

If you wish to use pre-compiled bleeding edge daily snapshot packages, use the unstable PPA instead:

sudo add-apt-repository ppa:yt-dlp/unstable  # Add ppa repo to apt
sudo apt update                              # Update package list
sudo apt install yt-dlp                      # Install yt-dlp

Your system's package manager will now automatically download the correct dependencies and keep the package updated with the rest of your system whenever you run:

sudo apt update
sudo apt install yt-dlp

MacPorts

You can install yt-dlp on macOS using MacPorts:

sudo port install yt-dlp

To update, run:

sudo port selfupdate
sudo port upgrade yt-dlp

Windows

Scoop

scoop install yt-dlp

To update, run:

scoop update yt-dlp

Chocolatey

choco install yt-dlp

To update, run:

choco upgrade yt-dlp

winget

winget install yt-dlp

To update, run:

winget upgrade yt-dlp

Android

You can use yt-dlp on Android using Termux. Once Termux is installed, open it and run the following commands:

termux-setup-storage       # Allow termux to download files into your phone's storage
pkg update && pkg upgrade  # Update all packages
pkg install python         # Install python
pip install -U yt-dlp      # Install yt-dlp
pkg install ffmpeg         # OPTIONAL: Install ffmpeg

To update, run:

pip install -U yt-dlp