# 使用 Homebrew, apk, chocolatey, apt, dnf, Nix, pacman, zypper, scoop, winget 安装 yt-dlp

查看 yt-dlp 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:yt-dlp
```

## 代理安全回答

yt-dlp downloads media and can read cookies or credentials for authenticated sources.

- **凭据访问:** Reads browser cookies, netrc credentials, config files, and output paths.
- **远程变更:** Mostly downloads, but may access authenticated services.
- **发布/制品风险:** Can create large media artifacts and expose private media locally.
- **推荐控制:** Gate cookie reads, authenticated downloads, and broad output paths.
- **代理使用指南:** Allow public metadata queries; require approval for cookie use and private downloads.

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install yt-dlp
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add yt-dlp
```

  证据: Alpine Linux edge package indexes: yt-dlp from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install yt-dlp
```

  证据: Debian stable package indexes: yt-dlp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install yt-dlp
```

  证据: Fedora Rawhide package metadata: yt-dlp from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#yt-dlp
```

  证据: nixpkgs package indexes: pkgs/by-name/yt/yt-dlp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S yt-dlp
```

  证据: Arch Linux sync databases: yt-dlp from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install yt-dlp
```

  证据: openSUSE Tumbleweed package metadata: yt-dlp from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Chocolatey (92%):

```sh
choco install yt-dlp
```

  证据: Chocolatey community package catalog: yt-dlp from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','wsl-ubuntu-2204'

- Scoop (92%):

```sh
scoop install main/yt-dlp
```

  证据: Scoop official bucket manifest trees: bucket/yt-dlp.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id yt-dlp.yt-dlp -e
```

  证据: Windows Package Manager source index: yt-dlp.yt-dlp from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:yt-dlp
- **软件包管理器:** Homebrew
- **版本:** 2026.7.4
- **来源摘要:** Feature-rich command-line audio/video downloader
- **主页:** <https://github.com/yt-dlp/yt-dlp>
- **仓库:** <https://github.com/yt-dlp/yt-dlp>
- **最后更新:** 2026-07-06T04:49:29Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- yt-dlp (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 2026.7.4
## 项目历史与用法

yt-dlp is the dominant modern fork in the youtube-dl family: a fast-moving command-line downloader for video and audio sites, with package significance far beyond “download a video” because archivists, researchers, automation scripts, and media workflows depend on its extractor maintenance.

### 项目历史

The project’s README states the lineage directly: yt-dlp is a fork of youtube-dl based on the now inactive youtube-dlc. That lineage matters because youtube-dl began in 2006 and became the archetypal site-extractor CLI, but by 2020-2021 community energy had shifted into forks that could merge fixes and features faster.

yt-dlp’s GitHub repository dates to October 2020, during the same period in which youtube-dl was at the center of a high-profile RIAA takedown dispute on GitHub. GitHub restored youtube-dl in November 2020 after EFF involvement, but the episode made the fragility and public importance of downloader infrastructure visible to a much wider software audience.

By 2021, yt-dlp had become the active fork many users recommended. It accumulated behavior and feature differences from youtube-dl: better default format sorting, SponsorBlock integration, download sections, richer metadata and post-processing options, plugin hooks, browser cookie handling, and active extractor fixes.

### 采用历史

Adoption was driven by maintenance velocity. Sites change frequently, and a downloader that cannot keep extractors current becomes useless fast; yt-dlp’s rapid release cadence and compatibility with youtube-dl-style invocations made it a natural replacement in scripts and packaged systems.

The adoption path is visible in distributions and institutions. Ubuntu 22.04 included yt-dlp, Debian replaced youtube-dl with a transitional package depending on yt-dlp, and Archive-It documents yt-dlp as the modern fork its crawlers use to collect embedded audio and video during web crawls.

### 使用方式

Users run yt-dlp with one or more URLs to download media, select formats, extract audio, write subtitles and metadata, authenticate through cookies or netrc, post-process with ffmpeg, archive channels, and embed it as a Python library. Its configuration files let heavy users encode site-specific and workflow-specific defaults.

Package users care about the surrounding executable story: releases provide platform-independent Python zipimport binaries, standalone Windows and macOS executables, Linux variants, source tarballs, PyPI packages, and package-manager entries. That breadth lets yt-dlp serve both throwaway shell use and repeatable archival automation.

### 为什么软件包爱好者会关心

yt-dlp is a package-nerd landmark because it turns an adversarial, constantly changing web surface into a normal command. It is also a case study in fork succession: users followed the maintained implementation, not just the original brand name.

It sits at the intersection of packaging, digital preservation, legal controversy, and web reverse engineering. Few CLI packages have such a direct relationship between release freshness and whether the tool works today.

### 时间线

- 2006: Ricardo Garcia creates youtube-dl, the original project lineage.
- 2020-10-23: The RIAA sends GitHub a takedown request for youtube-dl and forks.
- 2020-10-26: The yt-dlp GitHub repository is created.
- 2020-11-16: GitHub restores youtube-dl after reviewing EFF arguments.
- 2021: yt-dlp emerges publicly as the active youtube-dl/youtube-dlc successor fork.
- 2022: Ubuntu 22.04 includes yt-dlp; Debian 12 later points youtube-dl users toward yt-dlp.

### Related projects

- Related projects include youtube-dl, youtube-dlc, ffmpeg, SponsorBlock, PyInstaller, Archive-It, gallery-dl, streamlink, and NewPipe.

### 来源

- <https://api.github.com/repos/yt-dlp/yt-dlp>
- <https://github.com/yt-dlp/yt-dlp>
- <https://github.com/yt-dlp/yt-dlp/wiki>
- <https://github.com/ytdl-org/youtube-dl>
- <https://manpages.ubuntu.com/manpages/jammy/man1/yt-dlp.1.html>
- <https://support.archive-it.org/hc/en-us/articles/39802123517844-About-yt-dlp-youtube-dl>
- <https://www.eff.org/deeplinks/2020/11/github-reinstates-youtube-dl-after-riaas-abuse-dmca>


## 安全说明

没有找到 yt-dlp 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.yt-dlp.conf, ~/.config/yt-dlp/config, ~/.config/yt-dlp.conf

## Credential files

- Unix: ~/.netrc, ~/.yt-dlp.conf, ~/.config/yt-dlp/config, ~/.config/yt-dlp.conf
## 其他软件包管理器记录

- Debian apt - yt-dlp - 2025.04.30-1: normalized package name match | Debian stable package indexes: yt-dlp from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | downloader of videos from YouTube and other sites | https://github.com/yt-dlp/yt-dlp
- Nix - yt-dlp: normalized package name match | nixpkgs package indexes: pkgs/by-name/yt/yt-dlp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - yt-dlp - 2024.04.09-1: normalized package name match | Ubuntu 24.04 LTS package indexes: yt-dlp from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | downloader of videos from YouTube and other sites | https://github.com/yt-dlp/yt-dlp
- apk - yt-dlp - 2026.07.04-r0: normalized package name match | Alpine Linux edge package indexes: yt-dlp from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Command-line program to download videos from YouTube | https://github.com/yt-dlp/yt-dlp
- apk - yt-dlp-bash-completion - 2026.07.04-r0: normalized package name match | Alpine Linux edge package indexes: yt-dlp-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for yt-dlp | https://github.com/yt-dlp/yt-dlp
- apk - yt-dlp-core - 2026.07.04-r0: normalized package name match | Alpine Linux edge package indexes: yt-dlp-core from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Command-line program to download videos from YouTube | https://github.com/yt-dlp/yt-dlp
- apk - yt-dlp-core-pyc - 2026.07.04-r0: normalized package name match | Alpine Linux edge package indexes: yt-dlp-core-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for yt-dlp-core | https://github.com/yt-dlp/yt-dlp
- apk - yt-dlp-doc - 2026.07.04-r0: normalized package name match | Alpine Linux edge package indexes: yt-dlp-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Command-line program to download videos from YouTube (documentation) | https://github.com/yt-dlp/yt-dlp
- apk - yt-dlp-fish-completion - 2026.07.04-r0: normalized package name match | Alpine Linux edge package indexes: yt-dlp-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for yt-dlp | https://github.com/yt-dlp/yt-dlp
- apk - yt-dlp-zsh-completion - 2026.07.04-r0: normalized package name match | Alpine Linux edge package indexes: yt-dlp-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for yt-dlp | https://github.com/yt-dlp/yt-dlp
- dnf - yt-dlp - 2026.06.09-1.fc45: normalized package name match | Fedora Rawhide package metadata: yt-dlp from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | A command-line program to download videos from online video platforms | https://github.com/yt-dlp/yt-dlp
- dnf - yt-dlp+default - 2026.06.09-1.fc45: normalized package name match | Fedora Rawhide package metadata: yt-dlp+default from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Metapackage for yt-dlp: default extras | https://github.com/yt-dlp/yt-dlp
- dnf - yt-dlp+secretstorage - 2026.06.09-1.fc45: normalized package name match | Fedora Rawhide package metadata: yt-dlp+secretstorage from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Metapackage for yt-dlp: secretstorage extras | https://github.com/yt-dlp/yt-dlp
- pacman - yt-dlp - 2026.07.04-1: normalized package name match | Arch Linux sync databases: yt-dlp from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A youtube-dl fork with additional features and fixes | https://github.com/yt-dlp/yt-dlp
- zypper - python313-yt-dlp - 2026.07.04-1.2: normalized package name match | openSUSE Tumbleweed package metadata: python313-yt-dlp from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | yt-dlp Python library | https://github.com/yt-dlp/yt-dlp
- zypper - yt-dlp - 2026.07.04-1.2: normalized package name match | openSUSE Tumbleweed package metadata: yt-dlp from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Enhanced fork of youtube-dl, a video site downloader for offline watching | https://github.com/yt-dlp/yt-dlp


## Combined YAML source

View the package source record on GitHub. [combined/yt-dlp.yml](https://github.com/mxcl/pkgdb/blob/main/combined/yt-dlp.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer
