douyin-downloader

Sat, 12 Apr 2025 15:24:42 +0800

jiji262/douyin-downloader

DouYin Downloader

DouYin Downloader 是一个用于批量下载抖音内容的工具。基于抖音 API 实现，支持命令行参数或 YAML 配置文件方式运行，可满足大部分抖音内容的下载需求。

✨ 特性

多种内容支持
- 视频、图集、音乐、直播信息下载
- 支持个人主页、作品分享、直播、合集、音乐集合等多种链接
- 支持去水印下载
批量下载能力
- 多线程并发下载
- 支持多链接批量下载
- 自动跳过已下载内容
灵活配置
- 支持命令行参数和配置文件两种方式
- 可自定义下载路径、线程数等
- 支持下载数量限制
增量更新
- 支持主页作品增量更新
- 支持数据持久化到数据库
- 可根据时间范围过滤

🚀 快速开始

安装

安装 Python 依赖：

`1`	`pip install -r requirements.txt`

复制配置文件：

`1`	`cp config.example.yml config.yml`

配置

编辑 config.yml 文件，设置：

下载链接
保存路径
Cookie 信息（从浏览器开发者工具获取）
其他下载选项

运行

方式一：使用配置文件（推荐）

`1`	`python DouYinCommand.py`

方式二：使用命令行

`1`	`python DouYinCommand.py -C True -l "抖音分享链接" -p "下载路径"`

使用交流群

使用截图

📝 支持的链接类型

作品分享链接：https://v.douyin.com/xxx/
个人主页：https://www.douyin.com/user/xxx
单个视频：https://www.douyin.com/video/xxx
图集：https://www.douyin.com/note/xxx
合集：https://www.douyin.com/collection/xxx
音乐原声：https://www.douyin.com/music/xxx
直播：https://live.douyin.com/xxx

🛠️ 高级用法

命令行参数

基础参数：

-C, --cmd            使用命令行模式
-l, --link          下载链接
-p, --path          保存路径
-t, --thread        线程数（默认5）

下载选项：

-m, --music         下载音乐（默认True）
-c, --cover         下载封面（默认True）
-a, --avatar        下载头像（默认True）
-j, --json          保存JSON数据（默认True）

更多参数说明请使用 -h 查看帮助信息。

示例命令

下载单个视频：

`1`	`python DouYinCommand.py -C True -l "https://v.douyin.com/xxx/"`

下载主页作品：

`1`	`python DouYinCommand.py -C True -l "https://v.douyin.com/xxx/" -M post`

批量下载：

`1`	`python DouYinCommand.py -C True -l "链接1" -l "链接2" -p "./downloads"`

更多示例请参考使用示例文档。

📋 注意事项

本项目仅供学习交流使用
使用前请确保已安装所需依赖
Cookie 信息需要自行获取
建议适当调整线程数，避免请求过于频繁

🤝 贡献

欢迎提交 Issue 和 Pull Request。

📜 许可证

本项目采用 MIT 许可证。

🙏 鸣谢

TikTokDownload
本项目使用了 ChatGPT 辅助开发，如有问题请提 Issue

📊 Star History

License

MIT

Multithreading on Producthunt daily