video-dl

📥 千站视频一键下载神器

基于 yt-dlp 的跨平台视频下载工具,支持 1000+ 网站,提供音视频分离、格式压缩等实用功能,满足内容创作者和用户的离线观看需求。

收藏
1.7k
安装
836
版本
v1.1.0
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

核心用法

Video Downloader 是一款基于 yt-dlp 构建的视频下载技能,支持从 YouTube、Reddit、Twitter/X、TikTok、Instagram、Vimeo、Facebook、Twitch 等 1000 多个网站下载视频内容。用户只需提供视频链接,即可通过简单的命令行调用完成下载。基础用法为 {baseDir}/scripts/download.sh "URL",默认以最佳质量下载到 ~/Downloads/videos// 目录。技能还提供丰富的可选参数,包括 --audio-only 提取音频为 MP3、、--720p//--1080p 限制分辨率、、--output 指定输出目录、、--filename` 自定义文件名等。

针对 Telegram 等平台的 16MB 文件限制,技能特别设计了压缩发送功能,通过 compress-and-send.sh 脚本在后台处理长视频,避免聊天窗口被进度信息刷屏。高级用户还可直接调用 ~/.local/bin/yt-dlp 使用 yt-dlp 的全部功能。

显著优点

1. 覆盖范围极广:依托 yt-dlp 的强大生态,支持 1000+ 视频网站,几乎涵盖所有主流平台
2. 功能灵活多样:不仅支持视频下载,还能提取音频、限制分辨率、自定义输出路径,满足多种场景需求

3. 自动化处理完善:Reddit 视频的音视频自动合并、Telegram 压缩的异步后台处理等细节设计提升用户体验

4. 代码质量可靠:脚本采用 Bash 数组传递参数,有效防止命令注入;使用 set -e 确保错误及时暴露

5. 隐私保护良好:纯本地操作,无数据上传行为,下载内容仅存储在用户指定目录

潜在缺点与局限性

1. 依赖外部工具:必须预先安装 yt-dlp 和 ffmpeg,且需用户自行确保来源可信、版本更新
2. URL 安全验证不足:未对输入链接进行恶意网站过滤或格式校验,存在潜在安全风险

3. 年龄限制内容支持有限:YouTube 年龄限制视频需要 cookies 配置,当前未提供该功能

4. 长视频处理耗时:大文件下载和压缩需要较长时间,虽有后台处理方案但用户体验仍受影响

5. 版权合规责任在用户:技能本身不提供版权检查,批量下载或商业使用可能违反平台服务条款

适合的目标群体

  • 内容创作者:需要收集参考素材、保存灵感视频的设计师、视频博主、自媒体运营者
  • 研究人员与教育工作者:下载教学视频、学术讲座等用于离线学习或课堂展示
  • 普通用户:希望在没有网络的环境下观看喜欢的视频内容
  • Telegram 社群运营者:需要分享视频内容但受限于平台文件大小限制的用户

使用风险

1. 依赖项安全风险:yt-dlp 和 ffmpeg 若从非官方渠道安装,可能引入恶意代码
2. URL 注入风险:尽管脚本本身做了参数防护,但用户若输入恶意构造的链接仍可能导致非预期行为

3. 存储空间压力:高清视频文件体积庞大,可能快速耗尽磁盘空间

4. 法律合规风险:下载受版权保护的内容用于商业用途或公开传播可能面临法律问题

5. 元数据泄露:下载的视频文件可能包含地理位置、设备信息等敏感元数据

安全解读

核心用法

video-dl 是一款基于 yt-dlp 的视频下载 Skill,支持从 YouTube、Reddit、Twitter/X、TikTok、Instagram 等 1000 多个网站下载视频内容。核心使用方式是通过 {baseDir}/scripts/download.sh "URL" 命令进行快速下载,默认保存至 ~/Downloads/videos/ 目录并自动选择最佳画质。

该 Skill 提供多种实用选项:

  • 音频提取--audio-only 可直接提取 MP3 音频
  • 画质限制--720p--1080p 可限制最大分辨率
  • 自定义输出--output DIR--filename NAME 支持灵活的目录和命名配置

此外还集成 Telegram 视频压缩发送功能,针对 16MB 文件限制自动处理长视频。

显著优点

1. 覆盖范围极广:依托 yt-dlp 项目支持 1000+ 视频网站,几乎涵盖所有主流平台
2. 功能专一清晰:代码结构简洁(约 140 行、4 个文件),功能边界明确,无隐藏行为

3. 依赖工具成熟:yt-dlp 和 ffmpeg 均为行业标准的开源工具,社区活跃、更新频繁

4. 隐私合规良好:不收集用户敏感数据,仅处理用户主动提供的视频 URL

5. 实用辅助功能:自动处理 Reddit 音视频合并、Telegram 压缩发送等常见场景

潜在缺点与局限性

1. 子进程执行风险:必须调用 yt-dlp 和 ffmpeg 外部工具,存在潜在的命令注入风险(当前版本仅做基础 URL 空值检查)
2. 来源可信度 T2:由个人开发者 dimitryvin 维护,虽托管于可信 GitHub 仓库,但账户安全需持续关注

3. 年龄限制内容:YouTube 等平台的部分年龄限制视频需要 cookies 配置,当前未默认支持

4. 长视频处理耗时:超大文件下载和 Telegram 压缩需要较长时间,需后台运行

5. 网络依赖性强:依赖各视频平台的 API 稳定性,平台政策变化可能导致功能失效

适合人群

  • 需要离线保存教学视频、纪录片、播客等内容的学习者
  • 内容创作者进行素材收集和二次创作(需遵守平台版权条款)
  • 希望绕过平台限制、自主管理视频文件的技术用户
  • Telegram 用户需要分享视频但受文件大小限制困扰的场景

常规风险

  • 版权合规风险:下载受版权保护的内容可能违反平台服务条款或当地法律,用户需自行承担法律责任
  • URL 注入风险:恶意构造的 URL 参数理论上可能注入额外命令,建议避免复制来源不明的链接
  • 自动更新风险:yt-dlp 频繁更新以应对平台变化,可能引入未预期的行为变化
  • 账户安全风险:若维护者账户被入侵,后续更新可能包含恶意代码,建议关注社区反馈

video-dl 内容

scripts文件夹
手动下载zip · 3.3 kB
compress-and-send.shtext/x-shellscript
请选择文件