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 "網址" -q 720p
格式選項
使用 -f 或 --format 指定輸出格式(僅限影片下載):
mp4(預設):相容性最高webm:現代格式mkv:Matroska 容器
範例:
python scripts/download_video.py "網址" -f webm
僅下載音訊
使用 -a 或 --audio-only 僅下載音訊並存為 MP3:
python scripts/download_video.py "網址" -a
自訂輸出目錄
使用 -o 或 --output 指定不同輸出目錄:
python scripts/download_video.py "網址" -o /路徑/到/目錄
完整範例
- 下載 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 /自訂/路徑
運作原理
此技能使用 yt-dlp,一個強大的 YouTube 下載工具,具備以下功能:
- 若尚未安裝則自動安裝
- 下載前擷取影片資訊
- 選擇符合您條件的最佳可用串流
- 必要時合併視訊與音訊串流
- 支援多種 YouTube 影片格式
重要備註
- 下載的檔案預設儲存於
/mnt/user-data/outputs/ - 影片檔名會根據影片標題自動產生
- 腳本會自動處理 yt-dlp 的安裝
- 預設僅下載單一影片(會跳過播放清單)
- 較高畫質的影片可能需要較長下載時間與更多磁碟空間