抖音批量下载工具 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 把这件事交给配置文件给它一个主页链接它按发布时间把作品拆成无水印文件存进本地图集、合集、音乐也能一并处理。本文从安装讲起带你把作者主页作品下载、合集下载、收藏夹备份三种常见需求各跑一遍。快速跑起来安装、配置与首次下载工具依赖 Python 3.8 及以上版本Windows、macOS、Linux 都能运行。先把仓库拉下来并装上依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果希望翻页受限时自动弹出浏览器兜底应对平台风控、人工过验证码再补装 Playwright 并下载浏览器内核pip install playwright python -m playwright install chromium配置建议从仓库自带的示例复制一份再改示例文件是 config.example.yml。复制后填上链接与目录cp config.example.yml config.yml下面是一份完整配置第一次使用可整体参考之后通常只需改link和path两处link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 0 thread: 5 retry_times: 3 database: true database_path: dy_downloader.db progress: quiet_logs: true browser_fallback: enabled: true headless: false cookies: msToken: ttwid: YOUR_TTWID odin_tt: YOUR_ODIN_TTCookie 决定批量下载能否走通用内置抓取脚本最省事。它会打开一个登录窗口登录抖音后回到终端按 EnterCookie 会自动写回 config.ymlpython -m tools.cookie_fetcher --config config.yml配置就绪后跑第一次下载python run.py -c config.yml不想每次改配置的话也可以在命令行临时补链接、目录与并发数例如python run.py -u https://www.douyin.com/user/MS4wLjABAAAAxxxx -t 8 -p ./Downloaded。同一套后端还做了个桌面端 Douzy粘贴链接即可开始任务在本地统一管理场景一作者主页作品批量无水印下载目标把某作者主页的作品全部存成本地无水印视频并按发布时间归类。关键就在mode选postnumber.post设 0 表示不限数量全量抓取mode: - post number: post: 0文件与目录默认带作品发布日期前缀形如2024-02-07_标题_aweme_id同一作者的作品落在Downloaded/作者名/post/下另外附封面、原声、头像和 JSON 元数据。想只取某一段时间可加start_time/end_time格式为YYYY-MM-DD。预期结果下载目录里出现按日期加标题命名的子文件夹视频无水印音乐与封面一并到位还生成一份download_manifest.jsonl清单。场景二合集下载把系列内容成组整理目标把一个合集例如某系列教程里的视频一次性下齐按合集归档。两种入口直接给合集链接/collection/{mix_id}或在用户主页把mode设为mix。单个合集更省事link: - https://www.douyin.com/collection/7341234567890123456 mode: - mix number: mix: 0预期结果合集内视频按发布时间排序落到mix/目录并生成 JSON 元数据方便后续回看。跨模式去重保证了同一个作品即使出现在多个模式里也只下载一次。各模式的策略实现集中在 core/user_modes/。场景三备份当前账号的收藏夹目标把当前登录账号收藏的作品或收藏合集整体备份下来。收藏夹模式collect收藏作品与collectmix收藏合集只认当前 Cookie 对应的账号而且必须单独使用不能与 post / like / mix / music 混开。链接固定用 self 地址link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect number: collect: 0预期结果收藏内容落到collect/或collectmix/子目录适合作为个人内容归档。桌面端也提供了收藏与喜欢管理可以同步后整批下载进阶能力速览REST API 服务pip install fastapi uvicorn后运行python run.py --serve --serve-port 8000对外提供POST /api/v1/download、GET /api/v1/jobs/{job_id}、GET /api/v1/jobs等接口方便其他程序调用。增量下载increase.post: true配合database: true只拉取新作品避免重复劳动。直播录制填live.douyin.com/{room_id}配live.max_duration_seconds0 表示录到主播下播下播后保留已录字节。热搜与搜索--hot-board 30导出热搜 JSONL--search 关键词 --search-max 100抓取搜索结果。评论采集comments.enabled: true可在媒体文件旁生成*_comments.json。完成通知notifications.providers支持 Bark / Telegram / Webhook 推送。问题排查只能下到前 20 条作品现象是翻页停在 20 条附近。原因是平台对非浏览器请求有风控限制。解决确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动过验证不要急着关窗口。Cookie 经常失效现象是下载中途提示登录态过期。原因是 Cookie 有有效期。解决重新执行一次python -m tools.cookie_fetcher --config config.yml刷新即可。想重下某个作品程序靠数据库记录 本地文件名里的 aweme_id双重判断是否跳过只删其中一处不会触发重下。要重下需同时清理文件与数据库记录rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;进度刷屏、日志混乱默认progress.quiet_logs: true会在进度阶段静默日志需要排查时再加--show-warnings或-v临时查看。适用人群与合规提醒这套工具适合需要长期收集抖音内容的创作者、研究者或重度用户既能单条存无水印视频也能整站抓作者主页作品、合集与收藏夹还能接 API、录制直播、自动去重。请使用时注意合规下载内容仅限个人学习与研究尊重原作者版权遵守抖音平台规则引用时注明来源与作者。【免费下载链接】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-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 把这件事交给配置文件给它一个主页链接它按发布时间把作品拆成无水印文件存进本地图集、合集、音乐也能一并处理。本文从安装讲起带你把作者主页作品下载、合集下载、收藏夹备份三种常见需求各跑一遍。快速跑起来安装、配置与首次下载工具依赖 Python 3.8 及以上版本Windows、macOS、Linux 都能运行。先把仓库拉下来并装上依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果希望翻页受限时自动弹出浏览器兜底应对平台风控、人工过验证码再补装 Playwright 并下载浏览器内核pip install playwright python -m playwright install chromium配置建议从仓库自带的示例复制一份再改示例文件是 config.example.yml。复制后填上链接与目录cp config.example.yml config.yml下面是一份完整配置第一次使用可整体参考之后通常只需改link和path两处link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 0 thread: 5 retry_times: 3 database: true database_path: dy_downloader.db progress: quiet_logs: true browser_fallback: enabled: true headless: false cookies: msToken: ttwid: YOUR_TTWID odin_tt: YOUR_ODIN_TTCookie 决定批量下载能否走通用内置抓取脚本最省事。它会打开一个登录窗口登录抖音后回到终端按 EnterCookie 会自动写回 config.ymlpython -m tools.cookie_fetcher --config config.yml配置就绪后跑第一次下载python run.py -c config.yml不想每次改配置的话也可以在命令行临时补链接、目录与并发数例如python run.py -u https://www.douyin.com/user/MS4wLjABAAAAxxxx -t 8 -p ./Downloaded。同一套后端还做了个桌面端 Douzy粘贴链接即可开始任务在本地统一管理场景一作者主页作品批量无水印下载目标把某作者主页的作品全部存成本地无水印视频并按发布时间归类。关键就在mode选postnumber.post设 0 表示不限数量全量抓取mode: - post number: post: 0文件与目录默认带作品发布日期前缀形如2024-02-07_标题_aweme_id同一作者的作品落在Downloaded/作者名/post/下另外附封面、原声、头像和 JSON 元数据。想只取某一段时间可加start_time/end_time格式为YYYY-MM-DD。预期结果下载目录里出现按日期加标题命名的子文件夹视频无水印音乐与封面一并到位还生成一份download_manifest.jsonl清单。场景二合集下载把系列内容成组整理目标把一个合集例如某系列教程里的视频一次性下齐按合集归档。两种入口直接给合集链接/collection/{mix_id}或在用户主页把mode设为mix。单个合集更省事link: - https://www.douyin.com/collection/7341234567890123456 mode: - mix number: mix: 0预期结果合集内视频按发布时间排序落到mix/目录并生成 JSON 元数据方便后续回看。跨模式去重保证了同一个作品即使出现在多个模式里也只下载一次。各模式的策略实现集中在 core/user_modes/。场景三备份当前账号的收藏夹目标把当前登录账号收藏的作品或收藏合集整体备份下来。收藏夹模式collect收藏作品与collectmix收藏合集只认当前 Cookie 对应的账号而且必须单独使用不能与 post / like / mix / music 混开。链接固定用 self 地址link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect number: collect: 0预期结果收藏内容落到collect/或collectmix/子目录适合作为个人内容归档。桌面端也提供了收藏与喜欢管理可以同步后整批下载进阶能力速览REST API 服务pip install fastapi uvicorn后运行python run.py --serve --serve-port 8000对外提供POST /api/v1/download、GET /api/v1/jobs/{job_id}、GET /api/v1/jobs等接口方便其他程序调用。增量下载increase.post: true配合database: true只拉取新作品避免重复劳动。直播录制填live.douyin.com/{room_id}配live.max_duration_seconds0 表示录到主播下播下播后保留已录字节。热搜与搜索--hot-board 30导出热搜 JSONL--search 关键词 --search-max 100抓取搜索结果。评论采集comments.enabled: true可在媒体文件旁生成*_comments.json。完成通知notifications.providers支持 Bark / Telegram / Webhook 推送。问题排查只能下到前 20 条作品现象是翻页停在 20 条附近。原因是平台对非浏览器请求有风控限制。解决确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动过验证不要急着关窗口。Cookie 经常失效现象是下载中途提示登录态过期。原因是 Cookie 有有效期。解决重新执行一次python -m tools.cookie_fetcher --config config.yml刷新即可。想重下某个作品程序靠数据库记录 本地文件名里的 aweme_id双重判断是否跳过只删其中一处不会触发重下。要重下需同时清理文件与数据库记录rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;进度刷屏、日志混乱默认progress.quiet_logs: true会在进度阶段静默日志需要排查时再加--show-warnings或-v临时查看。适用人群与合规提醒这套工具适合需要长期收集抖音内容的创作者、研究者或重度用户既能单条存无水印视频也能整站抓作者主页作品、合集与收藏夹还能接 API、录制直播、自动去重。请使用时注意合规下载内容仅限个人学习与研究尊重原作者版权遵守抖音平台规则引用时注明来源与作者。【免费下载链接】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），仅供参考
