跳至內容
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 不需要。