name: yt-dlp description: 一个强大的yt-dlp命令行封装工具,用于从YouTube及数千个其他网站下载视频、播放列表和音频。支持格式选择、质量控制、元数据嵌入和Cookie身份验证。
yt-dlp 技能
概述
此技能提供了一个便捷的接口来使用yt-dlp,这是一个功能强大的命令行媒体下载器。它简化了下载视频、提取音频和管理播放列表的过程,并提供最优的质量设置和元数据处理。
使用方法
- 角色: 媒体档案管理员。
- 触发指令: “下载这个视频”、“从YouTube获取MP3”、“归档这个频道”。
- 输出: 在当前目录或指定输出路径中生成已下载的媒体文件。
依赖项
yt-dlp: 核心下载器(必须安装在PATH中)。ffmpeg: 用于合并视频/音频流和格式转换。
命令
scripts/download.sh
主要入口点。它包装了yt-dlp,并为高质量归档提供了合理的默认设置。
语法:
./scripts/download.sh <URL> [选项]
默认设置:
- 最佳视频 + 最佳音频合并 (
bv+ba/b) - 嵌入元数据、缩略图和字幕 (
--embed-metadata,--embed-thumbnail,--embed-subs) - 输出格式:
标题 [ID].mp4(%(title)s [%(id)s].%(ext)s)
示例:
-
下载单个视频(最佳质量):
scripts/download.sh "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -
下载播放列表:
scripts/download.sh "https://www.youtube.com/playlist?list=PL..." -
提取音频(MP3):
scripts/download.sh "URL" -x --audio-format mp3 -
下载特定分辨率(例如,1080p):
scripts/download.sh "URL" -f "bv*[height<=1080]+ba/b[height<=1080]" -
使用Cookie(用于年龄限制/会员内容): 注意:需要将浏览器Cookie导出到文件或直接访问。
scripts/download.sh "URL" --cookies-from-browser chrome
安装与安全
此技能依赖于主机系统上已安装的yt-dlp和ffmpeg。
- 仅限官方来源: 通过
pip install yt-dlp或系统包管理器(apt、brew)安装。避免运行来自不受信任来源的curl脚本。 - Cookie: 谨慎使用
--cookies-from-browser。对于自主代理,建议手动导出cookies.txt文件,以限制对您活动浏览器会话的访问。
参考指南
有关高级用法,请参阅全面的使用指南。