抖音直播下载与主页批量下载开源工具 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晚上十点一场看了一个多小时的抖音直播下播了手机录屏却只存下了三分钟——App 内录屏受系统限制而你想把整场内容留档。这类需求用命令行工具更稳妥douyin-downloader 是一个开源的抖音直播下载与抖音视频下载工具直接抓取直播流并持续写入本地文件主播下播、网络波动甚至手动 CtrlC 中断已录制的部分都会被保留。它同时覆盖单条视频、图文、合集和作者主页批量场景去水印、去重、重试都是默认行为。 工具能力直播录制、主页批量与附加资源能力说明直播录制live.douyin.com/{room_id}链接直接触发自动挑选最高清 FLV 流落盘中断后保留已录数据主页批量下载解析/user/链接按 post / like / mix / music 模式批量拉取作品单条内容视频、图文、合集、音乐链接均可直接粘贴附加资源封面、背景音乐、头像、JSON 元数据全部按配置项独立开关去重与重试SQLite 加本地文件双重去重指数退避重试Rich 进度条展示清晰度控制video_quality可选 original / highest / 1080p / 720p 等档位适合内容运营、创作者留档、需要长期追踪某作者更新的人也适合想批量归档自己收藏夹的用户。 环境准备克隆仓库并安装依赖项目依赖集中在锁定的 requirements.txt 里装一次即可运行要求 Python 3.8 及以上git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt装完后把示例配置复制为正式配置config.example.yml 中已经写好了全部默认值复制后按需修改即可不用从零手写 YAMLcp config.example.yml config.yml若提示cp失败比如文件名拼写不同到仓库根目录确认示例文件是否存在运行入口固定为python run.py。 Cookie 怎么配置自动抓取与手动填写Cookie 决定了接口请求的登录态首次使用必须配置一次之后遇到登录态失效提示或主页只能翻到 20 条作品说明 Cookie 过期重新执行同一流程即可。推荐自动方式脚本会弹出一个 Chromium 窗口你在窗口里登录抖音然后回到终端按 EntermsToken、ttwid、odin_tt 等键值会自动写回 config.ymlpip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml若首行提示模块缺失说明前两条安装命令没跑完若窗口里没登录就按了 Enter抓到的是空 Cookie删掉 config/cookies.json 重跑一次。手动方式适合不想装浏览器内核的人用日常浏览器登录抖音网页版按 F12 打开开发者工具在 Application → Cookies 下复制 msToken、ttwid、odin_tt、passport_csrf_token 四个键值填进 config.yml 的cookies段保存。 场景实战直播、单条视频与主页批量下载命令三个场景共用一条入口命令差异只在链接和配置项。直播录制把直播间链接通过-u传入-p指定落盘目录。录制时长由 config.yml 中live.max_duration_seconds控制0 表示一直录到主播下播python run.py -c config.yml -u https://live.douyin.com/1234567890 -p ./Downloaded/成功后 FLV 文件落在Downloaded/{作者}/live/下可直接播放同目录附带直播间元数据快照回放类链接同样可被解析可用于抖音直播回放保存。单条视频短视频、图文、合集链接都按此方式传入v.douyin.com短链也支持程序会先解析再下载python run.py -c config.yml -u https://www.douyin.com/video/7341234567890123456 -p ./Downloaded/需要连封面和背景音乐一起保存时把 config.yml 里的cover和music改为 true 再运行。主页批量下载-u传作者主页链接-t指定并发。数量与模式在 config.yml 配置——mode: [post]表示下载其发布作品number.post: 0为全量写 50 则只取前 50 条python run.py -c config.yml -u https://www.douyin.com/user/MS4wLjABAAAAxxxx -p ./Downloaded/ -t 5结束后终端会输出成功 / 失败 / 跳过的汇总跳过多为数据库判定已下载过属正常去重。 参数速查run.py 常用命令行选项参数作用示例-c, --config指定配置文件默认 config.yml-c config.yml-u, --url追加下载链接可重复传入-u https://live.douyin.com/123-p, --path指定下载目录-p ./Downloaded/-t, --thread并发下载数-t 8-v, --verbose显示 info 及以上日志排查报错时用-v--hot-board N拉取热搜榜并导出 JSONLN 为条数上限--hot-board 30--search 关键词按关键词搜索作品并导出 JSONL--search 猫咪--version显示版本号--version更多配置项时间过滤、评论采集、完成通知等可参考 README 中的关键配置项一节。⚠️ 避坑与合规频率控制与使用边界频率rate_limit默认 2 请求/秒、thread默认 5大批量任务不要盲目拉高频繁请求会触发风控直接 403重试也无法绕过。翻页被限只抓到 20 条保持browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证码再关窗。配置位置config.yml 位于项目根目录改前建议备份Cookie 失效时重跑 cookie_fetcher 是最快的恢复方式。合规下载内容仅限个人学习与研究用途遵守抖音平台规则勿侵犯创作者版权与他人隐私。douyin-downloader 把直播录制、主页批量下载、去重重试收进一条命令配一次 Cookie 即可长期复用。如果它解决了你的留档需求欢迎到仓库点一个 star或转发给同样需要批量保存抖音内容的同事。【免费下载链接】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），仅供参考
