biliLive-tools

这是一个用于 B 站录播的一站式工具，支持弹幕转换与视频压制并上传至B站，支持录播姬与blrec的webhook。
如果你是录播man正在寻找xml弹幕转换、弹幕压制、webhook上传工具，如果你是切片man正在寻找下载b站视频工具，如果你厌倦了b站的多p上传，你可以来试试本软件。
做这款工具的初衷是为了解决录播工具的碎片化，往往想完整处理一场带有弹幕的录播要使用多个软件的配合，一些工具只有CLI，加大了使用难度。
你可以在B站查看使用教程

如果你使用了本软件，希望你在简介标注仓库地址或保留默认tag，本软件不存在任何数据追踪，我想大致知道使用使用人群及情况

更新历史

1. 支持录播姬与blrec的webhook自动化处理
2. 支持 Danmufactory GUI 弹幕xml转换
3. 支持根据弹幕切片
4. 支持b站分P投稿
5. 支持视频与弹幕压制
6. 支持 ffmpeg 转码及转封装
7. 支持B站视频下载
8. 支持斗鱼录播及其弹幕下载

下载

不提供 MacOS 安装包，需要的可以自行编译，编译时需要替换用到的二进制文件。
由于我不在Linux开发，测试覆盖不光，如果存在问题可以提issue。
CLI的使用参考文档

下载地址：https://github.com/renmu123/biliLive-tools/releases
备用：https://www.alipan.com/s/iRyhxjdqGeL

功能介绍

断播续传

这个功能主要用于解决：由于网络或者设置分段原因导致录播片段被切割成多个。
开启后，会将主播的一场直播上传到同一个视频中
一场直播的定义：同一个主播，本次文件创建时间与上一个文件结束写入时间如果相差n分钟（使用配置），那么会被定义为一场直播，不会使用webhook中比如录播姬的session定义。
开启录制后，或反复切换开关，可能会有奇怪的错误。
如果出现bug，将设置中的日志等级调整为debug后复现然后进行反馈。

xml弹幕转换

xml弹幕转换底层使用DanmakuFactory，B站弹幕确认可以使用，其余类型请自行测试。
部分功能如自适应分辨率

切片功能

用于局部渲染带有弹幕的视频，支持lossless-cut项目导入

支持哪些快捷键

• ctrl+s 保存到llc项目
• ctrl+shift+s 另存为llc项目
• ctrl+enter 导出
• ctrl+z 撤销
• ctrl+shift+z 重做
• I 在当前时间开始当前片段
• O 在当前时间结束当前片段
• up 上一个片段
• down 下一个片段
• del 删除片段
• space 播放/暂停
• ctrl+left 后退1秒
• ctrl+right 前进1秒
• ctrl+k 切换视图

通知

使用通知功能时，请妥善保存所有信息，请勿分享给他人，本软件不会发送任何信息到任何服务器

邮箱

使用smtp服务来发送邮件，每个邮件服务商的参数各不相同，使用请自行参照各服务商的教程。

server酱

serer酱支持免费推送信息到手机微信，免费账户有限制。

官网：https://sct.ftqq.com/

tg bot

使用tg bot发送信息时默认使用系统代理。

tg bot 的搭建请自行寻找教程

ntfy

官网：https://docs.ntfy.sh/

自定义Webhook

如果想接入webhook相关功能，你可以自行构造参数并调用接口，采用post方法，端口为/webhook/custom，接收后立刻返回http code=200。

参数： event: FileClosed|FileOpening (如果你想使用断播续传功能，请在上一个FileClosed事件后在设置的时间间隔内发送FileOpening事件)
filePath: 视频文件的绝对路径 coverPath: 视频封面的绝对路径，如果为空，会读取与视频文件名相同的后缀为jpg的文件，支持为空
danmuPath: 视频弹幕xml文件，如果为空，会读取与视频文件名相同的xml文件，支持为空
roomId: 数字类型，房间号，用于断播续传
time: 用于标题格式化的时间，示例："2021-05-14T17:52:54.946"
title: 标题，用于格式化视频标题
username：主播名称，用于格式化视频标题

以下参数用于弹幕分析功能，非必要 有些弹幕中存在元数据(参考blrec)的会被自动解析，比如弹幕姬或blrec或douyu-cli(0.6.1及以上)生成的弹幕 platform：平台，如果是b站推荐为bilibili，斗鱼推荐为douyu，其实填啥都可以
live_start_time：直播开始时间，示例："2021-05-14T17:52:54.946" live_title：直播标题

示例：

curl --location 'http://127.0.0.1:18010/webhook/custom' \
--header 'Content-Type: application/json' \
--data '{
    "event":"FileClosed",
    "filePath":"D:\\aa.mp4",
    "coverPath":"D:\\aa.jpg",
    "danmuPath":"D:\\aa.xml",
    "roomId":93589,
    "time":"2021-05-14T17:52:54.946",
    "title":"我是猪",
    "username":"djw"
}'

CLI的使用

你可以使用二进制文件或者使用npm i bililive-cli -g进行安装。

具体文档参考页面

赞赏

如果本项目对你有帮助，请我喝瓶快乐水吧，有助于项目更好维护。
爱发电：https://afdian.com/a/renmu123
你也可以给我的 B 站帐号 充电

常见问题

Webhook标题模板引擎如何使用

1.5.0起 Webhook 标题支持ejs模板引擎，具体语法参考文档，如果标题超过80字，会被自动截断，会优先执行模板引擎，之后会对{{}}占位符进行替换，如果有语法错误，会被跳过，优先保证上传。

// 以下为支持注入的参数
{
  title: string; // 直播间标题
  user: string; // 主播名称
  time: Date; // 直播开始时间
  roomId: number | string; // 房间号
}

示例：<%= user %>-<%= time.getFullYear() %><%= String(time.getMonth() + 1).padStart(2, "0") %>直播录像 渲染结果：djw-202408直播录像

压制预设如何设置

我也不知道
如果你是一个小白，先根据自己的硬件选择对应的编码，推荐使用crf或cq等质量模式的默认参数，压制后查看视频大小，压制时间，画质，接下来调整参数，以满足你的需求，没有最好的参数，只有最合适的参数，不同视频，不同场景可能合适的参数都不一致。
进阶请自行搜索ffmpeg相关的教程

nvnec或其他硬件转码无法正常使用

请尝试更新显卡驱动，如果更新到最新后还无法使用，请尝试手动更换ffmpeg可执行文件为6.0，或使用1.0.0以下版本

blrec的webhook事件如何设置

依赖于“视频文件创建”,“视频文件完成”两个webhhook，建议直接勾选全部事件。

blrec开启转换为mp4后无法使用

请关闭该功能，使用本软件的“转封装为mp4”功能

有时上传和下载任务点击暂停无效

上传任务分为三个阶段，只有第二个阶段是支持暂停的：

1. 获取上传基础信息
2. 文件切片上传
3. 文件合并，调用提交接口

下载任务分为三个阶段，只有第二个阶段是支持暂停的：

1. 获取下载文件基础信息
2. 文件切片下载
3. 文件合并

投稿后自动评论未生效

该功能会每隔十分钟会查询一次投稿中心的前20个稿件，如果为本软件投稿且开启了自动评论的已审核非续传稿件，会进行自动评论，如果一个稿件24小时内状态不为审核通过，那么这个稿件将被移出队列。
如果你的稿件不为以上情况却未进行投稿，请提issue

怎么评估压制的速度

进入队列，查看任务最后一栏的速率，可以根据速率调整压制参数

如何查看原始ffmpeg命令输出

压制之后查看log

最大任务数

1. 目前支持ffmepg任务和斗鱼视频下载最大任务数，可以在“设置-任务-ffmpeg最大任务数”中进行设置，默认为不限制
2. 手动暂停的任务不会被自动启动
3. 高能进度条任务会自动进行，因为速度会很快

使用zip包后安装包无法使用

zip包并非传统意义上的绿色包，数据和安装包文件的不会存放在同一个文件夹中，如果你尝试使用安装包后使用压缩包，可能会导致二进制文件的路径错误从而无法使用，请尝试在设置中手动修改二进制文件路径。

如果你想将数据放在同一个文件夹内，请在可执行文件所在文件夹创建一个portable文件，无拓展名如.txt，更改后重启应用，如有需要可以新建文件前在设置中备份设置。

更改webhook部分配置不生效

请不要在直播开始后修改相应的配置，比如标题，断播续传等配置，本场直播可能并不会生效

TODO

• 支持使用ffmpeg压制弹幕至视频文件
• 工具页面
  • 支持ffmpeg不同cpu，gpu以及相关配置
  • 支持使用danmufactory自动处理xml文件并进行压制
  • 工具页面，danmufactory的GUI
  • 工具页面，flv的转封装
  • 支持视频合并
  • 下载页面
  • 支持切片
• log记录及其展示
• 配置持久化，压制高能进度条
• B站上传支持
  • 移除biliup二进制文件依赖
  • 支持分p
  • 多账户支持
• webhook支持
  • 录播姬webhook支持
  • blrec webhook支持
  • 支持自动上传
  • 支持弹幕压制
  • 断播续传
• 支持自定义ffmpeg以及ffprobe
• 斗鱼录播
• 弹幕分析

开发

交流群：872011161

node请使用20及以上版本。

Install

$ pnpm install
$ pnpm run install:bin

better-sqlite3

弹幕分析功能依赖于better-sqlite3，如果你无法编译安装，尝试安装visual-studio2022中的c++相关工具，以及python3(也许)。 如果你是Win，你还可能遇到报错比如cause=fork/exec %1 is not a valid Win32 application.，根据提示修改pnpm源文件，如果应用无法启动，尝试使用electron-rebuild。 如果你最后还是无法安装，尝试在项目根目录运行node scripts\github-ci-better-sqlite3.js手动安装依赖。

其他依赖

如果二进制依赖安装失败或者不支持你的平台，请尝试手动下载安装二进制依赖。

新建packages\app\resources\bin文件夹，里面需要三个个文件。 同时需要在应用的设置里设置相关可执行文件地址。

1. DanmukuFactory.exe 自编译版本
2. ffmpeg.exe n7.0
3. ffprobe.exe n7.0

Development

pnpm run dev

Build

# APP应用
$ pnpm run build:app
# APP应用且没有ffmpeg二进制文件
$ pnpm run build:app:no-ffmpeg
# CLI应用
$ pnpm run build:cli

License

GPLv3