YouTube 视频下载器
以完全控制质量和格式设置的方式下载 YouTube 视频。
快速开始
下载视频的最简单方式:
python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
这会以最佳可用质量下载视频为 MP4 格式,并保存到 /mnt/user-data/outputs/。
选项
质量设置
使用 -q 或 --quality 指定视频质量:
best(默认):最高可用质量1080p:全高清720p:高清480p:标清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 的安装
- 仅下载单个视频(默认跳过播放列表)
- 质量越高的视频下载时间越长,占用磁盘空间也越多