YouTube 影片下載器
以完全控制畫質與格式設定來下載 YouTube 影片。
快速開始
下載影片最簡單的方式:
python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
這會將影片以最佳可用畫質下載為 MP4,並儲存至 /mnt/user-data/outputs/。
選項
畫質設定
使用 -q 或 --quality 來指定影片畫質:
best(預設):最高可用畫質1080p:Full HD720p:HD480p:標準畫質360p:較低畫質worst:最低可用畫質
範例:
python scripts/download_video.py "URL" -q 720p
格式選項
使用 -f 或 --format 來指定輸出格式(僅限影片下載):
mp4(預設):最相容webm:現代格式mkv:Matroska 容器
範例:
python scripts/download_video.py "URL" -f webm
僅下載音訊
使用 -a 或 --audio-only 來僅下載音訊為 MP3:
python scripts/download_video.py "URL" -a
自訂輸出目錄
使用 -o 或 --output 來指定不同的輸出目錄:
python scripts/download_video.py "URL" -o /path/to/directory
完整範例
- 以 1080p 下載影片為 MP4:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
- 僅下載音訊為 MP3:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
- 以 720p 下載為 WebM 至自訂目錄:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path
運作原理
此技能使用 yt-dlp,一個功能強大的 YouTube 下載工具,它會:
- 若未安裝則自動安裝
- 在下載前擷取影片資訊
- 選取符合條件的最佳可用串流
- 在需要時合併影片與音訊串流
- 支援多種 YouTube 影片格式
重要注意事項
- 下載的影片預設儲存至
/mnt/user-data/outputs/ - 影片檔案名稱會自動依據影片標題產生
- 腳本會自動處理 yt-dlp 的安裝
- 僅下載單一影片(預設會跳過播放清單)
- 較高畫質的影片可能需要更長時間下載,並使用更多磁碟空間