yt-dlp 安裝與使用全攻略
yt-dlp 安裝與使用全攻略
yt-dlp 是 youtube-dl 的一個分支，功能更強大、更新更頻繁。它是一個開源的命令列工具，可以讓您從 YouTube、Bilibili、Vimeo 和數百個其他網站下載影片和音訊。
本指南將引導您完成 yt-dlp 的安裝，並介紹一些最常用的功能。
1. 安裝 yt-dlp
根據您的作業系統，選擇最適合您的安裝方式。
Windows
最簡單的方式是直接下載 .exe 執行檔。
- 前往 yt-dlp 的 GitHub 發布頁面：https://github.com/yt-dlp/yt-dlp/releases
- 下載 yt-dlp.exe 檔案（適用於 64 位元 Windows 8 以上系統）。
- 將下載的 yt-dlp.exe 檔案移動到一個您容易存取的位置。
建議做法：建立一個專門的資料夾（例如 C:\Tools），將 yt-dlp.exe 放入其中，然後將此資料夾新增到系統的「環境變數 PATH」中。這樣最為乾淨且標準。
簡單做法：直接將檔案放在 C:\Windows 中。這雖然可行，但不建議，因為它會與系統檔案混雜。
您可以打開「命令提示字元 (cmd)」或「PowerShell」，輸入 `yt-dlp --version` 來測試是否安裝成功。如果成功，它會顯示目前的版本號。
更新指令：
```
yt-dlp -U
```
macOS
推薦使用 Homebrew 進行安裝（或者直接下載獨立執行檔 yt-dlp_macos 從 GitHub 發布頁面，適用於 macOS 10.15 以上）。
- 打開「終端機 (Terminal)」應用程式。
- 如果您尚未安裝 Homebrew，請先執行以下指令安裝：
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
- 透過 Homebrew 安裝 yt-dlp：
```
brew install yt-dlp
```
輸入 `yt-dlp --version` 測試是否安裝成功。
更新指令：
```
brew upgrade yt-dlp
```
Linux
您可以直接從 GitHub 下載二進位檔案，或使用 pip (Python 套件管理器) 安裝。
方法一：直接下載 (推薦)
- 打開終端機。
- 執行以下指令下載最新版本並賦予執行權限：
```
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp
```
輸入 `yt-dlp --version` 測試是否安裝成功。
更新指令：
```
sudo yt-dlp -U
```
方法二：使用 pip
```
python3 -m pip install -U yt-dlp
```
2. FFmpeg (強烈建議安裝)
FFmpeg 是一個處理多媒體檔案的強大工具。當您需要下載特定格式或需要將影片和音訊合併時（例如下載最高畫質的 YouTube 影片），yt-dlp 會呼叫它。
- **Windows**: 前往 FFmpeg 官方網站（https://ffmpeg.org/download.html）下載，選擇適合的 builds（如 gyan.dev 或 BtbN），解壓縮後將 bin 資料夾中的 ffmpeg.exe 放到與 yt-dlp.exe 相同的資料夾中，或是放入任何一個已加入「環境變數 PATH」的資料夾。
- **macOS**: 使用 Homebrew 安裝：
```
brew install ffmpeg
```
- **Linux**: 使用您的發行版套件管理器安裝，例如在 Debian/Ubuntu 上：
```
sudo apt install ffmpeg
```
3. 基本使用方法
yt-dlp 的基本語法是：
```
yt-dlp [選項] "影片網址"
```
注意：建議一律將網址用引號 "" 包起來，避免網址中的特殊字元導致錯誤。
下載影片
這是最簡單的用法，會下載預設最高畫質且影音合一的檔案。
```
yt-dlp "影片的網址"
```
範例：
```
yt-dlp "https://youtu.be/z0KG6CPqCwM"
```
下載純音訊
如果您只想下載聲音，可以使用 -x 或 --extract-audio 選項。
- `-x`: 提取音訊。
- `--audio-format <格式>`: 指定音訊格式，如 mp3, m4a, wav, flac 等。
```
# 下載最佳品質的音訊，並儲存為 m4a (預設)
yt-dlp -x "影片網址"
# 下載並轉為 MP3 格式
yt-dlp -x --audio-format mp3 "影片網址"
```
4. 進階使用技巧
### 查看所有可下載的格式
使用 -F 或 --list-formats 選項，可以列出該影片所有可用的影像和聲音格式。
```
yt-dlp -F "影片網址"
```
您會看到一個包含 ID、EXT (副檔名)、RESOLUTION (解析度) 等資訊的表格。
下載指定格式
了解格式 ID 後，您可以使用 -f 或 --format 選項來下載特定版本。
ID 來自 -F 指令的列表。您可以組合影像和聲音的 ID，用 + 連接。yt-dlp 會分別下載後，使用 FFmpeg 自動合併。
```
# 下載 ID 為 137 的影像 + ID 為 140 的聲音 (通常是 1080p 影像 + m4a 聲音)
yt-dlp -f 137+140 "影片網址"
# 下載最佳畫質的影片和最佳品質的聲音並合併 (常用！)
yt-dlp -f "bestvideo+bestaudio/best" "影片網址"
```
(註：/best 是後備選項，如果因故無法合併，則會下載單一檔案的最佳版本)
下載播放清單 (Playlist)
直接提供播放清單的網址即可。yt-dlp 會自動下載整個清單的影片。
```
yt-dlp "播放清單的網址"
```
如果您只想下載清單中的某幾個影片，可以使用 --playlist-items。
```
只下載清單中的第 2、5、8 個影片
yt-dlp --playlist-items 2,5,8 "播放清單的網址"
下載第 10 到 20 個影片
yt-dlp --playlist-items 10-20 "播放清單的網址"
```
下載字幕
- `--write-subs`: 下載手動上傳的字幕。
- `--write-auto-subs`: 下載自動產生的字幕。
- `--sub-langs <語言代碼>`: 指定要下載的字幕語言，例如 en, zh-TW, ja。
- `--embed-subs`: 將字幕嵌入影片檔案中 (僅支援 .mp4, .mkv 等格式)。
```
下載影片並同時下載繁體中文和英文字幕 (會是獨立的 .vtt 或 .srt 檔案)
yt-dlp --write-subs --sub-langs "zh-TW,en" "影片網址"
下載影片並將繁體中文字幕嵌入影片檔
yt-dlp --embed-subs --sub-langs "zh-TW" "影片網址"
```
自訂檔案名稱
使用 -o 或 --output 選項來定義輸出檔案的名稱和路徑。
```
# 將影片儲存為 "我的影片.mp4"
yt-dlp -o "我的影片.mp4" "影片網址"
# 使用影片標題和上傳者名稱來命名
yt-dlp -o "%(title)s - %(uploader)s.%(ext)s" "影片網址"
```
5. 總結常用指令
- 更新 yt-dlp: `yt-dlp -U`
- 下載最高畫質影片: `yt-dlp -f "bestvideo+bestaudio/best" "影片網址"`
- 下載 MP3 音訊: `yt-dlp -x --audio-format mp3 "影片網址"`
- 下載整個播放清單: `yt-dlp "播放清單網址"`
6. 使用設定檔 (Configuration File)
如果您經常使用相同的下載選項組合，可以將它們寫入一個設定檔中，這樣每次執行 yt-dlp 時就會自動套用，省去重複輸入的麻煩。
設定檔位置
您需要在以下對應的路徑手動建立設定檔：
- **Windows**: %APPDATA%\yt-dlp\config.txt (通常是 C:\Users\您的使用者名稱\AppData\Roaming\yt-dlp\config.txt)
- **macOS & Linux**: ~/.config/yt-dlp/config (通常是 /home/您的使用者名稱/.config/yt-dlp/config)
設定檔範例
您可以像在命令列一樣，將常用的選項一行一個地寫入設定檔中。# 號開頭的行是註解，會被忽略。
```
# 這是一個 yt-dlp 設定檔範例
# 預設下載最佳畫質的影片和音訊，並合併成 MKV 格式
-f "bestvideo+bestaudio/best"
--merge-output-format mkv
# 如果要下載純音訊，預設轉為 MP3 (因與上方設定衝突，預設註解)
# -x
# --audio-format mp3
# --audio-quality 0
# 在播放清單下載遇到錯誤時，忽略錯誤並繼續
-i
# 輸出檔案名稱格式
# (註：~ 代表使用者主目錄，在 Windows, macOS, Linux 上皆可正常運作)
-o "~/Downloads/%(title)s - [%(id)s].%(ext)s"
```
暫時停用設定檔
如果您某次下載不想使用設定檔中的選項，可以在指令中加入 --ignore-config。
```
yt-dlp --ignore-config [其他選項] "影片網址"
```
yt-dlp 功能非常強大，這份指南只涵蓋了最常見的用法。您可以執行 `yt-dlp --help` 來查看所有可用的選項，探索更多可能性。