用途:通过 yt-dlp 与 ffmpeg 下载 YouTube 视频文件或提取 MP3 音频,默认选择最高可用画质与音质。
前置条件:需安装 yt-dlp(youtube-dl 的推荐分支)与 ffmpeg(用于合并与转码)。安装示例(Linux/macOS):python3 -m pip install -U yt-dlp,或使用官方发布脚本安装;ffmpeg 可用 sudo apt install ffmpeg(Debian/Ubuntu)或 brew install ffmpeg(macOS)。Windows 使用 yt-dlp.exe 并单独安装 ffmpeg。
主要能力:
- 下载最高画质视频并合并为 MP4:yt-dlp -f "bestvideo+bestaudio/best" --merge-output-format mp4 -o "%(title)s.%(ext)s" <VIDEO_URL>。
- 限制最大分辨率(如 1080p):在 -f 中使用 bestvideo[height<=1080]。
- 导出 MP3(最高质量):yt-dlp -x --audio-format mp3 --audio-quality 0 -o "%(title)s.%(ext)s" <VIDEO_URL>;如需 320kbps 恒定码率可加 --postprocessor-args "-b:a 320k"。
- 下载整个播放列表并保留顺序,输出模板用 %(playlist_index)s;仅下载列表中单个视频可加 --no-playlist。
- 仅下载最佳音频(不转码):yt-dlp -f bestaudio。
- 按时间段下载并配合 ffmpeg 后处理:使用 --external-downloader ffmpeg 与 --external-downloader-args "-ss 00:01:00 -to 00:02:00"。
使用方式与建议:命令可组合进脚本,使用环境变量传入 URL 与输出目录;用 --no-overwrites 避免覆盖,用 --download-archive archive.txt 避免重复下载,用 --quiet 便于脚本化并检查退出码。
限制:应遵守 YouTube 服务条款与版权法律,仅下载你拥有权利或已获授权的内容;注意缓存与请求频率以避免触发限流。其他细节暂未提供。