抖音下载、直播录制、素材整理一网打尽:douyin-downloader 新手完整上手指南

发布时间:2026/8/20 10:12:38
抖音下载、直播录制、素材整理一网打尽: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 这个抖音下载工具一条命令就能化解视频、图文、合集、音乐、直播回放全都能存作者主页还能整页批量下载。下面这篇完整指南带你把它的用法一次摸透。先认识一下它替你干的活有多实在一句话说清它的定位一个跑在你电脑上的抖音下载器你把链接丢给它它把成品文件还给你。无水印优先、自动挑最高清、失败自动重试、重复内容自动跳过这些细节都内置好了不用你操心。它的本事清单五条就够概括能力说明单条下载视频、图文、合集、音乐都行短链v.douyin.com自动解析主页批量一个作者的作品、点赞、合集、原声一次全部拉下来直播录制FLV/HLS 两种格式主播中途下播也保住已录内容自动去重SQLite 数据库 本地文件双重检查绝不重复下载贴心细节进度条、并发下载、失败重试、时间过滤、浏览器兜底看到这种整排刷到 100% 的进度界面就是它批量下载时的日常——你只管把链接扔进去排队、重试、统计全是自动的。十分钟搭好你的下载工作台动手之前先说明一点项目拿到手后主程序在douyin-downloader子目录里后面所有命令都在这个目录下执行。需要 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如果后面想用浏览器兜底或自动获取 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认证信息会自动写进配置全程不用碰任何技术细节。这套自动登录机制还有一层保障中途检测到登录态失效程序会在非服务模式下自动拉起浏览器重新登录并重试不用你手动干预。从第一条视频开始把心动的东西留在硬盘配置就绪后最简单的玩法刷到喜欢的视频复制链接一条命令下载python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538-c指定配置文件-u是你想保存的视频链接。哪怕你拿到的是分享出来的短链那种https://v.douyin.com/xxxx它也会自动解析成完整地址再下载。下载完成后目录里不止有视频本体还附带封面图、背景音乐和一份 JSON 元数据。以后想查这个作品什么时候发的、原作者是谁、配乐叫什么翻开 JSON 一目了然——相当于顺手给每个作品建了张身份证。把整个作者主页搬回家批量下载的高阶用法如果你发现了一个宝藏创作者想把他全部内容都收进硬盘手动一个个点保存就太亏了。这个工具支持四种模式post发布的作品、like点赞过的、mix合集、music原声音乐。配置里填好链接和模式就行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/ └── 作者名_MS4wLjABAAAAxxxx/ ├── post/ # 作者发布的作品 ├── like/ # 作者点赞的作品 ├── mix/ # 合集内容 └── music/ # 原声音乐这是批量下载时的真实画面自动抓到 274 个作品按时间范围过滤已经存在的直接跳过5 个线程并发下载。你盯着进度条喝杯水它就干完了。顺便提一句当前登录账号的收藏夹也能下把链接填成https://www.douyin.com/user/self?showTabfavorite_collection模式用collect或collectmix即可注意收藏夹模式必须单独使用不能和上面四种混在一起。错过就没了的直播自己动手录一份短视频可以回头再看直播不一样——结束就是结束官方不一定有回放。知识分享、教学、赛事这类内容错过一场可能就再也补不回来。它的直播录制功能就是为这个准备的。在配置里加上直播链接和录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30运行后它会自动解析直播流地址拿到标题、在线人数和清晰度选项然后开始录制。录好的文件存放在Downloaded/作者名/live/目录下并附带一份直播间信息快照*_room.json。最贴心的是中断保护主播中途下播、网络断开甚至你按 CtrlC 手动停止已经录下来的字节都会被保留不会白录一场。需要说明两点FLV 格式录完即可直接播放如果源是 HLS程序保存的是 playlist 文件需要用 ffmpeg 做一步后处理。另外直播接口属于实验性功能部分场景可能覆盖不全遇到问题可以多试几次。下载完的素材库怎么才能不变成垃圾场批量下载最怕什么重复下载。同一个视频今天下了明天换个模式又下一遍硬盘白占空间目录还乱成一团。这个工具内置了 SQLite 去重再叠加本地文件双重检查。再配合增量下载和规范化命名你的素材库会一直保持清爽database: true # 开启数据库去重和历史记录 database_path: dy_downloader.db increase: post: true # 增量模式只下载新发布的作品 like: true mix: true music: true start_time: 2024-01-01 # 可选只想保存某个时间段的内容 end_time: 2024-12-31开启增量下载后它就相当于给你的资源库配了个记账本——上次下到哪一集、哪些已经存过它心里有数下次只补新内容。每个作品单独一个文件夹命名带日期和标题一眼就能找到想要的内容。这种秩序感手动整理是给不了的。如果你想重新下载某个作品需要同时清掉数据库记录和本地文件只删一个都不行程序会通过数据库加文件双重比对来判断。把工具的上限也用起来四个进阶入口基础功能用顺了下面这几个进阶能力能让体验再上一个台阶。① 热搜榜与关键词搜索想追热点或找某一类内容不用打开 App 慢慢翻。结果以 JSONL 格式导出方便做数据分析或内容选题python run.py --hot-board 30 # 拉取抖音热搜榜前 30 python run.py --search 猫咪 --search-max 100 # 搜索关键词相关内容② 下载完成自动通知批量下载动辄几十分钟不用干等完成后推送到手机notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY支持 Bark、Telegram也支持企业微信、飞书、钉钉这类 Webhook 机器人地址而且多个通知渠道可以并发推送单个失败不会影响下载主流程。③ REST API 服务模式把下载能力包装成 HTTP 接口集成到自己的系统里pip install fastapi uvicorn python run.py --serve --serve-port 8000之后就能通过接口提交下载任务、查询任务状态适合有自动化需求的玩家。④ 桌面版 Douzy项目还基于同一套后端做了桌面客户端目前处于内测期。粘贴链接就能开始下载可以同步关注列表还能可视化跟踪每个任务的实时进度——命令行适合自动化桌面版适合日常使用两条路线共用一套内核。新手最容易踩的坑一次说清问为什么只能抓到 20 条作品这是抖音翻页风控的常见现象。解决办法是确保配置里browser_fallback.enabled: true浏览器窗口弹出后手动过一下验证码不要急着关程序会自己继续翻页。注意浏览器兜底目前主要针对post模式做了完整验证like/mix/music还是主要依赖接口正常分页。问Cookie 失效了怎么办重新跑一次自动获取命令即可几十秒搞定python -m tools.cookie_fetcher --config config.yml问下载速度慢怎么优化把配置文件里的thread从默认 5 调到 8 试试另外在网络状况好的时段下载效果差异很明显。问怎么查看下载历史数据库就在当前目录用一条 SQL 就能查sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;问进度条刷屏、日志太多怎么办默认配置里progress.quiet_logs: true已经在进度阶段自动静默日志正常使用不用管。想调试时再加--show-warnings或-v临时打开。从第一条命令开始建立你的抖音资源库工具本身不复杂难的只是迈出第一步。现在你就可以做三件事克隆项目并安装依赖上面的三条命令跑一次 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),仅供参考