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