# yt-dlp

> Command-line audio/video downloader supporting thousands of sites, forked from youtube-dl and youtube-dlc, with format selection, post-processing and plugins.

Stars: 203.3k · Language: Python · License: Unlicense · Categories: Network

- Repository: https://github.com/yt-dlp/yt-dlp
- Website: https://discord.gg/H5MNcFW63r
- Page: https://www.trmn.sh/tools/yt-dlp

## Install

- Homebrew: `brew install yt-dlp`

## Overview

yt-dlp is a command-line audio and video downloader that supports thousands of sites (listed in supportedsites.md). It is a fork of youtube-dl, based on the now inactive youtube-dlc. It is written in Python and can be run as a standalone binary or installed from PyPI.

The option set covers network settings, geo-restriction handling, video selection, download behavior, filesystem options, thumbnails, subtitles, authentication, and verbosity/simulation. Further sections document format selection (with filtering and sorting), output templates, metadata modification, post-processing, SponsorBlock options, and per-extractor arguments. Configuration can be kept in config files, and credentials can be supplied through netrc.

yt-dlp can be extended with plugins and embedded in other Python programs. Release binaries are provided for Windows (x64, x86, ARM64), macOS, and Linux (glibc and musl; x86_64, aarch64, armv7l), plus a platform-independent zipimport binary that needs Python. Binaries can self-update with `yt-dlp -U` across stable, nightly and master channels. Release files are accompanied by GPG-signed checksums. It is aimed at developers, archivists and anyone who downloads media from the command line or scripts it.

### Installation

```bash
# via Homebrew
brew install yt-dlp
```

## Alternatives

- [mitmproxy](https://www.trmn.sh/tools/mitmproxy.md): Interactive SSL/TLS-capable HTTP proxy with console, command-line, and web interfaces for traffic inspection (Python, 46.4k stars)
- [sqlmap](https://www.trmn.sh/tools/sqlmap.md): Open source penetration testing tool that automates detection and exploitation of SQL injection flaws and database server takeover. (Python, 38.8k stars)
- [HTTPie](https://www.trmn.sh/tools/httpie.md): Command-line HTTP client with human-friendly syntax for API testing and web service interaction (Python, 38.7k stars)
- [magic-wormhole](https://www.trmn.sh/tools/magic-wormhole.md): Python library and `wormhole` CLI for sending files, directories, or text between computers using short, single-use, human-pronounceable codes. (Python, 23.1k stars)
- [gallery-dl](https://www.trmn.sh/tools/gallery-dl.md): Cross-platform command-line program that downloads image galleries and collections from many image hosting sites, with configurable file naming. (Python, 20.3k stars)

---

Canonical: https://www.trmn.sh/tools/yt-dlp