douyin-downloader 新手上手指南从单个无水印视频到整页批量与直播挂机【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader你存过的抖音视频是不是这样带着水印、文件名乱成一锅粥想存一整个作者主页又得手动点半天douyin-downloader 是一个免费开源的抖音无水印批量下载工具贴上链接它就能自动识别内容类型落盘无水印顺手把去重也办了。先看清边界抖音批量下载它能做哪些、不能做哪些这一章帮你把预期对齐三分钟看完能力清单避免装完才发现这个功能没有。能做的按内容类型分四组单条内容视频、图文note、合集mix、音乐原声四类链接都能直接下v.douyin.com/xxx短链会自动解析成真实地址主页批量贴作者主页链接按post作品/like点赞/mix合集/music音乐四种模式拉取数量和发布时间范围都能约束收藏夹当前登录账号的收藏夹/收藏合集整体搬走collect/collectmix模式直播录制FLV/HLS 流都能录主播下播时已录数据保留下载时默认优先挑无水印的最高清源按bit_rate自动选最高码率并可以按开关附带封面、背景音乐、作者头像和元数据 JSON。调查与自动化方向还有评论采集含二级回复输出 JSON、热搜榜与关键词搜索导出 JSONL、REST API 服务模式、下载完成推送通知、视频语音转写。做不到的同样说清楚收藏夹模式只认当前登录的 Cookie 账号且必须单独使用不能和post等模式混用收藏夹模式不支持增量浏览器兜底目前只对post完整验证like/mix/music的翻页主要依赖 API 正常返回HLS 直播源只保存 playlist 文件需要 ffmpeg 后处理成视频不代理别人的账号登录Cookie 只属于你本机确认边界后下面开始动手——本章目标只有一个跑通你的第一个无水印下载。如何完成首次运行安装 douyin-downloader 并拿到无水印视频的 4 个步骤本章给你最少步骤的完整路径装环境 → 拿凭证 → 写最简配置 → 运行。每步就一个动作、一条命令看到什么算成功下面都写死了。前提只有一条本机装了 Python 3.8 及以上。第一步克隆项目并安装依赖。这条命令把项目拉到本地并装上全部依赖看到 pip 输出Successfully installed就成功了。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip 慢或超时就换国内镜像再跑一遍pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple。如果以后要用浏览器兜底再装playwright并执行python -m playwright install chromium。第二步获取登录凭证Cookie。这条命令会自动弹出浏览器你扫码登录一次抖音回终端按回车看到config.yml里cookies字段被自动填上就成功了。python -m tools.cookie_fetcher --config config.yml⚠️ Cookie 有效期一般一到两周它只保存在本地不会上传任何服务器过期了重跑同一条命令即可其他配置都不用动。第三步写一份最小配置。先执行cp config.example.yml config.yml复制出配置文件然后把下面几个字段改成你的——链接换成你要的视频其余保持默认link: - https://www.douyin.com/video/7604129988555574538 # 换成你要的链接 path: ./Downloaded/ music: true # 同时下载背景音乐 cover: true # 同时下载封面图 json: true # 同时保存元数据第四步运行。这条命令按配置执行下载看到Downloaded/里出现无水印 mp4、命令行打出下载完成 成功: 1/1就是成功了。python run.py -c config.yml命令行会实时给出解析、进度和统计信息。如果你不习惯命令行项目还有一个同一套后端的桌面版客户端粘贴链接、识别内容类型、勾选要下载的作品/喜欢/合集一键开始。桌面版主界面粘贴链接 → 检测内容类型 → 勾选作品/喜欢/合集一键开始单条跑通只是热身这个工具真正的价值在整页。如何批量下载一位创作者的主页作品、喜欢、合集、收藏夹这一章解决我只想要某位创作者的全部内容不想一个个点。做法很直接把配置里的链接换成他的主页地址再指定模式。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 换成主页链接 mode: - post # 发布作品也可填 like / mix / music number: post: 50 # 只下最近 50 个0 表示全部 start_time: 2024-06-01 # 时间截取只搬这个窗口内发布的 end_time: 2024-06-30mode可以写多个多线程并行下载每个任务有独立进度条失败按指数退避自动重试同一个作品在不同模式下出现也不会下两遍跨模式自动去重。批量下载每个任务独立进度条并行执行、失败自动重试想把自己的收藏整体备份链接固定填self收藏页模式填collect收藏合集填collectmixlink: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect # 仅对当前登录账号生效需单独使用⚠️ 收藏夹模式不能与post/like/mix/music混写也不支持增量一次跑完整备份更稳妥。主页批量之外还有几个挂着就行的场景值得顺手配上。直播挂机录制与内容调研怎么做直播、评论、热搜、API 服务这一章把不靠手动点的场景一次讲完直播挂机、评论与热搜调研、以及接入你自己的工作流。直播录制。把直播间链接写进配置开播后挂着即可看到命令行打印出直播间信息和 FLV 流地址就成功了link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 一直录到主播下播录制文件落在Downloaded/{作者}/live/下附带直播间元数据快照主播下播、网络空闲或你手动中断时.tmp文件会自动提升为正式文件已录制的字节不丢。注意 HLS 源只存 playlist要拿完整视频需 ffmpeg 后处理。直播录制自动识别直播间、列出可选清晰度、拉取流地址开始录制内容调研。想分析某个视频下的讨论在配置里打开评论采集每个作品会多生成一份*_comments.jsoninclude_replies: true时二级回复也一并抓出comments: enabled: true include_replies: true # 抓二级回复请求量会变多 max_comments: 500不追特定博主、只想看今天抖音在聊什么下面两条命令直接出结果第一条导出热搜榜第二条按关键词搜作品成功标志是hot_board/和search/目录下各多出一个带时间戳的 JSONL 文件。python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded接入自己的工作流。想把它变成服务下面一条命令启动 REST 接口成功标志是POST /api/v1/download能提交任务、GET /api/v1/jobs/{job_id}能查状态pip install fastapi uvicorn python run.py --serve --serve-port 8000另外两个开关按需打开notifications支持 Bark / Telegram / Webhook下载完成直接推手机transcript.enabled: true配上OPENAI_API_KEY后每个视频会多生成txt/json两份文字转写方便检索。桌面版的任务中心则把每个任务的状态、耗时、结果集中展示跑完一眼可见。任务中心进行中/已完成/失败分栏展示可搜索、可打开下载目录任务越多越需要保险机制下一章讲它们默认怎么工作、哪里能定制。批量下载怎么开启去重增量、断点续传与命名模板这一章讲三个用了就回不去的机制去重、断点续传、自动整理命名帮你把跑一次任务永不重复劳动变成默认行为。去重与增量。底层是数据库 本地文件双重检查SQLite 里记录每个下载过的作品 ID同时扫描本地文件名兜底两边都查过才跳过。开启增量后再下同一位创作者时只拉新发布的作品。逻辑在 storage/database.py 与core/的下载主流程里。database: true increase: post: true # 下次运行自动跳过已下载作品只下新增断点续传。下载过程中会比对Content-Length文件不完整就自动清理重下任务中断后再次运行已完成的直接跳过只补缺失部分不用从头再来。命令行中的跳过已存在与下载统计去重生效成功/用时一目了然命名与目录。默认按发布时间 标题 ID给每个作品建独立文件夹mp4、封面、BGM、头像、元数据 JSON 放同一处根目录还有一份download_manifest.jsonl每行一条下载记录方便追溯。不满意默认规则就用模板变量改folderstyle: true filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id}可用变量有{date}、{title}、{id}、{author}、{year}、{month}等模板里必须保留{id}否则同标题作品会互相覆盖。设置里的命名模板作者目录、子目录、文件名规则均可自定义落盘效果就是下面这种按日期分门别类的结构找任何一个视频都像翻档案下载完成后的目录结构每个作品一个文件夹视频、封面、BGM、元数据齐全最后一个常见诉求想强制重新下载某个作品把它在Downloaded/里的文件夹删掉即可——本地文件没了、数据库记录还在程序会视为需要重新下载。机制都讲完了剩下的就是别踩坑。高频问题速修403、只抓到 20 条、中断下载与内存偏高下面是实际使用中命中率最高的五个问题每个都按现象 → 原因 → 解法给结论。现象突然报 403 Forbidden 或未登录。原因是 Cookie 过期这是最高频的一种。解法重跑同一条获取命令扫码登录一次即可。建议养成每周更新一次 Cookie 的习惯。现象批量下载只能抓到 20 条作品。原因是翻页触发了风控API 只放行第一页。解法是打开浏览器兜底并保持窗口可见弹窗出现后手动完成验证不要急着关窗口等它跑完自然补齐browser_fallback: enabled: true headless: false现象想重新下载某个作品却被跳过。原因是双重去重起了作用——本地文件在就判定已完成。解法删掉本地对应文件夹即触发重下若要彻底清空某作者把本地目录和数据库记录dy_downloader.db中aweme表一起清掉。现象下载到一半断了要全部重来吗不用。完整性校验会清理不完整文件并自动重试重跑时已完成的直接跳过。速度偏慢就把thread默认 5和retry_times默认 3调大一些。现象批量下载时内存占用偏高。把thread调到 3每次任务控制在 50~100 个作品分批跑跑之前顺手确认磁盘空间高清视频比想象中吃容量。坑都排掉了最后把上手路径压缩成三条可执行的动作。下一步行动清单三步真正用熟抖音批量下载先试一个单视频用今天配置好的凭证下任意一条视频确认环境、Cookie、目录全部正常再跑一次整页批量选一位你真正喜欢的创作者mode: [post]number.post: 50跑一遍体验并行进度条和自动去重最后打开保险丝database: trueincrease.post: true固化增量下载之后按需叠加直播录制、评论采集或 API 服务。真正喜欢的内容值得留在本地——而让它留得省心、干净、不重复就是 douyin-downloader 的全部意义。【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 douyin-downloader 新手上手指南从单个无水印视频到整页批量与直播挂机【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader你存过的抖音视频是不是这样带着水印、文件名乱成一锅粥想存一整个作者主页又得手动点半天douyin-downloader 是一个免费开源的抖音无水印批量下载工具贴上链接它就能自动识别内容类型落盘无水印顺手把去重也办了。先看清边界抖音批量下载它能做哪些、不能做哪些这一章帮你把预期对齐三分钟看完能力清单避免装完才发现这个功能没有。能做的按内容类型分四组单条内容视频、图文note、合集mix、音乐原声四类链接都能直接下v.douyin.com/xxx短链会自动解析成真实地址主页批量贴作者主页链接按post作品/like点赞/mix合集/music音乐四种模式拉取数量和发布时间范围都能约束收藏夹当前登录账号的收藏夹/收藏合集整体搬走collect/collectmix模式直播录制FLV/HLS 流都能录主播下播时已录数据保留下载时默认优先挑无水印的最高清源按bit_rate自动选最高码率并可以按开关附带封面、背景音乐、作者头像和元数据 JSON。调查与自动化方向还有评论采集含二级回复输出 JSON、热搜榜与关键词搜索导出 JSONL、REST API 服务模式、下载完成推送通知、视频语音转写。做不到的同样说清楚收藏夹模式只认当前登录的 Cookie 账号且必须单独使用不能和post等模式混用收藏夹模式不支持增量浏览器兜底目前只对post完整验证like/mix/music的翻页主要依赖 API 正常返回HLS 直播源只保存 playlist 文件需要 ffmpeg 后处理成视频不代理别人的账号登录Cookie 只属于你本机确认边界后下面开始动手——本章目标只有一个跑通你的第一个无水印下载。如何完成首次运行安装 douyin-downloader 并拿到无水印视频的 4 个步骤本章给你最少步骤的完整路径装环境 → 拿凭证 → 写最简配置 → 运行。每步就一个动作、一条命令看到什么算成功下面都写死了。前提只有一条本机装了 Python 3.8 及以上。第一步克隆项目并安装依赖。这条命令把项目拉到本地并装上全部依赖看到 pip 输出Successfully installed就成功了。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip 慢或超时就换国内镜像再跑一遍pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple。如果以后要用浏览器兜底再装playwright并执行python -m playwright install chromium。第二步获取登录凭证Cookie。这条命令会自动弹出浏览器你扫码登录一次抖音回终端按回车看到config.yml里cookies字段被自动填上就成功了。python -m tools.cookie_fetcher --config config.yml⚠️ Cookie 有效期一般一到两周它只保存在本地不会上传任何服务器过期了重跑同一条命令即可其他配置都不用动。第三步写一份最小配置。先执行cp config.example.yml config.yml复制出配置文件然后把下面几个字段改成你的——链接换成你要的视频其余保持默认link: - https://www.douyin.com/video/7604129988555574538 # 换成你要的链接 path: ./Downloaded/ music: true # 同时下载背景音乐 cover: true # 同时下载封面图 json: true # 同时保存元数据第四步运行。这条命令按配置执行下载看到Downloaded/里出现无水印 mp4、命令行打出下载完成 成功: 1/1就是成功了。python run.py -c config.yml命令行会实时给出解析、进度和统计信息。如果你不习惯命令行项目还有一个同一套后端的桌面版客户端粘贴链接、识别内容类型、勾选要下载的作品/喜欢/合集一键开始。桌面版主界面粘贴链接 → 检测内容类型 → 勾选作品/喜欢/合集一键开始单条跑通只是热身这个工具真正的价值在整页。如何批量下载一位创作者的主页作品、喜欢、合集、收藏夹这一章解决我只想要某位创作者的全部内容不想一个个点。做法很直接把配置里的链接换成他的主页地址再指定模式。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 换成主页链接 mode: - post # 发布作品也可填 like / mix / music number: post: 50 # 只下最近 50 个0 表示全部 start_time: 2024-06-01 # 时间截取只搬这个窗口内发布的 end_time: 2024-06-30mode可以写多个多线程并行下载每个任务有独立进度条失败按指数退避自动重试同一个作品在不同模式下出现也不会下两遍跨模式自动去重。批量下载每个任务独立进度条并行执行、失败自动重试想把自己的收藏整体备份链接固定填self收藏页模式填collect收藏合集填collectmixlink: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect # 仅对当前登录账号生效需单独使用⚠️ 收藏夹模式不能与post/like/mix/music混写也不支持增量一次跑完整备份更稳妥。主页批量之外还有几个挂着就行的场景值得顺手配上。直播挂机录制与内容调研怎么做直播、评论、热搜、API 服务这一章把不靠手动点的场景一次讲完直播挂机、评论与热搜调研、以及接入你自己的工作流。直播录制。把直播间链接写进配置开播后挂着即可看到命令行打印出直播间信息和 FLV 流地址就成功了link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 一直录到主播下播录制文件落在Downloaded/{作者}/live/下附带直播间元数据快照主播下播、网络空闲或你手动中断时.tmp文件会自动提升为正式文件已录制的字节不丢。注意 HLS 源只存 playlist要拿完整视频需 ffmpeg 后处理。直播录制自动识别直播间、列出可选清晰度、拉取流地址开始录制内容调研。想分析某个视频下的讨论在配置里打开评论采集每个作品会多生成一份*_comments.jsoninclude_replies: true时二级回复也一并抓出comments: enabled: true include_replies: true # 抓二级回复请求量会变多 max_comments: 500不追特定博主、只想看今天抖音在聊什么下面两条命令直接出结果第一条导出热搜榜第二条按关键词搜作品成功标志是hot_board/和search/目录下各多出一个带时间戳的 JSONL 文件。python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded接入自己的工作流。想把它变成服务下面一条命令启动 REST 接口成功标志是POST /api/v1/download能提交任务、GET /api/v1/jobs/{job_id}能查状态pip install fastapi uvicorn python run.py --serve --serve-port 8000另外两个开关按需打开notifications支持 Bark / Telegram / Webhook下载完成直接推手机transcript.enabled: true配上OPENAI_API_KEY后每个视频会多生成txt/json两份文字转写方便检索。桌面版的任务中心则把每个任务的状态、耗时、结果集中展示跑完一眼可见。任务中心进行中/已完成/失败分栏展示可搜索、可打开下载目录任务越多越需要保险机制下一章讲它们默认怎么工作、哪里能定制。批量下载怎么开启去重增量、断点续传与命名模板这一章讲三个用了就回不去的机制去重、断点续传、自动整理命名帮你把跑一次任务永不重复劳动变成默认行为。去重与增量。底层是数据库 本地文件双重检查SQLite 里记录每个下载过的作品 ID同时扫描本地文件名兜底两边都查过才跳过。开启增量后再下同一位创作者时只拉新发布的作品。逻辑在 storage/database.py 与core/的下载主流程里。database: true increase: post: true # 下次运行自动跳过已下载作品只下新增断点续传。下载过程中会比对Content-Length文件不完整就自动清理重下任务中断后再次运行已完成的直接跳过只补缺失部分不用从头再来。命令行中的跳过已存在与下载统计去重生效成功/用时一目了然命名与目录。默认按发布时间 标题 ID给每个作品建独立文件夹mp4、封面、BGM、头像、元数据 JSON 放同一处根目录还有一份download_manifest.jsonl每行一条下载记录方便追溯。不满意默认规则就用模板变量改folderstyle: true filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id}可用变量有{date}、{title}、{id}、{author}、{year}、{month}等模板里必须保留{id}否则同标题作品会互相覆盖。设置里的命名模板作者目录、子目录、文件名规则均可自定义落盘效果就是下面这种按日期分门别类的结构找任何一个视频都像翻档案下载完成后的目录结构每个作品一个文件夹视频、封面、BGM、元数据齐全最后一个常见诉求想强制重新下载某个作品把它在Downloaded/里的文件夹删掉即可——本地文件没了、数据库记录还在程序会视为需要重新下载。机制都讲完了剩下的就是别踩坑。高频问题速修403、只抓到 20 条、中断下载与内存偏高下面是实际使用中命中率最高的五个问题每个都按现象 → 原因 → 解法给结论。现象突然报 403 Forbidden 或未登录。原因是 Cookie 过期这是最高频的一种。解法重跑同一条获取命令扫码登录一次即可。建议养成每周更新一次 Cookie 的习惯。现象批量下载只能抓到 20 条作品。原因是翻页触发了风控API 只放行第一页。解法是打开浏览器兜底并保持窗口可见弹窗出现后手动完成验证不要急着关窗口等它跑完自然补齐browser_fallback: enabled: true headless: false现象想重新下载某个作品却被跳过。原因是双重去重起了作用——本地文件在就判定已完成。解法删掉本地对应文件夹即触发重下若要彻底清空某作者把本地目录和数据库记录dy_downloader.db中aweme表一起清掉。现象下载到一半断了要全部重来吗不用。完整性校验会清理不完整文件并自动重试重跑时已完成的直接跳过。速度偏慢就把thread默认 5和retry_times默认 3调大一些。现象批量下载时内存占用偏高。把thread调到 3每次任务控制在 50~100 个作品分批跑跑之前顺手确认磁盘空间高清视频比想象中吃容量。坑都排掉了最后把上手路径压缩成三条可执行的动作。下一步行动清单三步真正用熟抖音批量下载先试一个单视频用今天配置好的凭证下任意一条视频确认环境、Cookie、目录全部正常再跑一次整页批量选一位你真正喜欢的创作者mode: [post]number.post: 50跑一遍体验并行进度条和自动去重最后打开保险丝database: trueincrease.post: true固化增量下载之后按需叠加直播录制、评论采集或 API 服务。真正喜欢的内容值得留在本地——而让它留得省心、干净、不重复就是 douyin-downloader 的全部意义。【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
![如何逐行读懂Keccak-f[1600]：XKCP中24轮置换的θρπχι五步拆解](http://pic.xiahunao.cn/yaotu/如何逐行读懂Keccak-f[1600]：XKCP中24轮置换的θρπχι五步拆解)
