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