抖音视频无水印批量下载: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 编写,靠一份 YAML 配置文件驱动,Windows、macOS、Linux 上都能直接跑。
它适合三类人:想把喜欢的博主作品存下来离线看的普通用户;需要批量素材做二创、混剪的短视频创作者;以及要给账号内容做归档、顺手留下标题、点赞数、作者这些元数据 JSON 的运营人员。
几个让批量任务更省心的机制:下载记录写进本地 SQLite 数据库,重复运行会自动跳过已有作品;开启增量下载后,博主更新了几条就只拉几条;请求被限流或遇到验证码时,程序会自动弹出浏览器窗口,你手动过一次就能接着跑,不用从头再来。
核心能力总览
先用 30 秒看完它最拿手的四件事,再决定要不要往下读。
- 原始文件无水印下载:直接调抖音接口取回原始视频、图片和原声音频,不是录屏或转换站二次压缩的产物,拿到的就是平台存储的那档画质。
- 主页级批量下载:
link填用户主页地址即可,发布的作品、喜欢的列表、创建的合集、音乐(原声)四类内容都能批量拉取,thread控制并发线程数。 - ✅数据库防重复 + 增量:本地 SQLite 记录每个作品的 ID,再次运行自动跳过;
increase开启后只补下载新增内容。 - 失败自动恢复:网络抖动、限流导致的失败会自动重试;需要人工处理验证码时,程序把任务交给浏览器窗口,处理完继续下载。
V1.0 与 V2.0 版本怎么选
仓库提供两条入口脚本,先分清适用场景,能少走一半弯路。
- V1.0
DouYinCommand.py(稳定版):配置文件驱动,单个视频、图集、主页批量、直播都经过验证可用,日常使用首选。 - V2.0
downloader.py(增强版):支持--auto-cookie自动获取登录态、异步并发和智能重试,用户主页下载完全正常;但单个视频下载目前存在 API 返回空的已知问题。
一句话:下单个视频或求稳,用 V1.0;要自动 Cookie、高并发和增量,下载整个主页用 V2.0。
⚡ 快速上手:安装、Cookie 与首次下载
这一节带你从零走到第一个无水印视频落盘,总共就三条命令。
- 装环境:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt把仓库拉到本地并装好 Python 依赖,环境要求 Python 3.9+。
- 拿登录态(Cookie):
cp config.example.yml config.yml python cookie_extractor.py程序会弹出浏览器窗口,扫码登录一次抖音账号,Cookie 自动写回配置,之后基本不用管。若提示缺 Playwright,先执行pip install playwright和playwright install chromium再试;不想装浏览器的话,也可以跑get_cookies_manual.py,按图文引导从开发者工具复制 Cookie。
- 下载第一个视频:把
config.yml里link改成单条视频链接(v.douyin.com短链或douyin.com/video/直链都行),然后运行:
python DouYinCommand.py进度条走完,打开Downloaded/目录,视频、封面、原声音频和元数据 JSON 已经按作品分好文件夹了。
批量下载配置说明:主页作品一次下完
这一节把主页批量下载的几个关键配置项讲透,照着改就能跑。
把config.yml改成下面这样:
link: - https://www.douyin.com/user/你的主页链接 mode: [post] number: { post: 0 } # 0 表示不限制数量 thread: 5mode决定下哪几类内容:post是发布的作品,like是 ta 喜欢的,mix是 ta 创建的合集,可以写成多选;number各项填 0 就是全量,填数字则只下最新的 N 条。运行python DouYinCommand.py后,终端里每个作品一行状态,多线程序列拉取,结束时自动汇总成功、失败、跳过的数量。
下完之后文件不是堆在一个文件夹里的,目录会自动分层:
Downloaded/作者名_用户ID/post/:发布的作品,每个作品一个独立文件夹like/、mix/:喜欢的作品与合集,按mode生成- 每个作品文件夹里:
.mp4视频、_cover.jpg封面、_music.mp3原声、data.json元数据
- 不想建这么多文件夹,把
folderstyle改成False,文件直接平铺保存
进阶玩法:直播、音乐与时间过滤
批量下载之外的几个用法,按需求挑着用。
- 🔴直播录制:把直播间地址直接作为链接传入,程序解析后录制直播流,断线自动重连、分段保存:
python DouYinCommand.py --link "https://live.douyin.com/直播间ID"- 音乐(原声)收藏:
link指向douyin.com/music/页面,number.music控制拉取多少条用了这首音乐的作品,适合按 BGM 收集素材。 - 按时间筛选:
start_time/end_time填YYYY-MM-DD,只下指定时间段内的作品,比如只留某活动期间的内容。 - 追更模式:
increase.post: true配合数据库使用,博主更新几条就只下几条,定期跑一次即可保持本地库最新。
常见问题与解决办法
下载卡住时先来这里对照,多数问题有现成解法。
Cookie 失效或提示重新登录怎么办
Cookie 有有效期,重新跑一次python cookie_extractor.py扫码登录即可,程序会覆盖旧值写回配置。
V2.0 下载单个视频没有结果怎么办
这是当前的已知 API 问题。换 V1.0 的DouYinCommand.py即可,或者把该视频所在的主页用批量模式下载。
批量下载中途变慢或失败增多
多半是触发了限流。先把thread调小一点,程序会自动重试;如果弹出了验证码浏览器窗口,手动完成验证后任务会继续。
重复运行会不会重复下载
不会。database: True时,已下载作品 ID 记在本地 SQLite(data.db)里,二次运行自动跳过;开启increase后更是只补新增内容。
上手三步与注意事项
把前面的内容压缩成三个动作,按顺序执行就能开始第一次批量下载。
- 克隆并安装:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader,再pip install -r requirements.txt - 配置 Cookie:
python cookie_extractor.py扫码登录一次 - 填链接跑任务:
link里放视频或主页地址,python DouYinCommand.py开始下载
最后提醒一句: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),仅供参考