video-download
使用 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: command not found」:請安裝 yt-dlp(
pip install yt-dlp)並確保 PATH 包含 pip 的 bin 目錄。 - 「ffmpeg: command not found」:請安裝 ffmpeg。若缺少它,當影片與音訊為獨立串流(YouTube 的 HD 內容常見)時,下載會失敗。
- 下載失敗或回傳錯誤:執行
yt-dlp -U進行更新。網站頻繁變更,yt-dlp 會定期釋出修正。