nikaidouasahi / ddrecorder

📺Headless全自动B站直播录播、切片、上传一体工具

2021年10月8日起，B站更改了直播弹幕的压缩方式，目前本应用已完成适配，感谢各位的支持。

DDRecorder

Headless全自动B站直播录播、切片、上传一体工具 >=1.1.2版本增加了自动检查更新功能，需要连接至Github服务器，敬请留意。

感谢

FortuneDayssss/BilibiliUploader MoyuScript/bilibili-api ForgQi/biliup-rs

安装指南（Windows）

1. 在Release下载zip包解压。
2. 修改配置文件config.json
3. 双击运行DDRecorder.exe （这将使用config.json）或 DDRecorder.exe <配置文件>

安装指南（MacOS/Linux）

1. 安装Python >= 3.7 https://www.python.org/downloads/release/python-386/
2. 安装ffmpeg https://ffmpeg.org/download.html
3. 执行pip install -r requirements.txt
4. 修改config文件夹下的配置文件config.json
5. 执行python main.py <配置文件>

配置文件字段解释

关于登录

登录部分采用的凭证优先级如下：

1. 配置文件中提供的access_token和refresh_token
2. 上一次使用账号密码成功登录所取得的access_token和refresh_token
3. 账号和密码

由于B站风控原因，账号密码登录失败（被风控）的可能性极高，建议获取access_token和refresh_token填入配置文件中；目前推荐使用biliup-rs进行一次登录获取access_token和refresh_token后填入配置文件中。

关于占位符

目前可以在配置文件里使用的占位符如下：

• {date} ：日期（格式为“2022年02月02日”）
• {room_name} ：最近的直播间标题
• {year},{month},{day},{hour},{minute},{second}：直播开始时间的年、月、日、时、分、秒
• {rough_time}：直播开始时间的大概描述（凌晨、上午、下午、晚上）

关于手动切片

手动切片功能类似于Nvidia的ShadowPlay功能，在配置文件中的"manual_clipper"部分可以找到手动切片器相关设置。

在启用相关功能并指定接受指令的用户UID，该用户可以在直播时发送特定弹幕来控制DDRecorder进行切片。

特定弹幕格式为/DDR clip <回溯时间（秒）> [描述文本]。其中描述文本可选，如果不指定描述文本，将会自动设置一个“手动切片_{编号}”的表述文本。

比如说，如果想要截取当前时间向前5分钟的内容，只需要发送/DDR clip 300。

如果想要指定描述文本为“主播锐评ylg”，发送/DDR clip 60 主播锐评ylg即可。

手动切片的将会输出到与自动切片相同的文件夹，因此受到uploader-clippers中的设置项控制。即如果打开了自动上传切片功能，手动切片同样也会上传，不过分P名将不再是自动采集的弹幕关键词，而是上面所述的描述文本。

全局设置（root部分）

• check_interval: 直播间开播状态检查间隔，单位为秒，每个监控直播间单独计数，因此如果监控直播间较多，建议适当调大。由于B站API访问次数限制，建议不要小于30。默认：100
• print_interval：控制台消息打印间隔，单位为秒。
• data_path: 数据文件路径。默认："./"（即程序所在路径）
• logger: 日志相关设置
  • log_path: 日志文件路径。默认："./log"
  • log_level: 日志级别，可选DEBUG\INFO\WARN
• request_header: 请求时使用的头。代码中已经包含了一个默认的，在这里进行调整将会覆盖默认值，如无必要请留空。
• uploader: 上传器相关设置
  • upload_by_edit：通过编辑稿件的方法上传多P切片，可以让后续分P上传时让前面的分P进入审核队列，加快开放浏览的速度。请注意打开此功能时，请保持keep_record_after_upload和keep_clippers_after_upload为False。否则，keep_record_after_upload和keep_clippers_after_upload设置项将无效。
  • thread_pool_workers: 上传时的线程池大小。默认：1
  • max_retry: 最大重试次数。默认：10
• enable_baiduyun：是否开启百度云功能。

直播间特定设置（spec部分，此部分是一个数组，如果需要同时监控多个直播间，依次添加至数组中即可）

• room_id: 房间号
• recorder: 录制器相关设置
  • keep_raw_record: 是否保留原始录像（flv）文件（录制器最后会合并所有flv文件导出mp4）。默认：true
• parser: 弹幕分析器相关设置
  • interval: 弹幕计数间隔，单位秒。默认：30.
  • up_ratio: 开始切片位置弹幕数量与上一个时段弹幕数量之比的阈值。默认：2.5
  • down_ratio: 结束切片位置弹幕数量与上一个时段弹幕数量之比的阈值。默认：0.75
  • topK: 提取弹幕关键词的数量。默认：5
• clipper: 切片器相关设置
  • enable_clipper: 启用切片功能。默认：true
  • min_length: 切片最短长度，单位秒。默认：60
  • start_offset: 切片开始时间偏移量，正为向后偏移，负为向前偏移，单位秒。默认：0。建议根据直播间弹幕延迟调整。
  • end_offset: 切片结束时间偏移量，正为向后偏移，负为向前偏移，单位秒。默认：0。建议根据直播间弹幕延迟调整。
• manual_clipper: 手动切片器相关设置
  • enabled：启用手动切片器功能。默认：false
  • uid：手动切片器接受指令的用户UID。
• uploader: 上传器相关设置
  • account: 上传账户信息
    • username: 用户名
    • password: 密码
    • access_token: Access token
    • refresh_token: Refresh token
  • copyright: 稿件类型（1：自制，2：转载）警告！未经授权投稿“自制”可能导致稿件无法通过审核！
  • record: 录播上传设置
    • upload_record: 是否上传录播。默认：true
    • keep_record_after_upload: 是否在上传过审后保留录播。默认：true
    • split_interval: 录播划分间隔，单位秒。由于B站无法一次上传大文件，因此长录播需要分片才能上传。默认：3600。如设为0，表示不划分，如此请保证账号具有上传超大文件权限。
    • title：上传视频的标题，可以使用占位符。
    • tid：分区编号，可在 https://github.com/FortuneDayssss/BilibiliUploader/wiki/Bilibili%E5%88%86%E5%8C%BA%E5%88%97%E8%A1%A8 查询
    • tags：上传视频的标签
    • desc：上传视频的描述，可以使用占位符。
    • cover：上传视频使用的封面文件路径。
  • clippers: 切片上传设置
    • upload_clippers: 是否上传切片。默认：true
    • keep_clippers_after_upload: 是否在上传过审后保留切片。默认：true
    • title：上传视频的标题，可以使用占位符。
    • tid：分区编号，可在 https://github.com/FortuneDayssss/BilibiliUploader/wiki/Bilibili%E5%88%86%E5%8C%BA%E5%88%97%E8%A1%A8 查询
    • tags：上传视频的标签
    • desc：上传视频的描述，可以使用占位符。
    • cover：上传视频使用的封面文件路径。
• backup：是否将录像备份到百度云。

已知问题

• merged文件下下文件不会在备份到百度云后自动删除。（已解决，请更新bypy）
• record文件夹下产生大量空文件夹。（试图修复，通过在检测到断流后立刻检查开播状态实现。）
• 录播分P顺序问题。（已修复）
• 通过编辑稿件的方法上传多P稿件功能与自动在过审后清理文件功能存在冲突。（已修复）
• 被B站风控系统412后会无法工作。（预期下个功能更新优化。）
• 自动上传无法登录。（暂时解决，请更新BilibiliUploader）

预期更新

• 弹幕jsonl转为ass字幕并自动压入录播文件的功能。（预期下个功能更新。）
• 不上传百度也会在切片和或录播上传完成后删去merge文件的功能。（预期下个功能更新。说实话不是很想加这个功能，可能这就是仓鼠症患者吧……）
• 根据网络状况自动选择弹幕服务器。（已更新。）
• 增加直播间名称作为投稿标题和简介中模板填充字段。（已更新，可以使用{room_name}。）
• 增加斗鱼、Twitch和油管支持。（预期当前功能稳定后加入。）