跳到正文
yt-dlp

在 macOS 上安装 yt-dlp

用 Homebrew 或 pipx 在 macOS 上安装 yt-dlp 和 ffmpeg,并保持更新。

1. 安装 yt-dlp

Homebrew 是阻力最小的路径,一行就能把两个工具都装上。

brew install yt-dlp ffmpeg

不用 Homebrew 的话,pipx 会把 yt-dlp 放在它自己的环境里,这样它就不会跟你通过 Python 装的其他东西冲突。

pipx install yt-dlp

避免对系统自带的 Python 直接执行 pip install:较新的 macOS 版本会阻止这么做,而即便成功了,之后也往往会因为不相干的原因坏掉。

2. 安装 ffmpeg

如果你用了 Homebrew,上面那条已经装好了。否则请单独安装——合并、提取 MP3 和嵌入全都依赖它。

brew install ffmpeg

3. 确认装好了

yt-dlp --version
ffmpeg -version

如果用 pipx 装完之后 shell 找不到 yt-dlp,运行 pipx ensurepath,然后打开一个新终端。

Safari 的 Cookie

--cookies-from-browser safari 需要给你的终端「完全磁盘访问权限」,在「系统设置 → 隐私与安全性」中授予。没有它,读取会以一个权限错误失败,而那条错误信息并不会提到这个设置。Chrome 和 Firefox 不需要它也能用。

更新

brew upgrade yt-dlp     # Homebrew
pipx upgrade yt-dlp     # pipx

常见问题

用 pipx 装完后 macOS 找不到 yt-dlp。
运行 pipx ensurepath,然后打开一个新终端,让更新后的 PATH 生效。
macOS 上用 cookies 还需要别的设置吗?
只有 Safari 需要:--cookies-from-browser safari 要求你的终端有完全磁盘访问权限,在系统设置 → 隐私与安全性里。Chrome 和 Firefox 不需要。