输入各类视频网站/播客平台链接后,自动下载对应媒体文件并交付给用户。优先使用 yt-dlp 覆盖抖音(Douyin)、B站(Bilibili)、YouTube 等常见视频网站,也可用于可直接暴露音频地址的播客平台(如小宇宙单集链接)。当遇到 403/登录/年龄或地区限制时,支持使用 cookies.txt 重试;对于可能存在 DRM/加密或条款限制的平台(例如部分 Spotify 内容),应提示用户仅下载其有权保存的内容,并在不可下载时建议改用官方离线/导出渠道或提供原始 RSS/直链。注意:抖音图文笔记暂不支持自动下载,需手动处理。
优先覆盖(通常可直接用)
douyin.com、v.douyin.com 等视频链接bilibili.com、b23.tv 等youtube.com、youtu.be播客平台
合规提示:仅用于下载你有权保存的内容(例如你自己上传/拥有版权/获得授权/平台允许离线的内容)。遇到 DRM/加密或平台限制时,不要尝试绕过。
命令:
python scripts/download_media.py "<URL>"默认保存目录:
downloads/ 文件夹(自包含)--out-dir 参数自定义输出路径python scripts/download_media.py --audio-only --audio-format mp3 "<URL>"让用户提供浏览器导出的 Netscape 格式 cookies.txt
然后重试:
python scripts/download_media.py --cookies "/path/to/cookies.txt" "<URL>"--proxy "socks5://127.0.0.1:7890"--out-dir 参数--out-dir ~/Desktop--out-dir "~/Videos/bilibili"YouTube/B站/抖音:
--remote-components ejs:github),或让用户提供 cookiesSpotify:
scripts/download_media.py
yt-dlp 的通用下载器SAVED_FILEPATH=...--out-dir 参数url(必填)--audio-only / --audio-format--subtitles(可选,自动下载字幕)--sub-lang(可选,字幕语言,默认 all)--cookies(可选)--proxy(可选)--out-dir(可选,自定义输出目录)| 依赖 | 安装方式 |
|---|---|
yt-dlp | pip install yt-dlp |
ffmpeg(可选,用于字幕提取和音频转换) | macOS: brew install ffmpeg<br>Linux: sudo apt-get install ffmpeg |
无需额外 Python 依赖,yt-dlp 已包含所需库。