douyin-downloader 开源项目介绍

核心特性

全面的内容支持

• 视频下载：支持去水印高清视频下载。

• 图集下载：批量下载图片集合。

• 音乐下载：提取视频背景音乐。

• 封面与头像：下载视频封面和作者头像。

• 元数据保存：保存完整的作品信息（JSON 格式）。

强大的下载能力

• 多线程并发：支持多线程同时下载，提升效率。

• 断点续传：网络中断后自动从断点继续下载。

• 智能重试：网络错误时自动重试，采用指数退避策略。

• 去重处理：自动跳过已下载内容，避免重复下载。

灵活的配置选项

• 多种下载模式：支持单个作品、用户主页、合集、音乐集合等。

• 时间范围过滤：可按时间范围筛选下载内容。

• 数量限制：可设置每种类型的下载数量上限。

• 增量更新：支持增量下载，只下载新增内容。

便捷的使用方式

• 配置文件模式：通过 YAML 配置文件批量管理下载任务。

• 命令行模式：支持命令行参数快速下载。

• 数据库支持：可选择使用数据库记录下载历史。

支持的链接类型

视频内容

• 单个视频分享链接：https://v.douyin.com/xxxxx/。

• 单个视频直链：https://www.douyin.com/video/xxxxx。

• 图集作品：https://www.douyin.com/note/xxxxx。

用户内容

• 用户主页：https://www.douyin.com/user/xxxxx，支持下载用户发布的所有作品，也支持下载用户喜欢的作品（需要权限）。

合集内容

• 用户合集：https://www.douyin.com/collection/xxxxx。

• 音乐合集：https://www.douyin.com/music/xxxxx。

直播内容

• 直播间：https://live.douyin.com/xxxxx。

高级功能

时间范围过滤

start_time: "2024-01-01"  # 开始时间
end_time: "2024-12-31"    # 结束时间

文件夹结构设置

• folderstyle: True：每个视频单独一个文件夹，结构示例如下：

user_xxx/
├── post/
│   ├── 2024-01-01_视频标题1/
│   │   ├── 2024-01-01_视频标题1.mp4
│   │   ├── 2024-01-01_视频标题1_cover.jpeg
│   │   └── 2024-01-01_视频标题1_result.json
│   └── 2024-01-02_视频标题2/
└── mix/

• folderstyle: False：所有文件放在同一目录，结构示例如下：

user_xxx/
├── post/
│   ├── 2024-01-01_视频标题1.mp4
│   ├── 2024-01-01_视频标题1_cover.jpeg
│   ├── 2024-01-02_视频标题2.mp4
│   └── 2024-01-02_视频标题2_cover.jpeg
└── mix/

Cookie 配置方式

• 方式 1（推荐）：键值对形式

cookies:
  msToken: YOUR_MS_TOKEN
  ttwid: YOUR_TTWID
  odin_tt: YOUR_ODIN_TT
  passport_csrf_token: YOUR_CSRF_TOKEN
  sid_guard: YOUR_SID_GUARD

• 方式 2：字符串形式

cookie: "msToken=xxx; ttwid=xxx; odin_tt=xxx; passport_csrf_token=xxx; sid_guard=xxx;"

命令行参数详解

基础参数

• -C, --cmd：启用命令行模式。

• -l, --link：下载链接（可多次使用）。

• -p, --path：保存路径。

• -t, --thread：线程数（默认 5）。

• -h, --help：显示帮助信息。

下载选项

• -m, --music：下载音乐（True/False，默认 True）。

• -c, --cover：下载封面（True/False，默认 True）。

• -a, --avatar：下载头像（True/False，默认 True）。

• -j, --json：保存 JSON 数据（True/False，默认 True）。

• -f, --folderstyle：文件夹结构（True/False，默认 True）。

模式和数量

• -M, --mode：下载模式（post/like/mix/music）。

• -n, --number：下载数量限制。

• -I, --increase：增量下载（True/False）。

时间过滤

• -s, --start：开始时间（YYYY-MM-DD）。

• -e, --end：结束时间（YYYY-MM-DD）。

法律声明与注意事项

• 本项目仅供学习交流使用，请遵守相关法律法规和平台服务条款，不得用于商业用途或侵犯他人权益，下载内容请尊重原作者版权。

• 技术要求：Python 3.9 或更高版本、稳定的网络连接、足够的存储空间、有效的抖音账号 Cookie。

下面简单说下使用教程

你要下载某个抖音账号下的视频，如果是手机就点分享名片，然后复制链接。然后把链接张贴到config.yml 我已经放了几个例子在里面 在后面跟着就好，config.yml可用记事本打开编辑。如下图所示

注意缩进要和我的例子保持一致，否则会出错

其他的选项可以参考作者的说明去修改。只是注意缩进和大小写。

关于抓取cookie，我选择了作者的第二种方式也就是最后一行那里，如下图所示

下面讲解一下如何抓取，用电脑的浏览器打开www.douyin.com，然后用抖音扫码登录，登录后按F12，如下图所示

随便哪个都可以 只要有cookie就行，然后复制这个cookie的值 ，如下图所示

一定要复制完整。切记！ 从UIFID_TEMP=这个地方开始复制。

然后把这个cookie的值 张贴到config.yml cookie: ""  也就是最后一行的引号里面。最后保存这个config.yml。如果一切都是按我的教程来操作 就可以顺利下载视频。

最后提醒一句

使用此类工具时应遵守抖音平台的相关使用条款，尊重版权和隐私权，不得用于非法用途

我加了个秘钥验证，不会收费的，只是想看看到底有多少人使用这个工具。目前这个抖音下载工具是我用过的抖音视频下载工具里面最强的，没有之一。

点击查看

下载地址

夸克网盘 百度网盘

下载有疑问看下这里