影片下載
使用 yt-dlp 直接從網址下載影片和音訊,無需包裝腳本。
前置需求
- yt-dlp:
brew install yt-dlp或pip install yt-dlp - ffmpeg:
brew install ffmpeg或apt install ffmpeg(合併影音串流時需要)
定期更新 yt-dlp 以跟上網站變更:yt-dlp -U 或 pip install -U yt-dlp。
指令
下載最佳品質
yt-dlp "URL" -o "%(title)s.%(ext)s" --merge-output-format mp4
下載指定解析度
# 720p
yt-dlp "URL" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --merge-output-format mp4
# 1080p
yt-dlp "URL" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4
僅音訊
yt-dlp "URL" -x --audio-format mp3 --audio-quality 0
下載字幕
# 下附英文字幕的影片
yt-dlp "URL" --write-subs --sub-langs en --merge-output-format mp4
# 下附多語言字幕的影片
yt-dlp "URL" --write-subs --sub-langs "en,es,fr" --merge-output-format mp4
# 僅下載字幕(不下載影片)
yt-dlp "URL" --write-subs --sub-langs en --skip-download
取得中繼資料(不下載)
yt-dlp "URL" --dump-json --no-download
列出可用格式
yt-dlp "URL" -F
指定輸出目錄
yt-dlp "URL" -o "./downloads/%(title)s.%(ext)s" --merge-output-format mp4
品質預設
| 品質 | 格式旗標 |
|---|---|
| 最佳 | -f "bestvideo+bestaudio/best"(預設) |
| 1080p | -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" |
| 720p | -f "bestvideo[height<=720]+bestaudio/best[height<=720]" |
| 480p | -f "bestvideo[height<=480]+bestaudio/best[height<=480]" |
| 最差 | -f "worstvideo+worstaudio/worst" |
輸出範本變數
-o 範本的常用變數:
| 變數 | 說明 |
|---|---|
%(title)s | 影片標題 |
%(ext)s | 副檔名 |
%(id)s | 影片 ID |
%(uploader)s | 頻道/上傳者名稱 |
%(upload_date)s | 上傳日期(YYYYMMDD) |
%(duration)s | 持續時間(秒) |
%(resolution)s | 影片解析度 |
提示
- 務必使用
--merge-output-format mp4,避免產生.webm或.mkv檔案。 - 使用
--no-download搭配--dump-json進行僅中繼資料查詢,不會在磁碟寫入任何檔案。 - 若下載因 HTTP 錯誤失敗,請先更新 yt-dlp(
yt-dlp -U)。 - 在不需要完整解析度時,使用
-f "bestvideo[height<=720]+bestaudio"節省頻寬。 - yt-dlp 會自動處理速率限制與重試。
--dump-json的輸出包含title、duration、uploader、view_count、description、formats、subtitles等豐富資訊。
疑難排解
- 「找不到 yt-dlp 指令」:安裝 yt-dlp(
pip install yt-dlp)並確認 PATH 包含 pip 的二進位目錄。 - 「找不到 ffmpeg 指令」:安裝 ffmpeg。缺少它時,若影片與音訊為分離串流(YouTube HD 常見),下載將失敗。
- 下載失敗或回傳錯誤:執行
yt-dlp -U進行更新。網站經常變更,yt-dlp 會定期推出修正。