yt-dlp

https://github.com/yt-dlp/yt-dlp-wiki
Admin
yt-dlp is a command-line program for downloading videos and audio from YouTube and many other video...
Tokens:30,426
Snippets:259
Trust Score:8.8
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Install yt-dlp with winget

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp on Windows using winget.

```powershell
winget install --source winget --id yt-dlp.yt-dlp
```

--------------------------------

### Install yt-dlp with Snap

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp on Linux using Snap from the edge channel.

```bash
sudo snap install --edge yt-dlp
```

--------------------------------

### Install yt-dlp without optional dependencies

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp without any optional dependencies. Useful when you want a minimal installation.

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

--------------------------------

### Install yt-dlp with pip

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs or updates yt-dlp from PyPI with the default optional dependencies. Use this as the standard installation method.

```bash
python3 -m pip install -U "yt-dlp[default]"
```

--------------------------------

### Install yt-dlp with Scoop

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp on Windows using Scoop.

```powershell
scoop install yt-dlp
```

--------------------------------

### Install and update yt-dlp on Android (Termux)

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Step-by-step Termux setup on Android: allow storage access, update packages, install Python and pip, install yt-dlp with default dependencies, and optionally install ffmpeg. Update with the same pip command.

```bash
termux-setup-storage                 # Allow termux to download files into your phone's storage
pkg update && pkg upgrade            # Update all packages
pkg install python python-pip        # Install Python and pip
pip install -U "yt-dlp[default]"     # Install yt-dlp with default dependencies
pkg install ffmpeg                   # OPTIONAL: Install ffmpeg
```

```bash
pip install -U "yt-dlp[default]"
```

--------------------------------

### Install yt-dlp with Homebrew

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp using Homebrew on macOS or Linux.

```bash
brew install yt-dlp
```

--------------------------------

### Install and update yt-dlp with Snap

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install and manually update yt-dlp from the Snap edge channel.

```bash
sudo snap install --edge yt-dlp
```

```bash
sudo snap refresh --edge yt-dlp
```

--------------------------------

### Install yt-dlp with Chocolatey

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp on Windows using Chocolatey.

```powershell
choco install yt-dlp
```

--------------------------------

### Install nightly yt-dlp with pip

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs the nightly (pre-release) version of yt-dlp from PyPI. Use this to get the latest features before stable releases.

```bash
python3 -m pip install -U --pre "yt-dlp[default]"
```

--------------------------------

### Install and update yt-dlp with Scoop

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install and update yt-dlp using Scoop on Windows.

```bash
scoop install yt-dlp
```

```bash
scoop update yt-dlp
```

--------------------------------

### Install and update yt-dlp with Homebrew

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install and update yt-dlp using Homebrew on Linux/macOS.

```bash
brew install yt-dlp
```

```bash
brew upgrade yt-dlp
```

--------------------------------

### Install yt-dlp release binary with curl, wget, or aria2c

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install the yt-dlp release binary into ~/.local/bin on UNIX-like systems using curl, wget, or aria2c, then make it executable with chmod a+rx. Each command downloads the latest Linux/BSD binary from GitHub releases.

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

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

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

--------------------------------

### Install nightly and master variants of yt-dlp via pip

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install the nightly pre-release from PyPI, or the master (bleeding edge) build from GitHub. The master install requires upgrading pip, hatchling, and wheel first.

```bash
python3 -m pip install -U --pre "yt-dlp[default]"
```

```bash
python3 -m pip install -U pip hatchling wheel
```

```bash
python3 -m pip install --force-reinstall "yt-dlp[default] @ https://github.com/yt-dlp/yt-dlp/archive/master.tar.gz"
```

--------------------------------

### Install yt-dlp with MacPorts

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp on macOS using MacPorts.

```bash
sudo port install yt-dlp
```

--------------------------------

### Install and update yt-dlp with Chocolatey

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install and update yt-dlp using Chocolatey on Windows.

```bash
choco install yt-dlp
```

```bash
choco upgrade yt-dlp
```

--------------------------------

### Install yt-dlp-core on Alpine Linux

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp on Alpine Linux without optional dependencies.

```sh
doas apk -U add yt-dlp-core
```

--------------------------------

### Install yt-dlp with pacman on Arch Linux

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install yt-dlp from the Arch Linux community repository. Dependencies are resolved automatically, and updates are handled by the same command.

```bash
sudo pacman -Syu yt-dlp
```

--------------------------------

### Install and update yt-dlp with MacPorts

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install yt-dlp with MacPorts, then update by running selfupdate followed by upgrade.

```bash
sudo port install yt-dlp
```

```bash
sudo port selfupdate
```

```bash
sudo port upgrade yt-dlp
```

--------------------------------

### Install yt-dlp on Alpine Linux

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs yt-dlp on Alpine Linux with optional dependencies using apk.

```sh
doas apk -U add yt-dlp
```

--------------------------------

### Install and update yt-dlp with winget

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install and update yt-dlp using winget on Windows. The built-in updater `yt-dlp -U` is an alternative for updates.

```bash
winget install --source winget --id yt-dlp.yt-dlp
```

```bash
winget upgrade --source winget --id yt-dlp.yt-dlp
```

--------------------------------

### Install yt-dlp binary with aria2c

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Downloads the yt-dlp binary using aria2c and makes it executable in ~/.local/bin.

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

--------------------------------

### Install master branch yt-dlp with pip

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Installs the master branch of yt-dlp directly from GitHub. First upgrades build tools, then force-reinstalls the package from the master archive.

```bash
python3 -m pip install -U pip hatchling wheel
python3 -m pip install --force-reinstall "yt-dlp[default] @ https://github.com/yt-dlp/yt-dlp/archive/master.tar.gz"
```

--------------------------------

### Update yt-dlp with Snap

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Manually updates yt-dlp installed via Snap.

```bash
sudo snap refresh --edge yt-dlp
```

--------------------------------

### Install yt-dlp binary with wget

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Downloads the yt-dlp binary using wget and makes it executable in ~/.local/bin.

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

--------------------------------

### Install, install without deps, and update yt-dlp via pip

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/installation.md

Install yt-dlp with the default dependency group, install without optional dependencies, and update. On some systems, use `py` or `python` instead of `python3`.

```bash
python3 -m pip install -U "yt-dlp[default]"
```

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

```bash
python3 -m pip install -U "yt-dlp[default]"
```

--------------------------------

### Install yt-dlp binary with curl

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Installation.md

Downloads the yt-dlp binary using curl and makes it executable in ~/.local/bin.

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

--------------------------------

### Clone the sample plugin repository

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Plugin Development.md

Clone the repository created from the yt-dlp-sample-plugins template. Replace YOUR_GITHUB_USERNAME and YOUR_REPOSITORY with your own.

```bash
git clone git@github.com:YOUR_GITHUB_USERNAME/YOUR_REPOSITORY.git
```

--------------------------------

### Add, commit, and push plugin files

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Plugin Development.md

Commands to add the plugin files, commit them with a message, and push to the master branch. The example uses 'yourplugin' as the plugin name.

```git
$ git add yt_dlp_plugins setup.cfg README.md
$ git commit -m 'Add yourplugin plugin'
$ git push origin master
```

--------------------------------

### Install yt-dlp with default dependency group to include yt-dlp-ejs

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/ejs.md

Use this pip command to install or upgrade yt-dlp with the default dependency group, which includes the yt-dlp-ejs package. This is Option 1 for PyPI installations.

```bash
pip install -U "yt-dlp[default]"
```

--------------------------------

### Import extractor from another plugin

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/Plugin Development.md

Import an extractor from another plugin using the yt_dlp_plugins.extractor module. This works regardless of where the plugin is installed, but fails if the plugin is not installed.

```python
from yt_dlp_plugins.extractor.example import ExampleIE
```

--------------------------------

### Enable EJS scripts via npm downloads (Deno/Bun)

Source: https://github.com/yt-dlp/yt-dlp-wiki/blob/master/_autodocs/api-reference/ejs.md

Use this yt-dlp option to enable downloading EJS scripts from npm, supported only for Deno and Bun runtimes. Recommended to add to the configuration file for automatic updates.

```bash
--remote-components ejs:npm
```
Tokens:
Raw