# vidkit
**Repository Path**: shawn-wow/vidkit
## Basic Information
- **Project Name**: vidkit
- **Description**: Vidkit是一款功能全面且界面简洁的视频下载工具，支持1000+国内外主流视频平台。
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-01-04
- **Last Updated**: 2025-06-11
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Vidkit 使用指南
## 一、简介
Vidkit是一款功能全面且界面简洁的视频下载工具，专为满足用户从各大视频平台轻松获取心仪视频资源的需求而设计。vidkit支持断点续传功能，这对于处理耗时较长的下载任务而言极为实用，能够确保用户在网络中断或暂停下载后，随时无缝继续下载进程，大大提高了下载效率和便捷性。此外，当切换至“直接下载”模式时，vidkit化身为一款操作简便的资源下载利器，其相较于浏览器下载的最大亮点，正是那超级实用的断点续传能力。
[最新版本下载链接](https://gitee.com/shawn-wow/vidkit/releases)
### 注意事项：
- 关于软件下载安装被操作系统（Windows）或安全软件阻止，提示不信任。原因是我们还没有给证书认证机构交保护费（每年大几千元，肉疼），没有证书对vidkit进行签名，不被信任。建议您暂时以管理员身份运行或调整系统设置以允许安装。
- 首次启动程序时，会下载必要组件（ffmpeg）。之所以不将组件集成到安装包中，是因为在Gitee发布版本时，附件大小被限制在最高100M以内，而加入组件后安装包会超出此限制。若组件下载安装失败，请重新安装软件。
- 软件下载与必要组件下载速度受Gitee限制，一般为500KB/s。
- V2解析引擎有时需科学上网支持，若您不具备此条件，请务必在解析引擎链中移除V2，以避免解析速度减慢10秒。
## 二、主要功能
### 2.1 视频解析&下载
- 视频解析支持1000+国内外平台链接解析
国内主流短视频平台：腾讯视频、优酷、搜狐、A站、B站、小红书、抖音、快手、西瓜、知乎、百度快看、微博、央视频、芒果TV、...
国外主流视频网站：YouTube、DailyMotion、vimeo、VKonatakte、TikTok、Facebook、Twitch、Snapchat、...
- 自动解析视频标题和缩略图
- 支持自定义下载路径
- 显示下载进度和速度
### 2.2 【♬】 下载MP3
vidkit具备从视频中下载音频（MP3格式）的功能。对于音频与视频分离的平台数据（例如YouTube、B站上的无声音MP4和无画面MPA文件），工具将直接下载音频部分。若平台提供的视频数据为音视频合一格式，vidkit先下载整个视频文件，随后精准提取其中的音频内容（已下载的视频文件不会删除）。
### 2.3 【直接下载 】
考虑到许多朋友仅依赖浏览器进行下载，且在浏览器退出后往往无法恢复下载任务，只能无奈重零开始。为解决这一困扰，我们决定充分利用vidkit下载器强大的断点续传功能，将其开放。如此一来，vidkit 便成为了一款简单而实用的下载工具。即使在下载中途浏览器意外退出，用户再次打开时，vidkit 也能精准定位到断点位置，无缝继续下载任务，无需再从头开始，极大地节省了用户的时间和精力。
比如作者要从[OBS官网](https://obsproject.com/)下载OBS Studio（一款免费开源且功能强大的视频录制工具），其下载速度超慢，应该是官网限速。在浏览器点击下载后，将下载链接复制粘贴到vidkit进行下载，如图：
## 三、辅助下载
### 3.1 【导入Cookie数据】
在使用解析引擎V1解析YouTube视频时，若需下载视频，您必须提供在YouTube上的登录信息。同样地，为了使用V1引擎解析B站更高清晰度的视频，您也需要导入B站的登录Cookies。以下是获取Cookie数据的步骤：
1. **登录您的账号**：首先，请确保您已在浏览器中登录了您的YouTube或B站账号。
2. **安装浏览器插件**：接下来，安装名为“**Get cookies.txt LOCALLY**”的浏览器插件。此插件能够帮助您将Cookie数据导出到本地。该插件支持chrome，firefox，edge。
在Chrome 应用商店中安装 [Get cookies.txt LOCALLY](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc?pli=1)；
去Github上官方项目release下载[Get cookies.txt LOCALLY](https://github.com/kairi003/Get-cookies.txt-LOCALLY/releases)；
去Gitee上下载[Get cookies.txt LOCALLY](https://gitee.com/shawn-wow/vidkit/tree/main/plugins)；因Chrome应用商店和Github可能需要特殊上网条件，作者将这个插件从Github搬一份到Gitee。
3. **导出Cookie数据**：安装完成后，打开插件界面，选择【Export All Cookies】选项，将您的Cookie数据导出到本地文件中。这个文件将包含您登录账号所需的Cookie信息。
### 3.2 【配置解析引擎】
#### 解析引擎简介
为保证能覆盖更多的平台，vidkit内置了六大解析引擎（V1, V2, V3, V4, V5, V6），互为补充。这些引擎均源自开源社区，由于视频平台的升级（加鉴权等），可能会导致引擎不失效或者能视频质量下降。
| 引擎 | 描述 | 优点 | 缺点 |
| --- | ------------------------------------------------------------------------------ | -------------------------------------------- | ------------------------- |
| V1 | 支持1000+国内外平台。国内如哔哩哔哩、小红书、优酷、腾讯、央视网等，国际如YouTube、Facebook、TikTok、Twitch、ESPN等。 | 视频质量高，部分网站（如哔哩哔哩，YouTube）需使用cookie以获取更高质量视频； | 不支持下载链接分享。 |
| V2 | 支持100+国内外平台。国内如哔哩哔哩、小红书、抖音、快手、西瓜等，国际如Tiktok、Vimeo、Facebook、Twitter、Instagram等。 | 视频质量高；支持下载链接分享； | 解析速度稍慢，可能需要科学上网【**已经挂B**】 |
| V3 | 支持50+国内外平台。国内如哔哩哔哩、微博、腾讯、酷我等，国际如Tiktok、TED、Facebook、Twitter、Instagram等。 | 支持下载链接分享。 | |
| V4 | 支持20+国内大小平台（如西瓜、抖音、快手，哔哩哔哩、火山、秒拍、皮皮虾等）和少部分国际平台（如twitter、TikTok等）。 | 支持下载链接分享。 | |
| V5 | 支持平台：国内如哔哩哔哩、抖音等，国际如TikTok、Facebook、Pinterest、VKontakte、Threads等国。支持下载链接分享。 | 解析速度超快；支持下载链接分享 | 支持支持平台少 |
| V6 | 支持10+国内外主流平台如抖音、快手、小红书、哔哩哔哩、YouTube、TikTok等。 | 支持下载链接分享。 | 有些视频无封面；而且每日解析次数有限。 |
#### 主流平台实测支持情况
下表是对各引擎的测试，按视频分辨率排序。使用**【配置解析引擎】->【测试模式】**测试各个引擎下载同一视频链接，测试时间截止20250225。[点击查看测试数据](https://gitee.com/shawn-wow/vidkit/raw/main/test/vidkit-engins-test-20250225.txt)
注：表格只是每个平台的某一个视频的数据，测试范围仅限普通的视频，不包含会员专属视频、电影、剧集等。
| 平台 | 视频最大分辨率 | 支持的引擎及其下载的分辨率 | 解析引擎链建议 |
| ---------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| [YouTube](https://www.youtube.com/) | 2160p(4K) | V1(3840x2160), V6(640x360) | youtube.com:V1>V6 |
| [DailyMotion](https://www.dailymotion.com/) | 1080P | V1(1920x1080) | dailymotion.com:V1 |
| [vimeo](https://vimeo.com/) | 4K | V1(3996x2160), V3(1998x1080) | vimeo.com:V1>V3 |
| [VKontakte](https://vkvideo.ru/) | 2160P(4K) | V5(3840x2160P) | vkvideo.ru:V5 |
| [Twitch](https://www.twitch.tv/) | 1080P | V5(1920x1080), V1(1920x1080), V3(640x360) | twitch.tv:V5>V1>V3 |
| [TikTok](https://www.tiktok.com/explorehttps://www.tiktok.com/explore) | 网页未显示 | V1(1080x1920), V5(1080x1920), V3(576x1024), V4(576x1024) | tiktok.com:V1>V5>V3>V4 |
| [kwai](https://www.kwai.com/) | 网页未显示 | V1(720x1280), V2(720x1280), V4(720x1280), V5(720x1280) | kwai.com:V1>V2>V5>V4 |
| [Threads](https://www.threads.net/) | 网页未显示 | V5(720x1280) | threads.net:V5 |
| [TED](https://www.ted.com/) | 网页未显示 | V1(1920x1080) | ted.com:V1 |
| [Triller](https://triller.co/) | 网页显示720p | V1(1080x1920) , V5(1080x1920) | triller.co:V1>V5 |
| [Snapchat](https://www.snapchat.com/discover) | 网页未显示 | V1(720x1280), V2(540x920), V3(540x920) | snapchat.com:V1>V2>V3 |
| Twitter(X) | Facebook | Instagram | 搞不定这仨平台账号，无法测试┭┮﹏┭┮ |
| | | | |
| [腾讯视频](https://v.qq.com/) | 1080P | V1(1280x720) | qq.com:V1 |
| [优酷](https://www.youku.com/) | 1080P | V1(1920x1080) | youku.com:V1 |
| 爱奇艺 | 不支持 | | |
| [搜狐视频](https://tv.sohu.com/) | 原画1080P | V1(1920x1080) | sohu.com:V1 |
| [A站](https://www.acfun.cn/) | 2160p(4K) | V1(3840x2160) | acfun.cn:V1 |
| [哔哩哔哩](https://www.bilibili.com/) | 1080 高清 | V1(1920x1080)[cookie登录], V2(1280x720), V6(1280x720), V1(852x480)[未登录], V3(640x360), V4(640x360), V5(640x360) | 已经cookie登录：
bilibili.com:V1>V2>V6>V3>V5>V4
未登录：
bilibili.com:V2>V6>V1>V3>V5>V4 |
| [抖音](https://www.douyin.com/discover) | 4K 超清 | V2(1920x1080), V4(1920x1080) , V5(1920x1080), V6(1280x720) | douyin.com:V2>V5>V4>V6 |
| [西瓜](https://www.ixigua.com/) | 1080P | V2(1920x1080), V4(1280x720), V5(1280x720), V6(1280x720) | ixigua.com:V2>V5>V4>V6 |
| [快手](https://www.kuaishou.com/brilliant) | 网页未显示 | V2(720x1280), V4(720x1280), V6(720x1280) | kuaishou.com:V2>V4>V6 |
| [小红书](https://www.xiaohongshu.com/explore) | 网页未显示 | V2(1052x1872), V6(1052x1872), V4(1052x1872) , V1(720x1282) | xiaohongshu.com:V2>V6>V4>V1 |
| [知乎](https://www.zhihu.com/zvideo) | 1080P 超清V6 | V1(1920x1080), V3(1920x1080) , V4(1920x1080) , V5(1920x1080) | zhihu.com:V1>V3>V5>V4 |
| [微博](https://weibo.com/) | 2K 超清 | V1(1440x2560) , V6(1440x2560) ,V4(1080x1920) , V2(360x640) | weibo.com:V1>V6>V4>V2 |
| [百度好看](https://haokan.baidu.com/) | 4K | V6(3840x2160), V4(1920x1080), V3(640x360) | haokan.baidu:V6>V4>V3 |
| [芒果TV](https://www.mgtv.com/) | 1080 | V1(1280x720), V4(704x396) | mgtv.com:V1>V4 |
| [央视频](https://www.cctv.com/) | 超清 | V1(480x270) | cctv.com:V1 |
| [梨视频](https://www.pearvideo.com/) | 网页未显示 | V1(1280x720), V4(1280x720) | pearvideo.com:V1>V4 |
- 关于m3u8格式，目前仅V1引擎提供支持。注：在上表中列出的仅支持V1引擎的平台中，绝大多数都采用了m3u8格式。
- 访问外网平台通常需要科学上网方法。但在我们的测试中，一旦通过科学上网获取到VKontakte的视频链接后，即使断开科学上网连接，也能顺利下载该视频。
- 在测试V2引擎时，科学上网环境是必需的。若不具备此条件，您可以在解析引擎链中移除V2，以确保其他引擎的正常使用。注：V2之前不需要科学上网也能使用
- 在使用过程中，可能会遇到解析成功但无法下载的情况。这可能是由于以下原因：1）解析出的视频地址本身就不支持下载。2）视频平台采用了复杂的资源认证方式，超出了下载器的处理能力范围。
## 四、下载管理
### 4.1 批量操作
- 支持批量操作（全选、反选，删除等）
- 提供多种状态筛选（全部、下载中、下载成功、下载失败）
- 支持模糊搜索下载记录，只需输入网址、域名、标题的部分关键字
### 4.2 资源预览与分享
- 在线预览。在视频未下载完成时，可以提前预览正在下载视频，查看视频的清晰度是否满足自己的需求。
- 发送到手机。通过二维码分享解析后的下载链接，用手机浏览器可以下载到手机。
- 复制下载链接。可将复制的链接在浏览器打开，使用浏览器下载；或分享下载链接给您的朋友，他就能自己下载，不需要您下载完成后发送给他。
- 注：受限于各视频平台，解析后的视频下载链接有时效性。下载链接失效后，“用手机打开”，“预览”，“复制下载链接”等功能也都不好使了。“V1引擎解析的视频”不支持与“下载链接”相关的这些功能
### 4.3 便捷功能
- 在浏览器中复制视频网址后，点击vidkit的网址输入框，便会自动粘贴
- 支持视频播放。单击打开按钮，会使用您本地的默认的视频播放器进行播放
- 一键打开下载位置。下载成功后，单击播放按钮下方的路径即可快速打开视频所在位置
- 支持重试失败任务和重新下载
- 复制网址。只需点击该按钮，视频的网址便会立即拷贝到您的剪贴板中，并同时自动填充到网址输入框内，方便您进行后续操作。
### 4.4 数据管理
- 删除下载记录
- 清空历史记录
## 五、界面说明
### 5.1 顶部工具栏
- 视频解析/直接下载切换功能
- 新建下载任务：输入URL开始下载
- 音频下载开关♬：提取视频中的音频
- 配置解析引擎：为目标视频平台配置合适的解析引擎，提高下载质量
- 导入Cookie数据：导入从浏览器导出的平台登录Cookies
- 下载路径设置：自定义文件保存位置
### 5.2 列表操作区
- 状态筛选：快速筛选不同状态的任务
- 搜索功能：支持模糊搜索
- 批量操作：支持多选进行批量操作
### 5.3 资源列表
每个资源项包含：
- 缩略图预览
- 标题/URL信息
- 状态显示
- 操作按钮：打开、复制网址，更多（在线预览、发送到手机、复制下载链接等）
- 进度显示（下载中状态）
- 显示下载位置、文件大小（下载完成状态）
## 六、快捷操作
- 点击缩略图（上半区）：使用浏览器打开视频网址
- 点击发送到手机：生成二维码分享
- 点击击打开：使用系统默认软件播放视频或打开文件
- 点击路径链接：打开下载位置
## 七、版权说明
本软件旨在为您提供便捷的本地视频存储功能，方便您收集个人喜爱的视频资料或获取合法创作素材，仅供学习交流使用，请勿用于非法用途。我们坚决反对并禁止任何非法用途的使用。虽然本工具为您提供了从各种平台下载视频的服务，但您有责任尊重并遵守相关法律法规和各个视频平台或内容创作者的版权政策。
我们强烈建议您将下载的视频内容仅限于个人欣赏与学习之用，并在下载后的24小时内及时删除。我们鼓励您访问资源的原始发布网站进行观看，并支持原创作品。未经原作者明确授权，请勿用于其他任何目的。
## 八、联系与支持
- 代码仓库：[Gitee: shawn-wow/vidkit](https://gitee.com/shawn-wow/vidkit)
- 版本更新：软件会自动检查更新（注：开源代码不再更新，软件包持续更新中）
- 使用交流：B站[九漏鱼Musk]
- 打赏作者一份猪脚饭【菜单**≡** ，*为爱发电*】
# 开发
在运行 vidkit之前，请确保你的机器上安装了**最新版本**的 Node.js
```
$ $ npm install --save-dev electron electron-builder cross-env javascript-obfuscator rimraf # 安装必要的包
$ npm install crypto-js jsdom qrcode marked electron-store@8.2.0 electron-updater iconv-lite tree-kill file-type@16.5.4 extract-zip # 安装必要的包
$ npm start # 启动程序
$ npm run build # 启动程序
```