Skip to content

Latest commit

 

History

History
183 lines (135 loc) · 5.3 KB

Installation.md

File metadata and controls

183 lines (135 loc) · 5.3 KB
Raw

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

Windows Linux MacOS Other variants

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 -U pip setuptools wheel
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

Packaging status

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:

sudo 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:

sudo 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

The Debian package is upstream for the Ubuntu ppa.

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