m3u8d/README.md

71 lines
5.1 KiB
Markdown
Raw Permalink Normal View History

2022-07-12 01:45:25 +00:00
2022-06-23 22:44:14 +00:00
## m3u8视频下载工具
2022-07-12 01:45:25 +00:00
* 没有ffmpeg依赖, 不需要单独配置任何环境
2022-06-23 22:44:14 +00:00
* 提供windows图形界面(Qt), mac、linux命令行, linux支持arm、386、mipsle
* 程序会自动将下载的ts文件合并转换格式为mp4
2022-08-02 23:50:44 +00:00
* ![](m3u8d-qt/screenshot.png)
2022-08-08 02:32:11 +00:00
* [全部版本下载](https://github.com/orestonce/m3u8d/releases ), 包括windows图形界面/linux命令行/mac命令行/mac图形化界面
2022-08-08 02:18:26 +00:00
* 命令行使用教程
2022-07-12 01:45:25 +00:00
* 普通下载命令 `./m3u8d download -u https://example.com/index.m3u8`
* curl模式 `./m3u8d curl 'https://example.com/index.m3u8' -H 'cookie: CONSENT=YES'`
2022-05-15 03:05:31 +00:00
## 实现说明
2022-08-08 02:32:11 +00:00
* download.go 大部分抄自 [llychao/m3u8-downloader](https://github.com/llychao/m3u8-downloader)
2022-06-23 22:44:14 +00:00
* 使用[gomedia](https://github.com/yapingcat/gomedia) 代替ffmpeg进行格式转换
2022-05-15 03:05:31 +00:00
* 支持跳过前面几个ts文件(一般是广告, 嘿嘿)
* 程序会在下载保存目录创建:
* downloading/ 目录, 用于存放正在下载的分段ts视频, 按照m3u8的url进行划分
* m3u8d_cache.cdb 文件, 用于存放以前的下载历史, 用于防止重复下载文件
* 重复下载文件的判定和跳过
2022-06-19 23:32:53 +00:00
* 将M3u8Url+SkipTsCountFromHead进行hash, 得到文件下载id
2022-05-15 03:05:31 +00:00
* 将文件下载id/文件大小/文件内容hash 储存在 m3u8_cache.cdb里面, 下载前搜索下载目录
2022-06-24 07:40:04 +00:00
如果发现某个文件大小/文件内容hash和以前的记录相等,则认为这个文件是以前下载的文件, 跳过此次下载.
2023-06-03 06:27:06 +00:00
* **curl模式** 可以赋予使用者任意设置下载请求的Header信息的能力方便解决只有一个m3u8的链接时无法下载视频的尴尬局面
* 例子1, 你需要下载的视频是要登陆后观看的Cookie信息里存放了登陆状态
* 例子2, 网站开发者验证了Referer信息、Authority信息、Origin信息、User-Agent信息、各种特定的Header信息
* 以windows下的chrome为例找到对应的m3u8请求记录然后右键选择 "Copy - Copy as cURL(bash)",
然后打开 windows-qt版本的 m3u8d, 点击 "curl 模式",将复制出来的请求粘贴上去即可
2022-08-08 02:18:26 +00:00
* 已有功能列表
* 如果不是m3u8样子的URL自动下载html下来、搜索其中的m3u8链接进行下载
* windows、linux、mac都支持转换、合并ts格式为mp4
2022-08-08 02:32:11 +00:00
* 充分测试后,使用 [gomedia](https://github.com/yapingcat/gomedia) 代替ffmpeg进行格式转换
2022-08-08 02:18:26 +00:00
* 支持嵌套m3u8的url
* 增加openwrt路由器的mipsle二进制
2022-08-08 02:32:11 +00:00
* 支持从curl命令解析出需要的信息正如 [cxjava/m3u8-downloader](https://github.com/cxjava/m3u8-downloader) 一样
2022-08-08 02:18:26 +00:00
* 显示下载速度、合并ts的速度
* 提供macos的图形化界面
2022-09-20 01:09:52 +00:00
* 支持下载aes加密的m3u8
2022-09-20 01:10:46 +00:00
* 内部使用多线程下载ts文件
* 支持设置代理: http/socks5
2022-08-30 00:58:20 +00:00
* http代理解释: 要访问的真实url是http协议, 使用代理服务器可见的GET/POST/HEAD...形式; 如果要访问的真实url是https协议, 使用代理服务器不可见的CONNECT形式
2022-05-25 06:13:17 +00:00
## TODO:
2022-09-01 00:32:57 +00:00
* [ ] 多线程修改为自适应模式,在下载过程中动态调整线程池大小,以便达到最快的下载速度
2022-07-11 01:03:36 +00:00
* [ ] 支持多国语言
2022-08-08 02:18:26 +00:00
* [ ] 支持从一个txt里读取下载列表批量下载
2022-05-15 03:05:31 +00:00
## 二次开发操作手册:
2022-05-15 03:51:05 +00:00
* 如果只开发命令行版本, 则只需要修改*.go文件, 然后编译 cmd/main.go 即可
* 如果涉及到Qt界面打包, 则需要运行 export/main.go 将 *.go导出为Qt界面需要的
2022-05-15 03:05:31 +00:00
`m3u8-qt/m3u8.h`,`m3u8-qt/m3u8.cpp`, `m3u8-qt/m3u8-impl.a`. 然后使用QtCreator进行打包
## 发布协议
2022-06-25 16:11:55 +00:00
* m3u8d-qt/ 目录采用 [GPL协议 v3](m3u8d-qt/LICENSE) 发布
* 除 m3u8d-qt/ 以外的代码, 采用[MIT协议](LICENSE)发布
2022-07-12 01:45:25 +00:00
## 开发支持
* 本项目由 jetbrains 开源开发许可证-社区版([Licenses for Open Source Development](https://jb.gg/OpenSourceSupport)) 提供goland开发支持
2022-07-17 12:06:18 +00:00
* 感谢 [gomedia](https://github.com/yapingcat/gomedia) 开发者提供的ts转mp4逻辑
----------------------------------
## 关于为什么使用 gomedia 替代 ffmpeg
### 引入ffmpeg很麻烦, 原因列表:
1. ffmpeg开源协议是 GPL的,具有传染性, 这个项目的主要逻辑就不能使用 MIT 开源了
2. 如果使用cgo调用的形式引入ffmpeg
* 最终二进制体积特别大
* 编译mac/linux/路由器 版本的时候必然要依赖对应的跨平台编译器, 编译难度提升
3. 如果使用内嵌 静态编译的ffmpeg二进制, 使用的时候释放到 临时目录再调用命令行
* 最终二进制体积会更大, 可以看[以前的v1.1版本](https://github.com/orestonce/m3u8d/releases/tag/v1.1) , 每个最终二进制都比现在大25MB左右
* 没找到mipsle路由器版本的静态编译的ffmpeg
2022-07-17 12:07:27 +00:00
4. 如果直接调用ffmpeg命令, 用户则必须首先安装ffmpeg到操作系统, 难用
2022-07-17 12:06:18 +00:00
### 引入MIT协议的gomedia解决ts转换成mp4好处
1. gomedia是纯go代码, 跨平台编译容易
2. 本项目也可以使用MIT协议进行开源, 无需限定为GPL/LGPL
3. 最终二进制体积特别小, linux/mac 版本的命令行版本才 5-7MB, windows由于有静态编译进来的qt界面, 现在体积有26MB
4. 用户无需预先安装ffmpeg, 降低用户的使用难度