抖音视频下载完整指南零基础玩转 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 就是答案。这个开源工具支持单个视频、图文、合集、音乐、直播录制和作者主页批量下载默认带进度条、失败重试、SQLite 去重和浏览器兜底。下面按先跑通、再批量、后补直播三级台阶带你走一遍全程只需要复制命令和填配置。一句话定位douyin-downloader 是一个开源的抖音批量下载工具面向想批量存内容、又不想折腾代码的个人用户。你只需要给链接、填配置剩下的排队、去重、重试、整理它全包。第一级台阶10 分钟跑通第一条抖音视频下载先从最常见的痛点说起刷到一条特别想保存的视频过去只能找在线去水印网站——粘贴链接、等解析、看广告下回来的还可能是糊的。douyin-downloader 把这件事压缩成三条命令。准备环境。项目基于 Python 3.8Windows、macOS、Linux 都能跑。克隆仓库并进入主程序目录git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt注意主程序在douyin-downloader子目录里后面所有命令都在这层目录执行。如果你打算用浏览器兜底或自动获取 Cookie再补装一个 Playwright非必需可以先跳过pip install playwright python -m playwright install chromium完成一次认证。抖音接口需要登录态。项目内置了自动获取 Cookie 的脚本你不用再去浏览器开发者工具里翻半天cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml运行后会自动打开浏览器你正常登录一次抖音回到终端按一下回车认证信息就写进config.yml了。全程不需要碰任何技术细节。下载第一条视频。拿到链接一行命令收进硬盘python run.py -c config.yml -u https://www.douyin.com/video/1234567890123456789-u是你要保存的视频链接-c指定配置文件。下载完成后每个作品会单独建一个文件夹里面包含视频本体、封面图、背景音乐和一份 JSON 元数据方便你以后回溯这个作品的全部信息。上图就是下载时的真实画面顶部提示正在获取作品数据下方每个任务以进度条实时刷新全部 100% 后自动进入下一个。这一步替你解决的是存一条视频要打开三个网站的老问题。第二级台阶把整个作者主页一次搬进硬盘第一级台阶解决单条下一个痛点是批量你关注了一个宝藏博主TA 的作品、合集、用的原声都想存手动一条条复制链接工作量直接劝退。douyin-downloader 对这种情况只需要一份配置文件。运行前准备打开作者主页复制地址栏里的链接形如https://www.douyin.com/user/xxxx填进配置文件的link字段再声明要下载哪些维度的内容link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post # 发布的作品 - like # 点赞的作品 - mix # 合集内容 - music # 音乐作品 number: post: 50 # 下载 50 个发布作品 like: 0 # 0 表示不限制数量全部下载怎么跑保存后直接运行python run.py -c config.yml程序会自动解析主页、分页抓取作品列表、按配置筛选然后以默认 5 个线程并发下载。跑完后目录自动按作者名分好层Downloaded/ └── 作者名/ ├── post/ # 发布的作品 ├── like/ # 点赞的作品 ├── mix/ # 合集内容 └── music/ # 音乐作品上图是批量下载的真实状态自动抓到 274 个作品按时间范围过滤已存在的内容直接跳过5 个线程并发推进你盯着进度条就行。这一步替你解决的是上百条内容手工一个个存的重复劳动。第三级台阶直播结束前把回放先录下来短视频错过可以重刷直播错过就真的没了——尤其是知识分享、教学、赛事这类内容官方不一定提供回放。这也是 douyin-downloader 把直播录制做成内置功能的理由。运行前准备把直播间链接填进配置再加一段录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30怎么跑python run.py -c config.yml程序会解析出直播流地址支持 FLV 和 HLS 两种格式自动读取标题、在线人数和清晰度选项后开始录制。上图是解析直播流的瞬间拿到直播间 ID、列出清晰度档位、输出可用的 FLV 流地址。录好的文件保存在Downloaded/作者名/live/目录下并附带一份直播间信息快照。更贴心的是即使主播中途下播、网络断开或你按 CtrlC 中断已经录下的字节都会被保留不会白录一场。这一步替你解决的是直播没存下来再也补不回来的遗憾。看懂配置文件每个参数管什么一次说清前面几个场景都在反复碰config.yml它是整个工具的控制台值得花两分钟把核心参数认全。下面是config.example.yml里最常动的几段link: # 下载入口一个链接占一行支持视频/图文/合集/音乐/用户主页/直播间 - https://www.douyin.com/video/xxxx path: ./Downloaded/ # 所有内容保存的根目录 thread: 5 # 并发下载数网速好可以调大到 8 retry_times: 3 # 单个作品失败后的重试次数 proxy: # 需要代理时填 http://127.0.0.1:7890 这类地址 database: true # 开启 SQLite 去重和历史记录 database_path: dy_downloader.db # 数据库文件位置默认在工作目录生成 start_time: # 只下载该日期之后发布的内容格式 YYYY-MM-DD end_time: # 只下载该日期之前发布的内容 folderstyle: true # 每个作品单独一个文件夹 filename_template: {date}_{title}_{id} # 文件命名模板必须保留 {id} 避免重名覆盖 browser_fallback: enabled: true # 翻页受限时自动打开浏览器允许你手动过验证码 headless: false # 保持 false让浏览器窗口可见方便人工操作几个需要留意的行为number.post: 0表示不限数量全量抓取mode里的collect/collectmix是收藏夹模式只能单独使用、不能和其他模式混用proxy同时作用于 API 请求和媒体下载。配合folderstyle和命名模板你的素材库会呈现上图这种秩序每个作品一个文件夹命名带日期和标题一眼就能定位。这一步替你解决的是下完一堆文件、目录乱成一团的收纳问题。让下载更省心的四个小开关基础功能跑顺后下面四个开关能让体验再上一个台阶。① 增量下载只补新内容不重复劳动。开启后程序会对照数据库只下载新增作品适合定期跟更博主increase: post: true # 只下载新发布的作品 like: true database: true # 增量模式依赖数据库记录② 时间过滤只保留某个时间段的素材。比如只想要去年的内容start_time: 2024-01-01 end_time: 2024-12-31③ 完成通知批量下载不用干等。下载动辄几十分钟时完成后推送到手机notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY同样支持 Telegram以及企业微信、飞书、钉钉这类 Webhook 机器人地址。④ 热搜榜与关键词搜索找素材不用打开 App。导出结果都是 JSONL方便做数据分析或内容选题python run.py --hot-board 30 # 拉取抖音热搜榜前 30存到 hot_board/ 目录 python run.py --search 猫咪 --search-max 100 # 搜索关键词相关内容存到 search/ 目录如果你有自动化需求还可以用python run.py --serve --serve-port 8000把下载能力包装成 REST API需先pip install fastapi uvicorn通过接口提交下载任务、查询任务状态。遇到问题先查这张表现象原因解决办法只能抓到 20 条作品抖音翻页风控确认browser_fallback.enabled: true浏览器弹出后手动过验证码不要急着关窗口提示 Cookie 失效登录态过期重跑python -m tools.cookie_fetcher --config config.yml几十秒搞定下载速度慢并发数太低或网络时段差把thread从 5 调到 8并选网络好的时段同一个作品反复下载去重没生效确认database: true程序靠数据库 本地文件双重判断去重想重新下载某个作品需要清记录删对应本地文件夹再用sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_idxxx;删记录想看下载历史记录在 SQLitesqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;现在就可以开始 工具本身不复杂难的只是迈出第一步。照着下面的清单10 分钟就能把第一条视频存进硬盘克隆项目并安装依赖第一级台阶的三条命令跑一次 Cookie 自动获取完成身份认证挑一个链接从单个视频下载开始。最后多说一句工具让下载变得简单也请把它用在正道上——遵守平台规则尊重创作者版权下载的内容仅供个人学习研究。好的工具加上正确的使用方式才能长久地为你服务。现在打开终端敲下第一行命令属于你的抖音素材库就从今天开始建立。【免费下载链接】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 就是答案。这个开源工具支持单个视频、图文、合集、音乐、直播录制和作者主页批量下载默认带进度条、失败重试、SQLite 去重和浏览器兜底。下面按先跑通、再批量、后补直播三级台阶带你走一遍全程只需要复制命令和填配置。一句话定位douyin-downloader 是一个开源的抖音批量下载工具面向想批量存内容、又不想折腾代码的个人用户。你只需要给链接、填配置剩下的排队、去重、重试、整理它全包。第一级台阶10 分钟跑通第一条抖音视频下载先从最常见的痛点说起刷到一条特别想保存的视频过去只能找在线去水印网站——粘贴链接、等解析、看广告下回来的还可能是糊的。douyin-downloader 把这件事压缩成三条命令。准备环境。项目基于 Python 3.8Windows、macOS、Linux 都能跑。克隆仓库并进入主程序目录git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt注意主程序在douyin-downloader子目录里后面所有命令都在这层目录执行。如果你打算用浏览器兜底或自动获取 Cookie再补装一个 Playwright非必需可以先跳过pip install playwright python -m playwright install chromium完成一次认证。抖音接口需要登录态。项目内置了自动获取 Cookie 的脚本你不用再去浏览器开发者工具里翻半天cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml运行后会自动打开浏览器你正常登录一次抖音回到终端按一下回车认证信息就写进config.yml了。全程不需要碰任何技术细节。下载第一条视频。拿到链接一行命令收进硬盘python run.py -c config.yml -u https://www.douyin.com/video/1234567890123456789-u是你要保存的视频链接-c指定配置文件。下载完成后每个作品会单独建一个文件夹里面包含视频本体、封面图、背景音乐和一份 JSON 元数据方便你以后回溯这个作品的全部信息。上图就是下载时的真实画面顶部提示正在获取作品数据下方每个任务以进度条实时刷新全部 100% 后自动进入下一个。这一步替你解决的是存一条视频要打开三个网站的老问题。第二级台阶把整个作者主页一次搬进硬盘第一级台阶解决单条下一个痛点是批量你关注了一个宝藏博主TA 的作品、合集、用的原声都想存手动一条条复制链接工作量直接劝退。douyin-downloader 对这种情况只需要一份配置文件。运行前准备打开作者主页复制地址栏里的链接形如https://www.douyin.com/user/xxxx填进配置文件的link字段再声明要下载哪些维度的内容link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post # 发布的作品 - like # 点赞的作品 - mix # 合集内容 - music # 音乐作品 number: post: 50 # 下载 50 个发布作品 like: 0 # 0 表示不限制数量全部下载怎么跑保存后直接运行python run.py -c config.yml程序会自动解析主页、分页抓取作品列表、按配置筛选然后以默认 5 个线程并发下载。跑完后目录自动按作者名分好层Downloaded/ └── 作者名/ ├── post/ # 发布的作品 ├── like/ # 点赞的作品 ├── mix/ # 合集内容 └── music/ # 音乐作品上图是批量下载的真实状态自动抓到 274 个作品按时间范围过滤已存在的内容直接跳过5 个线程并发推进你盯着进度条就行。这一步替你解决的是上百条内容手工一个个存的重复劳动。第三级台阶直播结束前把回放先录下来短视频错过可以重刷直播错过就真的没了——尤其是知识分享、教学、赛事这类内容官方不一定提供回放。这也是 douyin-downloader 把直播录制做成内置功能的理由。运行前准备把直播间链接填进配置再加一段录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30怎么跑python run.py -c config.yml程序会解析出直播流地址支持 FLV 和 HLS 两种格式自动读取标题、在线人数和清晰度选项后开始录制。上图是解析直播流的瞬间拿到直播间 ID、列出清晰度档位、输出可用的 FLV 流地址。录好的文件保存在Downloaded/作者名/live/目录下并附带一份直播间信息快照。更贴心的是即使主播中途下播、网络断开或你按 CtrlC 中断已经录下的字节都会被保留不会白录一场。这一步替你解决的是直播没存下来再也补不回来的遗憾。看懂配置文件每个参数管什么一次说清前面几个场景都在反复碰config.yml它是整个工具的控制台值得花两分钟把核心参数认全。下面是config.example.yml里最常动的几段link: # 下载入口一个链接占一行支持视频/图文/合集/音乐/用户主页/直播间 - https://www.douyin.com/video/xxxx path: ./Downloaded/ # 所有内容保存的根目录 thread: 5 # 并发下载数网速好可以调大到 8 retry_times: 3 # 单个作品失败后的重试次数 proxy: # 需要代理时填 http://127.0.0.1:7890 这类地址 database: true # 开启 SQLite 去重和历史记录 database_path: dy_downloader.db # 数据库文件位置默认在工作目录生成 start_time: # 只下载该日期之后发布的内容格式 YYYY-MM-DD end_time: # 只下载该日期之前发布的内容 folderstyle: true # 每个作品单独一个文件夹 filename_template: {date}_{title}_{id} # 文件命名模板必须保留 {id} 避免重名覆盖 browser_fallback: enabled: true # 翻页受限时自动打开浏览器允许你手动过验证码 headless: false # 保持 false让浏览器窗口可见方便人工操作几个需要留意的行为number.post: 0表示不限数量全量抓取mode里的collect/collectmix是收藏夹模式只能单独使用、不能和其他模式混用proxy同时作用于 API 请求和媒体下载。配合folderstyle和命名模板你的素材库会呈现上图这种秩序每个作品一个文件夹命名带日期和标题一眼就能定位。这一步替你解决的是下完一堆文件、目录乱成一团的收纳问题。让下载更省心的四个小开关基础功能跑顺后下面四个开关能让体验再上一个台阶。① 增量下载只补新内容不重复劳动。开启后程序会对照数据库只下载新增作品适合定期跟更博主increase: post: true # 只下载新发布的作品 like: true database: true # 增量模式依赖数据库记录② 时间过滤只保留某个时间段的素材。比如只想要去年的内容start_time: 2024-01-01 end_time: 2024-12-31③ 完成通知批量下载不用干等。下载动辄几十分钟时完成后推送到手机notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY同样支持 Telegram以及企业微信、飞书、钉钉这类 Webhook 机器人地址。④ 热搜榜与关键词搜索找素材不用打开 App。导出结果都是 JSONL方便做数据分析或内容选题python run.py --hot-board 30 # 拉取抖音热搜榜前 30存到 hot_board/ 目录 python run.py --search 猫咪 --search-max 100 # 搜索关键词相关内容存到 search/ 目录如果你有自动化需求还可以用python run.py --serve --serve-port 8000把下载能力包装成 REST API需先pip install fastapi uvicorn通过接口提交下载任务、查询任务状态。遇到问题先查这张表现象原因解决办法只能抓到 20 条作品抖音翻页风控确认browser_fallback.enabled: true浏览器弹出后手动过验证码不要急着关窗口提示 Cookie 失效登录态过期重跑python -m tools.cookie_fetcher --config config.yml几十秒搞定下载速度慢并发数太低或网络时段差把thread从 5 调到 8并选网络好的时段同一个作品反复下载去重没生效确认database: true程序靠数据库 本地文件双重判断去重想重新下载某个作品需要清记录删对应本地文件夹再用sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_idxxx;删记录想看下载历史记录在 SQLitesqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;现在就可以开始 工具本身不复杂难的只是迈出第一步。照着下面的清单10 分钟就能把第一条视频存进硬盘克隆项目并安装依赖第一级台阶的三条命令跑一次 Cookie 自动获取完成身份认证挑一个链接从单个视频下载开始。最后多说一句工具让下载变得简单也请把它用在正道上——遵守平台规则尊重创作者版权下载的内容仅供个人学习研究。好的工具加上正确的使用方式才能长久地为你服务。现在打开终端敲下第一行命令属于你的抖音素材库就从今天开始建立。【免费下载链接】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），仅供参考