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` 來查看所有可用的選項，探索更多可能性。