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 的安裝
- 僅下載單一影片(預設跳過播放清單)
- 較高畫質的影片可能需要更長的下載時間,並佔用更多磁碟空間