
抖音批量下载命令行覆盖单视频、用户主页与直播回放的全流程【免费下载链接】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-downloaderdouyin-downloader 是一个 Python 命令行工具面向抖音批量下载场景输入视频、图文、合集、音乐或用户主页链接自动选择无水印源、并发下载并按作者与日期归档内置 SQLite 记录、限速重试与浏览器兜底翻页。适用场景速览场景输入形式输出形式耗时参考单视频去水印存档/video/{aweme_id}链接或v.douyin.com短链mp4可附封面/音乐/JSON单条约 10 秒起取决于码率用户主页批量采集/user/{sec_uid}链接 mode配置作者/模式/日期三级目录 下载清单50 条约数分钟到数十分钟合集或原声音乐下载/collection/{mix_id}、/music/{music_id}与作品同构的媒体文件随条目数线性增长直播回放下载webcast/reflow/episode回放链接ffmpeg 转封装后的可播放文件与回放时长相当安装与初始化环境要求 Python 3.8macOS / Linux / Windows 均可。最小可运行路径如下git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt准备配置并抓取 Cookie。cookie_fetcher会弹出浏览器登录抖音后回到终端按回车Cookie 自动写入配置文件cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml最后把要抓的链接填进config.yml的link字段列表格式跑第一条命令python run.py -c config.yml配置里有几个关键字段值得先看懂mode决定采集内容post发布作品、like点赞、mix合集、music音乐number.post等按模式限制条数0表示不限path指定落盘目录thread是并发数默认 5。核心能力拆解单视频去水印下载一个链接换一份无水印原片工具会从video.bit_rate码率阶梯里自动挑源优先去水印版本。最短命令python run.py -u https://www.douyin.com/video/AWEME_ID最重要的参数是video_qualityhighest默认只取转码最高档、original额外发一次探测请求找上传原片失败自动回退、1080p等指定分辨率匹配不到时就近降级。Downloaded/旅行摄影日记/post/2024-02-07_山顶日出_7604129988555574538/ └── 2024-02-07_山顶日出_7604129988555574538.mp4用户主页批量采集给一个/user/链接工具分页拉取作品列表按发布时间排序后并发下载支持多模式同时开跨模式按aweme_id去重。最短命令python run.py -u https://www.douyin.com/user/SEC_UID最重要的参数是number.post设 50 就只取前 50 条设 0 全量抓完同名字段对like、mix、music各自生效。post 模式: 共 48 条其中 12 条命中磁盘增量跳过 ✓ 36 条写入 Downloaded/旅行摄影日记/post/桌面端把同一后端的关注同步做得更直观列表上直接标注新作品数量单条或批量发起下载。直播回放下载回放链接解析出episode_id与room_id拉取回放信息后经 ffmpeg 转封装为可播放文件直播间的实时录制走 FLV 流主播下播或网络空闲 30 秒时把已录部分落盘不会丢前段数据。最短命令python run.py -u https://webcast.amemv.com/douyin/webcast/reflow/episode/EPISODE_ID最重要的前提是系统装有 ffmpeg转封装超时上限 600 秒。Downloaded/主播昵称/live/2026-04-24_2215_直播标题_123456789/ └── 2026-04-24_2215_直播标题_123456789.mp4关键词搜索与热榜导出不下载媒体只把结果转储成 JSONL适合先做数据摸底再决定批量下载范围。最短命令python run.py --search 猫咪 --search-max 100 -p ./Downloaded最重要的参数是--search-max默认 50控制单关键词最多落盘条数--hot-board 30则直接导出热榜 Top 30。./Downloaded/search/猫咪_20260424_221530.jsonl # 100 行 ./Downloaded/hot_board/20260424_221530.jsonl文件组织与去重机制默认folderstyle: true时按「作者/模式/日期_标题_id」落盘日期取自作品发布时间create_time缺失才回退当天日期。文件与目录名都由filename_template/folder_template渲染模板变量有{date} {title} {id} {author}等硬性要求包含{id}防止重名覆盖。Downloaded/ ├── download_manifest.jsonl └── 作者昵称/ ├── post/ │ └── 2024-02-07_标题_aweme_id/ │ ├── ...mp4 / _cover.jpg / _music.mp3 │ └── ..._data.json └── live/每次下载还会向download_manifest.jsonl追加一行记录aweme_id、作者、标题、日期方便后续做统计分析。去重是「SQLite 记录 磁盘文件」双重判断database_path指向的dy_downloader.db默认dy_downloader.db存历史元数据真正的增量跳过由increase.post等开关控制——磁盘上主媒体文件存在且非空才跳过删掉文件下次就会重下。注意方向性只删数据库而保留文件不会触发重下程序扫本地文件名里的aweme_id只删文件保留数据库则会触发。批量任务跑完后的状态核对可以在任务视图完成成功/失败计数、按作者筛选、失败项单独重跑。参数速查参数作用推荐值-u, --url追加下载链接可重复传入按需-c, --config指定配置文件config.yml-p, --path覆盖下载目录./Downloaded-t, --thread并发数覆盖配置中的thread3~5mode采集模式post/like/mix/music收藏模式collect/collectmix需单独用按场景number.post等各模式条数上限0 不限0 或具体值increase.post等磁盘增量开关true 跳过已存在主文件truestart_time/end_time时间过滤格式YYYY-MM-DD按范围video_quality画质选择highestretry_times失败重试次数指数退避 1s/2s/5s3browser_fallback.headless翻页受限时的浏览器兜底开关false需人工过验证comments.enabled每作品附带评论 JSONfalse已知限制与边界浏览器兜底翻页只对post模式完整验证过like/mix/music仍依赖 API 分页workaround 是优先用post模式做主页采集。收藏模式collect/collectmix只能用于 Cookie 对应的登录账号本身且不能与其他模式混开。实时录制原生保存 FLVHLS 源只保存播放列表需要 ffmpeg 才能出可播放文件。平台风控可能把 API 翻页压到 20 条左右workaround 是开启browser_fallback.enabled: true并在弹出的浏览器里手动完成验证别过早关窗。Cookie 过期没有续期机制下载报 Cookie 无效时重新跑一次python -m tools.cookie_fetcher --config config.yml。延伸阅读与代码入口下载器工厂与各类下载器分发core/downloader_factory.py用户主页各模式策略post/like/mix/music 分离实现core/user_modes/SQLite 历史库与去重记录storage/database.py请求签名与反爬参数生成utils/xbogus.py入口与主循环run.py【免费下载链接】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),仅供参考