☰
DouyinLiveRecorder 使用指南:直播录制、时间戳字幕与批量值守,10 分钟跑通第一次
2026/11/5 3:38:42 网站建设 项目流程

DouyinLiveRecorder 使用指南:直播录制、时间戳字幕与批量值守,10 分钟跑通第一次

【免费下载链接】DouyinLiveRecorder可循环值守和多人录制的直播录制软件,支持抖音、TikTok、Youtube、快手、虎牙、斗鱼、B站、小红书、pandatv、sooplive、flextv、popkontv、twitcasting、winktv、百度、微博、酷狗、17Live、Twitch、Acfun、CHZZK、shopee等40+平台直播录制项目地址: https://gitcode.com/gh_mirrors/do/DouyinLiveRecorder

DouyinLiveRecorder 是一个跨 40 多平台的直播录制工具:把直播间地址填进配置文件,它会循环值守、发现开播就调用 FFmpeg 录制音视频,支持多房间批量录制、分段保存和时间戳 SRT 字幕,并能推送开播、关播通知。需要说明的是,它录制的是音视频流,不采集弹幕文本。

它适合什么,不适合什么

两个典型用法。第一个:运营团队要把某场直播带货完整留存,用于复盘和合规存档,直播期间没人盯着,工具负责 7x24 值守。第二个:内容团队做切片,需要"第 47 分钟观众问到了哪款商品"这类秒级定位,时间戳字幕文件就是干这个的。

三个限制先讲在前面,避免你走弯路:

  • 本仓库不包含弹幕采集模块。部分文章宣称它能输出弹幕的 JSON、SRT、ASS 三种格式,在当前代码里并不存在,别按那些说法找配置项;
  • 平台 Cookie 会过期,失效后录制会反复失败,需要你定期手动更新;
  • 录制依赖各平台网页接口,平台改版时可能暂时失效,以运行日志为准。

十分钟备好环境

  1. 拉取代码并安装依赖,要求 Python 3.10 及以上:
git clone https://gitcode.com/gh_mirrors/do/DouyinLiveRecorder cd DouyinLiveRecorder pip install -r requirements.txt
  1. 确认 FFmpeg 可用。项目里 ffmpeg_install.py 会尝试按系统自动安装,建议仍手动装一遍,启动时运行ffmpeg -version能打印版本即可。

  2. 填直播间地址:编辑 config/URL_config.ini,一行一个地址;行首可加画质和名称,如超清,https://live.douyin.com/745964462470,主播: 某某;不录时给行首加#。

  3. 填 Cookie:编辑 config/config.ini 的[Cookie]段,抖音cookie为录制抖音必填。获取方式:浏览器登录网页版抖音,按 F12 打开开发者工具,从任意请求头里复制完整 Cookie 串粘贴进去;快手、B 站等其余平台同理。Cookie 是时效性凭证,失效是后续最常见的故障来源。

第一次完整录制

下面是最小可用配置,只动几个关键键,其余保持默认,完整键位参考项目根目录的 config/config.ini。

[录制设置] 视频保存格式ts|mkv|flv|mp4|mp3音频|m4a音频 = ts ; 中断时最不伤文件,推荐 分段录制是否开启 = 是 视频分段时间(秒) = 1800 ; 默认 1800,每 30 分钟切一个分片 生成时间字幕文件 = 是 ; 产出 SRT,供时间定位 同一时间访问网络的线程数 = 3 ; 默认 3,控制并发请求数 循环时间(秒) = 120 ; 默认 120,未开播时的检测间隔 # 其余键位省略,保持默认 [Cookie] 抖音cookie = 你从浏览器复制的完整 Cookie 串 # 其余平台 Cookie 省略

启动命令(Linux 用python3 main.py):

python main.py

控制台出现xxx 正在直播中...并显示保存路径,说明录制已经开始。跑通之后做三件事:

  1. 找文件:视频落在项目根目录downloads/平台名/作者名/下,文件名包含开播时间戳;
  2. 看格式:默认是 ts 分片流,可直接用播放器或 ffmpeg 打开,也可在配置里打开录制完成后自动转为mp4格式 = 是让程序自动转封装;
  3. 验证完整:同目录下会生成同名.srt,每秒一条时间戳,统计行数并与视频总时长对照,接近即说明没有中途断流;SRT 缺失或行数明显偏少,说明录制中断过。

三个真实场景

场景一:单房间长时间录制

目标:挂机 8 小时以上,落盘不丢、磁盘不爆。 配置要点:保持分段录制是否开启 = 是与视频分段时间(秒) = 1800;把循环时间(秒) = 300拉长,降低未开播时的请求频率;录制空间剩余阈值(gb) = 1.0(默认 1.0)表示磁盘剩余低于 1 GB 时停止并退出,可提前收到告警;再在[推送配置]里把直播状态推送渠道设为钉钉或微信并填好接口链接,开播推送开启、关播推送开启均为是,直播状态变化时由 msg_push.py 推送。 数据怎么用:分片文件按序号连续排列,直播结束后若开了自动转 mp4,程序会逐片转换,最终得到可分发的成片。

场景二:多房间批量录制

目标:6 个主播同时值守,互不拖垮。 配置要点:config/URL_config.ini 写多行地址;同一时间访问网络的线程数 = 5(默认 3,程序内置降载逻辑,错误偏多时会自动降并发并恢复);排队读取网址时间(秒) = 20让各房间错峰启动检测;保存文件夹是否以作者区分 = 是保证输出按作者分目录;临时不录某个房间时给它加#即可,不用删行。 数据怎么用:downloads/平台名/作者名各自独立归档,复盘和交付按目录拆分即可。

场景三:直播互动数据复盘

先说实话:DouyinLiveRecorder 没有弹幕输出,做不了纯弹幕文本的关键词统计。可行路径有两条。一是录视频并保留 SRT:SRT 提供精确时间骨架,你再把要统计的内容(比如口播、字幕组产物、或音频转写文本)对齐到时间轴上;二是把视频保存格式改成mp3音频或m4a音频,只录声音,事后用任意语音转写工具转成文字再做词频统计。 数据怎么用:SRT 的"第 N 行对应第 N 秒"特性让关键词命中可以秒级定位到画面,这是它相对"录屏截图复盘"的实际优势。

按场景调参

下表按"遇到什么情况就改哪个键"整理,参数名与 config/config.ini 完全一致。

遇到的情况改哪个参数怎么改
长时间挂机,担心请求过于频繁循环时间(秒)默认 120,可拉到 300 以上;程序还会加随机抖动,错误多时自动延长检测间隔
多房间带宽吃紧同一时间访问网络的线程数、排队读取网址时间(秒)线程数默认 3,房间多可上调到 5 左右;排队间隔默认 0,改成 20 让检测错峰
一场直播太长、单文件不好搬运分段录制是否开启、视频分段时间(秒)开启分段,分片默认 1800 秒,可按交付习惯调成 600 或 3600
磁盘告急录制空间剩余阈值(gb)、直播保存路径(不填则默认)阈值默认 1.0,即剩余低于 1 GB 停录退出;也可换到空间更大的目录
录 TikTok、Twitch 等海外平台是否使用代理ip(是/否)、代理地址、使用代理录制的平台(逗号分隔)开代理并填127.0.0.1:7890这类本机代理;平台列表默认已包含常见海外站
想要 mp4 交付物录制完成后自动转为mp4格式默认是,只改封装速度快;mp4格式重新编码为h264保持否可免转码

故障自查

  • 不开始录制,控制台反复"等待直播"或"获取失败":先确认链接属于支持的平台(未知行会被程序自动加#注释);再换一份新的 Cookie;海外平台确认代理可用;最后看logs/目录的运行日志。
  • 录到一半文件打不开、损坏:优先 ts 加分段保存;Docker 环境里不要手动强杀容器,中断时正在写的文件容易坏;mp4 非分段文件中断后也可能无法播放。
  • 空间不足,程序直接退出:改大录制空间剩余阈值(gb)、清理downloads/,或把直播保存路径(不填则默认)指到更大的磁盘。
  • 海外平台提示网络异常:程序启动时会探测全局代理,探测不到会打印黄色提示;在代理地址填本机代理,并确认使用代理录制的平台(逗号分隔)列表覆盖该站点。
  • 改完配置不生效或启动报配置错误:config.ini 以带 BOM 的 UTF-8 读写,编辑器保存时注意编码;键名照抄模板,不要自造键;项目运行中会自动把配置快照存到backup_config/,可对照找回原值。

下一步去哪

  • README.md:各平台直播间地址格式样例、Docker 运行方式、完整提交日志;
  • douyinliverecorder/spider.py:各平台房间数据抓取;
  • douyinliverecorder/stream.py:流地址解析与画质选择;
  • ffmpeg_install.py:FFmpeg 检测与自动安装逻辑;
  • 扩展方向:config.ini里是否录制完成后执行自定义脚本可接上你自己的入库、切片或分发流程。

【免费下载链接】DouyinLiveRecorder可循环值守和多人录制的直播录制软件,支持抖音、TikTok、Youtube、快手、虎牙、斗鱼、B站、小红书、pandatv、sooplive、flextv、popkontv、twitcasting、winktv、百度、微博、酷狗、17Live、Twitch、Acfun、CHZZK、shopee等40+平台直播录制项目地址: https://gitcode.com/gh_mirrors/do/DouyinLiveRecorder

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询