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 去重和浏览器兜底。无论你是刚入坑的新手还是想把它接进自己系统的进阶玩家这篇文章都能让你今天就跑起来。它到底解决了什么问题说白了它就是一个会替你干活的抖音下载器把链接丢给它剩下的解析、排队、下载、重试、统计全是自动的。你可以把它想成一位不知疲倦的资源管家——你说要什么它按你定好的规则把文件整整齐齐放好还会记下哪些已经存过下次绝不再下重复的。你只需要把精力留给想存什么而不是怎么存。三分钟跑通第一条命令先把项目克隆下来进入主程序目录并安装依赖需要 Python 3.8 及以上Windows / macOS / Linux 都能跑git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt克隆完成后主程序在douyin-downloader子目录里之后的命令都在这个目录下执行。接着复制一份配置文件后面所有设置都写在里面cp config.example.yml config.yml然后是最省心的认证环节。很多人被抖音下载器劝退都是卡在手动复制 Cookie上——翻开发者工具半天还复制不全。这个工具把整件事自动化了运行下面命令会自动打开浏览器你正常登录一次抖音回到终端按一下回车认证信息就写进配置了python -m tools.cookie_fetcher --config config.yml认证完成就能跑第一条下载命令了。挑一个你想保存的视频把链接放进-u参数python run.py -c config.yml -u https://www.douyin.com/video/1234567890123456789下载完成后目录里会同时生成视频本体、封面图、背景音乐和一份 JSON 元数据作品的完整信息都被留了下来。下图就是批量下载时的真实画面一行行进度刷到 100%全程不用人盯着。单条视频、图文、合集、音乐从链接到文件-u参数能认的链接类型比你想的多视频/video/...、图文/note/...、合集/collection/...、音乐/music/...都可以连v.douyin.com开头的短链也会自动解析成完整地址你从抖音 App 复制出来是什么样就贴什么样不用自己翻译。想同时下多个链接也简单多写几个-u就行python run.py -c config.yml -u https://www.douyin.com/video/111 -u https://www.douyin.com/note/222文件命名默认是日期_标题_作品ID每个作品单独一个文件夹封面、音乐、元数据都跟视频放在一起想回溯某个作品的完整信息时一目了然。作者主页批量下载作品、点赞、合集、音乐一次打包单条下载只是热身真正的重头戏是作者主页整页打包。找到心仪的创作者把他的主页链接写进配置再告诉工具要哪些内容、各下多少条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剩下的交给程序。它会按作者名自动建目录作品、点赞、合集、音乐分门别类存放目录结构长这样Downloaded/ └── 作者名/ ├── post/ # 发布的作品 ├── like/ # 点赞的作品 ├── mix/ # 合集内容 └── music/ # 音乐作品下图是批量下载时的统计界面自动抓到了 274 个作品按时间范围过滤已存在的内容直接跳过5 个线程并发干活你盯着进度条喝水就行。特别说明一点mode里可以同时勾选多种类型同一个作品即使同时出现在发布和合集里也只会下载一次不会重复占硬盘。下载过程有多省心并发、重试与完整性校验批量下载最怕什么卡在一个失败链接上或者下到一半文件损坏。这个工具的默认行为就是冲着省心去的并发下载thread默认 5可以调到 8 甚至更高多线程同时拉文件失败重试retry_times控制重试次数按 1 秒、2 秒、5 秒的指数退避自动重试完整性校验下载后用 Content-Length 比对文件大小不完整的文件自动清理并重新下载不会给你留一堆坏文件静默模式progress.quiet_logs: true可以把阶段日志压到最简进度条保持清爽不刷屏。这些默认值已经适合大多数人想调整的话直接在config.yml里改对应项即可。下载中断了怎么办重跑一次命令已经完成的文件会被识别并跳过接着没下完的继续。重复下载不存在的去重与增量模式批量下载的另一个坑是重复同一个视频今天下了一遍明天换个模式又下一遍硬盘白占目录还乱。douyin-downloader 内置 SQLite 数据库加上本地文件双重检查同一个作品在不同模式下绝不会重复入库database: true # 开启数据库去重和历史记录 increase: post: true # 增量模式只下载新发布的作品 like: true mix: true music: true开启增量下载后它就像给素材库装了个记账本——上次下到哪一集、哪些已经存过它心里有数下次运行只补新内容。配合时间过滤还能精准锁定某段时间的作品start_time: 2024-01-01 end_time: 2024-12-31下图是下载完成后整理好的目录每个作品一个文件夹命名带日期和标题一眼就能找到想要的内容。这种秩序感手动整理是给不了的。直播也能留住回放自己动手录短视频错过还能刷回来直播结束就是结束。特别是知识分享、教学、赛事这类内容错过一场可能再也补不回来。douyin-downloader 的直播录制就是为这个准备的在配置里加上直播链接和录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30运行后它会自动解析出直播流地址下图就是解析现场自动读取直播间标题、在线人数和清晰度选项然后拿到流地址开始录制。更贴心的是即使主播中途下播、网络断开或者你按 CtrlC 中断已经录下的内容也会自动保留不会白录一场。录好的 FLV 文件存在Downloaded/作者名/live/目录下旁边还附一份直播间信息快照。有一点要留意FLV 格式可以直接播放HLS 源默认只保存播放列表文件需要再用 ffmpeg 处理一下。评论数据顺手一起带走如果你做内容分析或选题研究作品下的评论也是宝藏。在配置里打开评论采集每个作品下载时就会额外生成一份*_comments.jsoncomments: enabled: true include_replies: false # true 会多拉每条评论的二级回复 max_comments: 500 # 0 表示不限 page_size: 20进阶玩法让工具自己跑起来基础能力用顺了下面这些开关能让体验再上一个台阶也是进阶玩家最常问的部分。热搜榜与关键词搜索。想追热点或找某一类内容不用打开 App 慢慢翻直接在命令行拉取结果以 JSONL 格式导出方便做数据分析或内容选题python run.py --hot-board 30 # 拉取抖音热搜榜前 30 python run.py --search 猫咪 --search-max 100 # 搜索关键词相关内容REST API 服务模式。把下载能力包装成 HTTP 接口集成到自己的系统里。先装可选依赖再启动服务pip install fastapi uvicorn python run.py --serve --serve-port 8000之后就能通过POST /api/v1/download提交下载任务、GET /api/v1/jobs/{job_id}查询任务状态适合有自动化需求的场景。下载完成自动通知。批量下载动辄几十分钟不用干等完成后推送到手机notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY支持 Bark、Telegram以及企业微信、飞书、钉钉这类 Webhook 机器人地址所有渠道并发推送单个失败也不影响主流程。视频转写。想让下载的视频开口说话可以开启转写功能调用 OpenAI Transcriptions API 把视频音频转成文字稿输出 txt 和 json 两种格式方便做字幕或内容检索。不想敲命令桌面版 Douzy 在路上了。项目基于同一套后端做了桌面客户端目前内测中。粘贴链接就能开始下载任务中心能可视化跟踪每个任务的进度关注列表还能一键同步。下面三张图分别是它的下载配置、任务中心和实时进度界面命令行适合自动化桌面版适合日常使用两条路线共用一套内核。新手最容易卡住的几个问题快问快答问为什么只能抓到 20 条作品这是抖音翻页风控的常见现象。确保配置里browser_fallback.enabled: true遇到翻页受限时程序会弹出浏览器你手动过一下验证码不要急着关窗口它会自己继续翻页。问Cookie 失效了怎么办重新跑一次自动获取命令即可几十秒搞定python -m tools.cookie_fetcher --config config.yml问下载速度慢怎么优化把配置文件里的thread从默认的 5 调到 8 试试另外网络状况好的时段下载效果差异很明显。问怎么查看下载历史数据库就在当前目录一条 SQL 就能查sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;问想重新下载某个作品怎么办程序靠数据库记录 本地文件双重判断是否跳过想重下就删掉对应的本地文件夹和数据库记录再跑一次即可。现在就开始三步开启你的抖音素材库工具本身不复杂难的只是迈出第一步。现在你就可以做三件事克隆项目并安装依赖本文第一个代码块里的三条命令跑一次 Cookie 自动获取完成身份认证挑一个链接从单个视频下载开始体验一把一条命令收进硬盘的痛快。配置模板、官方说明和源码都在仓库里配置文件模板在douyin-downloader/config.example.yml详细文档在douyin-downloader/README.zh-CN.md下载核心逻辑在douyin-downloader/core/目录下想深入研究的随时可以翻。最后多说一句工具让下载变得简单也请把它用在正道上——遵守平台规则尊重创作者版权下载的内容仅供个人学习研究。好的工具加上正确的使用方式才能长久地为你服务。下一次直播即将开始或者那个你等了很久的视频再次出现时你已经有办法把它留住了。打开终端敲下第一行命令属于你的抖音资源库就从今天开始建立。【免费下载链接】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），仅供参考