Skip to content
This repository has been archived by the owner on Feb 26, 2024. It is now read-only.
/ ef2 Public archive

IDM辅助下载工具,使用自定义ef2://协议,同时支持解析IDM导出文件(.ef2)

License

Notifications You must be signed in to change notification settings

MotooriKashin/ef2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Internet Download Manager (IDM)下载辅助工具,允许主动拉起IDM进行下载,并配置referer、User-Agent等信息。


安装/卸载

绿色命令行程序,只需要写入注册表关联:

  1. 下载ef2.exe到任意目录。
  2. 双击打开ef2.exe,点击安装按钮即可。

如果觉得不好用,需要卸载:

  1. 双击打开ef2.exe,点击卸载按钮。
  2. 删除ef2.exe即可。

ef2.exe最好放到专门的目录,以免移动或丢失,移动后须重新注册。


使用方式

※ IDM导出文件

IDM官方定义了专门的文件格式,拓展名.ef2,用于导入导出下载列表,不过用起来步骤较多且不支持双击打开。本工具不仅支持双击打开ef2文件开始下载并拓展了ef2文件的配置项支持。
ef2文件本质是一个标准的纯文本文件(utf-8编码),展开示例如下:

查看ef2文件示例
<
https://img2.example.com/data/1102/94/IMG_0001.jpg
referer: https://img2.example.com/data/1102/94/
User-Agent: Mozilla/5.0 (Windows NT 6.1; Trident/7.0; rv:11.0) like Gecko
>
<
https://img2.example.com/data/1102/94/IMG_0002.jpg
referer: https://img2.example.com/data/1102/94/
User-Agent: Mozilla/5.0 (Windows NT 6.1; Trident/7.0; rv:11.0) like Gecko
>
<
https://img2.example.com/data/1102/94/IMG_0003.jpg
referer: https://img2.example.com/data/1102/94/
User-Agent: Mozilla/5.0 (Windows NT 6.1; Trident/7.0; rv:11.0) like Gecko
>
  

除了IDM官方提供referer、User-Agent关键词,本工具还拓展了一些关键词:

查看拓展的关键词
cookies cookies 字符串
postdata 改用POST方法send的字符串
username HTTP认证用户名
password HTTP认证密钥
filepath 保存路径(反斜杠形式)
filename 文件名(包括拓展名)
值得注意的是如果ef2文件中有多条下载数据(即批量下载),双击打开将直接添加到IDM默认下载列表,需要到IDM中自己开启队列来开始下载。

※ ef2协议

为了方便从浏览器中拉起IDM,本工具自定义了一种名为ef2的协议,能像使用http协议一样使用,格式如下:

协议头 内容 完整形式
ef2:// d3d3LmV4YW1wbGUuY29t ef2://d3d3LmV4YW1wbGUuY29t
http:// www.example.com http://www.example.com

不难发现所谓的ef2就是将http协议内容部分用Base64编码一下然后将http协议头改为ef2。
如此一来在浏览器中点击该链接便可以拉起IDM。但我们还需拓展一下,以让这种协议不仅能传递下载链接,还要能传递referer、User-Agent等关键词以支持ef2文件类似的功能。
于是我们将协议内容部分由单纯的网址转变为命令行参数形式(为方便演示暂时未使用Base64编码)

www.example.com ----参数化----> -u www.example.com

查看完整参数说明(*含空格等非法字符时请用双引号包裹*)
参数标记 参数内容 说明示例
u URL
-u https://img2.example.com/data/1102/94/IMG_0001.jpg
r referer
-r https://img2.example.com/
a User-Agent
-a "Bilibili Freedoooooom/MarkII"
c cookies
-c cookies字符串
d 改用POST请求send的数据
-d send字符串
U HTTP认证用户名
-U username字符串
P HTTP认证密钥
-P password字符串
o 保存路径(反斜杠)
-o F:\下载
s 文件名(含拓展名)
-s 视频.mp4
f 禁用下载对话框
-f
q 稍后下载(加入默认队列)
-q

注意别忘了用Base64编码一下然后添加上ef2协议头。
这种ef2协议使用方式基本类似http、ftp等协议,可以直接在浏览器地址栏中输入、添加a标签等href属性并点击、window.open()等方法打开,当然也可以直接作为命令行参数传递给ef2.exe(Base64编码千万别忘记)。
第一次使用本方法浏览器会弹出打开外部程序请求弹窗,需要点击允许,建议勾选不再提示。

※ webSocket

本工具还支持在后台运行,通过websocket协议接受下载数据并传递给IDM。

  1. 命令行启动ef2.exe同时传递参数ef2://websocket:${端口号},如ef2://websocket:12345。(不需要Base64加密!
  2. 使用websocket客户端连接ws://localhost:${端口号},如ws://localhost:12345
  3. 使用websocket.send方法发起下载数据,格式可以是ef2协议(需要Base64编码)字符串。
  4. 使用websocket.close关闭websocket连接。
  5. 如果要退出后台运行,请在websocket.close前使用websocket.send方法发送字符串fin

注意也可以用使用ef2协议的方式使用ef2://websocket:${端口号}(不需要Base64加密)后台运行。

※ ef2.js

本项目自带了一个标准的es6模块ts/js文件,以default方式导出了一个对象,支持生成ef2协议字符串。

  1. 以标准es6模块加载方式加载该模块,如const ef2 = (await import("ef2.js")).default
  2. 使用encode()方式返回编码生成ef2协议字符串,const result = ef2.encode({url: "http://www.example.com/"})
  3. 使用生成的ef2协议拉起IDM进行下载,如window.open(result)

1.0.2版本,新添了一个异步方法nativeMessaging,传递端口号可以启动webSocket模式。

具体模块定义在ts文件中有详细说明文档,在VSCode中可以获取详细提示。


编译相关

环境 版本
Windows 11 10.0.22000.1
VSCode 1.63.2
MSVC 19.30.30709
Windows SDK 10.0.22000.0

说明:

  1. 需要在Developer Command Prompt for VS中启动VSCode,或者手动将MSVC及Windows SDK添加进系统环境变量。
  2. 打开main.cpp文件然后f5启用调试,或者运行任务C/C : cl.exe build直接编译发行版。
  3. 任务tsc: build - typescript/tsconfig.json用来编译ef2.ts到js文件,输出目录为dist。

开源许可

MIT License

项目中参考其他源码及文章:

项目或文章 开源协议
idm_api 未知
IDMHelper GPL-3.0 License
mingw控制台中文乱码 未知
C 实现utf8和gbk编码字符串互相转换 未知
base64 MIT License
HeadSocket 未知

About

IDM辅助下载工具,使用自定义ef2://协议,同时支持解析IDM导出文件(.ef2)

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages