DingTalk-Download 是一个功能强大的钉钉直播回放下载工具,专为需要保存钉钉直播回放内容的用户设计。该工具通过自动化浏览器操作,实现了钉钉直播回放视频的批量下载功能,支持多种浏览器和下载模式,极大提升了工作效率。
- 一键下载:通过钉钉分享链接,一键下载直播回放视频
- 批量处理:支持批量下载多个直播回放,通过 CSV/Excel 文件导入链接
- 多浏览器支持:兼容 Edge、Chrome、Firefox 等主流浏览器
- 自动化操作:自动处理浏览器登录、Cookie 获取、视频解析等复杂流程
- 智能下载:自动识别 M3U8 视频流,使用专业工具进行下载和合并
- 跨平台支持:支持 Windows、macOS、Linux 等主流操作系统
- 模块化设计:采用清晰的模块化架构,易于维护和扩展
项目采用模块化设计,主要包含以下核心模块:
- Core 模块:核心业务逻辑,包括下载器、Cookie 处理器、M3U8 解析器
- Browser 模块:浏览器自动化,支持多种浏览器的驱动管理和操作
- Utils 模块:工具函数库,提供文件操作、路径处理、字符串处理等通用功能
- Binary 模块:二进制工具封装,集成 N_m3u8DL-RE 和 FFmpeg 等专业工具
- Config 模块:配置管理,统一管理项目配置和常量定义
DingTalk-Download/
├── src/ # 源代码目录
│ └── dingtalk_downloader/ # 项目包名
│ ├── __init__.py
│ ├── main.py # 程序入口文件
│ ├── core/ # 核心业务逻辑模块
│ ├── utils/ # 工具函数模块
│ ├── binary/ # 二进制程序调用模块
│ ├── browser/ # 浏览器自动化模块
│ └── config/ # 配置管理模块
├── tests/ # 测试代码目录
│ ├── unit/ # 单元测试
│ ├── integration/ # 集成测试
│ └── fixtures/ # 测试数据
│ ├── sample_links.csv
│ └── sample_links.xlsx
├── assets/ # 静态资源目录
│ ├── bin/ # 外部二进制程序目录
│ │ ├── N_m3u8DL-RE.exe # N_m3u8DL-RE可执行文件(Windows)
│ │ ├── N_m3u8DL-RE # N_m3u8DL-RE可执行文件(Linux/macOS)
│ │ ├── ffmpeg.exe # FFmpeg可执行文件(Windows)
│ │ └── ffmpeg # FFmpeg可执行文件(Linux/macOS)
│ ├── template/ # 模板文件目录
│ │ └── 批量下载模板.xlsx # 批量下载模板文件
│ └── ICO/ # 图标资源目录
│ ├── icon-512x512.png
│ ├── icon.ico
│ └── icon.png
├── pyproject.toml # 项目元数据与依赖声明(PEP 621)
├── uv.lock # 依赖锁定文件(uv 生成,纳入版本控制)
├── .python-version # 固定 Python 版本
├── .gitignore # Git忽略文件配置
├── .trae/ # Trae IDE配置目录
│ └── rules/
│ └── project_rules.md # 项目规则文档
└── README.md # 项目说明文档
- src/: 源代码目录,包含所有 Python 代码
- tests/: 测试代码目录,包含单元测试、集成测试和测试数据
- assets/: 静态资源目录,包含外部二进制程序、模板文件和图标资源
- docs/: 文档目录,包含开发规范、开发指南和项目记录
- pyproject.toml: 项目元数据与依赖声明
- uv.lock: 依赖锁定文件,由
uv lock生成并纳入版本控制
- 操作系统:Windows 10/11、macOS 10.14+、Linux(Ubuntu 18.04+)
- Python 版本:Python 3.13 或更高版本
- 浏览器:Edge、Chrome 或 Firefox(需安装对应浏览器)
- 网络:稳定的网络连接,用于访问钉钉平台
- 从 Releases 页面下载最新版本的可执行文件
- 解压下载的压缩包
- 双击运行
DingTalk-Download.exe - 按照界面提示进行操作
需要先安装 uv。
# 克隆项目
git clone https://github.com/free5394/DingTalk-Download.git
cd DingTalk-Download
# 同步运行时与开发依赖(自动创建 .venv 并安装 pyproject.toml + uv.lock 锁定的包)
uv sync --all-groups
# 运行程序
uv run python -m src.dingtalk_downloader.main- 运行程序后,选择"单个下载"模式
- 输入钉钉直播分享链接
- 选择保存路径和浏览器类型
- 等待浏览器自动打开
- 在浏览器中登录钉钉账号
- 等待页面加载完毕后,按回车键开始下载
- 准备 CSV 或 Excel 文件,将钉钉直播分享链接放入单元格(不要放在首行)
- 运行程序后,选择"批量下载"模式
- 输入或拖拽包含链接的文件
- 选择保存路径和浏览器类型
- 等待浏览器自动打开
- 在浏览器中登录钉钉账号
- 等待页面加载完毕后,按回车键开始批量下载
本项目使用了以下第三方工具:
- N_m3u8DL-RE:一个跨平台的 DASH/HLS/MSS 下载工具,支持点播和直播(DASH/HLS)视频下载。
- FFmpeg:一个开源的音视频处理工具,支持多种格式的转换、录制和流媒体处理。
本项目使用以下开发工具来确保代码质量和一致性:
Black 是 Python 社区广泛使用的代码格式化工具。
# 安装开发依赖(含 black)
uv sync --all-groups
# 格式化代码
uv run black src tests
# 检查格式
uv run black --check .Pytest 是 Python 的测试框架。
# 运行测试
pytest
# 查看覆盖率
pytest --cov=src/dingtalk_downloader本项目采用 MIT 许可证。详见 LICENSE 文件。