用 yt-dlp 下載影片與字幕(簡單粗暴、快速有效)

自 COVID-19 疫情之後，網路上常會有精彩的課，以及我來不及參與直播的課，所以我會有將這些影片下載回來補課的需求。

可將影片下載的方法工具有不少，目前試過了一些，其中最「簡單粗暴、快速有效」的工具當屬 yt-dlp 了。

很多人不喜歡他，因為他需要直接打指令，所以便直接略過他。
還好，我不避諱打指令，所以一用便成老主顧。

yt-dlp 最新版網址如下，目前支援許多作業系統：
https://github.com/yt-dlp/yt-dlp/releases/

因為 Youtube 會更新他們的網站配置，所以已下載使用者，遇到影片下載不下來情況，到以上網址，下載最新版本便可以，或是直接更新。

1. 直接下載影片

yt-dlp 網址(例：https://www.youtube.com/watch?v=6Pl7lX0G634)
這樣便可以不管三七二十一直接將影片下載了。

或是， yt-dlp -f mp4 網址(例：https://www.youtube.com/watch?v=6Pl7lX0G634)
指定下載 mp4 格式的影片回來！

2. 下載影片播放清單

yt-dlp –yes-playlist [播放清單網址]

3. 批次下載影片

想要一次下載多個影片，先將影片網址儲存到一個文字檔: urls.txt（每行一個網址），然後
yt-dlp –output “%(title)s.%(ext)s” –batch-file urls.txt –embed-thumbnail –add-metadata –merge-output-format mp4

4. 影片字幕下載（前題：影片有提供字幕）

補充

若真無法接受手打指令，又想使用 yt-dlp 下載影片者，可以使用神人雄哥的作品：https://tinyurl.com/gsyan-yt-dlp，一切都在網頁上執行。

2026/09/10 增錄

使用yt-dlp下載Youtube會出現無法下載情況。錯誤訊息如下：

chungyu@ChungYuGenuine:~/Downloads$ yt-dlp https://www.youtube.com/watch?v=rkzy9sV7Q68
[youtube] Extracting URL: https://www.youtube.com/watch?v=rkzy9sV7Q68
[youtube] rkzy9sV7Q68: Downloading webpage
WARNING: [youtube] No supported JavaScript runtime could be found. Only deno is enabled by default; to use another runtime add  --js-runtimes RUNTIME[:PATH]  to your command/config. YouTube extraction without a JS runtime has been deprecated, and some formats may be missing. See  https://github.com/yt-dlp/yt-dlp/wiki/EJS  for details on installing one
[youtube] rkzy9sV7Q68: Downloading visionos player API JSON
ERROR: [youtube] rkzy9sV7Q68: This video is not available

查了相關資料，原因可能是：缺少 JS 運行環境可能影響解析。

解決方法：安裝 Deno 或 Node.js，並透過 –js-runtimes 指定，同時將 yt-dlp 更新至最新版本。

安裝 Deno :
curl -fsSL https://deno.land/install.sh | sh

安裝完成後，安裝程式會把執行環境參數放到　~/.bashrc 或　~/.profile 檔案的最後一行：
source /home/chungyu/.local/share/bash-completion/completions/deno.bash

建議重新讀一次環境變數： source ~/.bashrc ，讓系統可以抓到　Deno 後，便可以透過　yt-dlp 順利下載影片。

參考資源

1. yt-dlp 專案：https://github.com/yt-dlp/yt-dlp
2. 雄哥影音下載專案：https://tinyurl.com/gsyan-yt-dlp
3. FFMPEG Download：https://www.ffmpeg.org/download.html