影片下載技能
使用 yt-dlp 直接從 URL 下載影片和音訊,無需包裝腳本。
先決條件
- 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 命令」:安裝它(
pip install yt-dlp),並確保你的 PATH 包含 pip 的 bin 目錄。 - 「找不到 ffmpeg 命令」:安裝 ffmpeg。缺少它時,如果影片和音訊是分離的串流(在 YouTube 的高畫質影片中很常見),下載將會失敗。
- 下載失敗或回傳錯誤:執行
yt-dlp -U進行更新。網站經常變更,而 yt-dlp 會定期發布修正。