一键下载：多平台视频下载命令行工具
z-video-downloader 是 tjxj/z-skills 这个"可复用 skills 集合"仓库里的一个视频下载工具（Python，脚本 scripts/download_video.py）。它的核心能力一句话：把视频链接下载成本地视频文件，支持 YouTube、Bilibili、Vimeo、X/Twitter、TikTok、抖音、Instagram、Facebook、微信视频号 等平台以及常见视频直链。
它基于 yt-dlp（平台视频）+ requests + ffmpeg（音视频合并）搭建，外层封装了批量下载、断点续传、字幕 / 封面 / 元数据、下载历史去重、平台风控自动 cookie 重试等实用能力。最亮眼的点是：微信视频号分享链接可以在线解析下载——识别 https://weixin.qq.com/sph/xxx 格式的链接，通过在线解析服务自动获取视频真实地址并下载，无需微信登录态、无需安装证书、无需修改系统代理，还默认同时保存 H.264（高清兼容版）和 H.265（省空间版）两个版本。
所在合集 z-skills（tjxj）在 GitHub 上已获 555 Star，2026-09 仍在更新，Python 语言。
请遵守版权与平台规则：项目仅用于技术交流学习，请尊重内容创作者权益，只下载你有权访问和保存的内容，勿用于任何非法用途。
核心亮点
- 微信视频号在线解析：免登录 / 免证书 / 免改代理，sph 分享链接直接下载，H.264+H.265 双保存
- 多平台：YouTube / B站 / Vimeo / X / TikTok / 抖音 / IG / Facebook / 视频直链
- 批量下载：单个 / 多个 / url-file 批量链接一次搞定
- 断点续传：直链 .part + HTTP Range / yt-dlp 分片续传
- 风控自动重试：平台风控时自动带 cookie 重试
- 附带元数据：字幕 / 封面 / 元数据，历史去重
它能做什么
| 能力 | 说明 |
|---|---|
| 微信视频号 | sph 分享链接在线解析，免登录免证书，H.264+H.265 双版保存，文件名自动生成 |
| 主流平台 | YouTube / Bilibili / Vimeo / X / TikTok / 抖音 / Instagram / Facebook |
| 批量与续传 | 单 / 多 / 批量链接；.part+Range 断点续传、yt-dlp 分片续传 |
| 元数据 | 字幕、封面、元数据；下载历史去重 |
| 风控重试 | 平台风控自动 cookie 重试 |
| 技术栈 | Python 3.10+、yt-dlp、requests、ffmpeg |
环境要求
| 环境 | 说明 |
|---|---|
| Python | 3.10+ |
| 依赖 | requests、yt-dlp（平台视频）、ffmpeg（音视频合并） |
| 适用平台 | Windows / macOS / Linux（命令行运行） |
| 协议/性质 | 技能合集内脚本，以仓库 LICENSE 为准 |
效果图与演示
效果演示示意（本项目为命令行工具，图为演示示意）。
如何使用
最快路径：把脚本 clone 下来，装上 yt-dlp 和 ffmpeg，一条命令传视频链接即可。
拉取代码与装依赖
git clone https://github.com/tjxj/z-skills.git，进入 z-video-downloader 目录，然后 pip install requests yt-dlp，并安装 ffmpeg（Windows: winget/choco；macOS: brew install ffmpeg）。
下载一个视频
python3 scripts/download_video.py --title "主题名" "https://www.youtube.com/watch?v=..."；Bilibili 同理传 BV 链接。
微信视频号下载（亮点）
python3 scripts/download_video.py --title "视频号主题" "https://weixin.qq.com/sph/Axv548mzBF"，默认同时保存 H.264 和 H.265 两个版本。
批量下载
把链接逐个写入 video-urls.txt（每行一个），python3 scripts/download_video.py --title "主题名" --url-file "video-urls.txt"。
典型应用场景
- 保存微信视频号：收藏重要的视频号内容，免登录在线解析下载到本地
- 离线学习：把教程 / 公开课视频存本地，没网也能看
- 剪辑素材：下载视频作为二次创作素材（注意版权）
- 资料归档：批量保存收藏夹内容，断点续传不怕中断
- 音频提取：配合 ffmpeg 提取视频中的音频 / 字幕
- 脚本化批量：写进自己的脚本 / 流水线做定时采集
与同类做法对比
| 做法 | 定位 | 权衡 |
|---|---|---|
| 网页在线解析站 | 免安装在线下载 | 方便但要上传链接到第三方、常有广告 / 限制 / 失效 |
| yt-dlp 裸用 | 通用下载引擎 | 强大但要自己拼命令、处理平台差异 / 风控 |
| z-video-downloader | 封装好的下载 skill | 封装批量 / 续传 / 去重 / 风控重试，最亮眼是视频号在线解析；是合集子项，非独立大项目 |
原理一句话：核心是 yt-dlp（解析各平台并下载）+ ffmpeg（合并音视频流）；微信视频号是调用公开的在线解析服务（上游 ltaoo/wx_channels_download 的 sph.litao.workers.dev）把 sph 分享链接换算成真实视频地址再下载，所以本地不用装证书、不用登录态。
常见问题
Q: z-video-downloader 是什么？ tjxj/z-skills 合集里的一个 Python 视频下载工具，把视频链接下载成本地文件，支持 YouTube/B站/抖音/微信视频号等多平台及直链。
Q: 微信视频号能下载吗？ 能，这是它最亮眼的点。识别 weixin.qq.com/sph/xxx 分享链接，通过在线解析服务自动拿真实地址下载，免登录、免装证书、免改代理，默认保存 H.264+H.265 双版本。
Q: 需要什么环境？ Python 3.10+、requests、yt-dlp、ffmpeg。命令行运行，Windows/macOS/Linux 均可。
Q: 能批量下载吗？ 能。用 --url-file 指定一个每行一个链接的文本文件即可。
Q: 下载中断怎么办？ 支持断点续传：直链用 .part + HTTP Range，yt-dlp 走分片续传，中断后可接着下。
Q: 有没有图形界面？ 没有，是命令行工具。如果你要图形界面，可考虑 yt-dlp 的 GUI 前端或浏览器扩展。
Q: 是否合法？ 项目声明仅用于技术交流学习。请遵守法律法规与各平台规则，尊重创作者权益，只下载你有权访问和保存的内容。
Q: Star 数是多少？ z-video-downloader 是合集 z-skills 的子目录，整个 z-skills 仓库当前 555 Star（2026-10 实测）。