Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/renmu123/biliLive-tools
B 站录播一站式工具，支持录播姬&blrec的webhook自动上传
https://github.com/renmu123/biliLive-tools
Last synced: about 2 months ago
JSON representation
B 站录播一站式工具，支持录播姬&blrec的webhook自动上传
- Host: GitHub
- URL: https://github.com/renmu123/biliLive-tools
- Owner: renmu123
- License: gpl-3.0
- Created: 2023-08-30T09:09:44.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-04-21T11:13:24.000Z (8 months ago)
- Last Synced: 2024-04-22T11:59:07.133Z (8 months ago)
- Language: TypeScript
- Homepage:
- Size: 1.77 MB
- Stars: 21
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-bilibili-extra - BiliLive-tools - B 站录播一站式工具，支持录播姬 webhook 自动上传.  (直播相关工具 / 直播脚本)
README
# biliLive-tools
这是一个用于 B 站录播的一站式工具，支持弹幕转换与视频压制并上传至B站，支持录播姬与blrec的webhook。
如果你是录播man正在寻找xml弹幕转换、弹幕压制、webhook上传工具，如果你是切片man正在寻找下载b站视频工具，如果你厌倦了b站的多p上传，你可以来试试本软件。
做这款工具的初衷是为了解决录播工具的碎片化，往往想完整处理一场带有弹幕的录播要使用多个软件的配合，一些工具只有CLI，加大了使用难度。
你可以在B站查看[使用教程](https://www.bilibili.com/video/BV1Hs421M755/)
**如果你使用了本软件，希望你在简介标注仓库地址或保留默认tag，本软件不存在任何数据追踪，我想大致知道使用使用人群及情况**
[更新历史](https://github.com/renmu123/biliLive-tools/blob/master/CHANGELOG.md)
1. 支持 Danmufactory GUI
2. 支持 ffmpeg 转封装
3. 支持视频与弹幕压制
4. 支持b站分P投稿
5. 支持录播姬与blrec的webhook
6. 支持B站视频下载
# 下载
目前有两个 Win 版本的包。两个包除了是否打包 `ffmpeg` 和 `ffprobe` 之外没有任何代码上的区别，如果你有自己编译的ffmpeg或者不需要用到相应的ffmpeg功能。
如果你是普通用户，那就选择体积大的那个包，如果你是资深用户，那么请自行选择，因使用自定义 `ffmpeg` 出问题的 issue 是不会被处理的。
不提供 MacOS 安装包，需要的可以自行编译，编译时需要替换用到的二进制文件。
Linux包如果有问题可以提issue，由于我不在Linux开发，可能问题会比较多。
下载地址：https://github.com/renmu123/biliLive-tools/releases
备用：https://www.alipan.com/s/iRyhxjdqGeL
# 功能介绍
## 断播续传
这个功能主要用于解决：由于网络或者设置分段原因导致录播片段被切割成多个。
开启后，会将主播的一场直播上传到同一个视频中
一场直播的定义：同一个主播，本次文件创建时间与上一个文件结束写入时间如果相差n分钟（使用配置），那么会被定义为一场直播，不会使用webhook中比如录播姬的session定义。
开启录制后，或反复切换开关，可能会有奇怪的错误。
如果出现bug，将设置中的日志等级调整为`debug`后复现然后进行反馈。
## xml弹幕转换
xml弹幕转换底层使用[DanmakuFactory](https://github.com/hihkm/DanmakuFactory)，B站弹幕确认可以使用，其余类型请自行测试。
部分功能如自适应分辨率
## 切片功能
用于局部渲染带有弹幕的视频，支持[lossless-cut](https://github.com/mifi/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秒
## 通知
**使用通知功能时，请妥善保存所有信息，请勿分享给他人，本软件不会发送任何信息到任何服务器**
### 邮箱
使用smtp服务来发送邮件，每个邮件服务商的参数各不相同，使用请自行参照各服务商的教程。
### server酱
serer酱支持免费推送信息到手机微信，免费账户有限制。
官网：https://sct.ftqq.com/
### tg bot
使用tg bot发送信息时默认使用系统代理。
tg bot 的搭建请自行寻找教程
### ntfy
官网：https://docs.ntfy.sh/
如果官方服务无法使用可以尝试使用公益服（由我搭建），稳定性无法保证
公益服：http://139.196.77.29:9999
## 自定义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`：主播名称，用于格式化视频标题
示例：
```bash
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://github.com/renmu123/biliLive-tools/tree/master/packages/CLI)页面
# 赞赏
如果本项目对你有帮助，请我喝瓶快乐水吧，有助于项目更好维护。
爱发电：[https://afdian.net/a/renmu123](https://afdian.net/a/renmu123)
你也可以给我的 B 站帐号 [充电](https://space.bilibili.com/10995238)
# 常见问题
## 压制预设如何设置
~~我也不知道~~
如果你是一个小白，先根据自己的硬件选择对应的编码，推荐使用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. 当任务暂停时，不会有任务被自动启动，也就是说只有当任务完成或者失败时才会自动启用下一个未开始的任务
4. 高能进度条任务会自动进行，因为速度会很快
## 使用zip包后安装包无法使用
zip包并非传统意义上的绿色包，数据和安装包文件的会存放在同一个文件夹中，如果你尝试使用安装包后使用压缩包，可能会导致二进制文件的路径错误从而无法使用，请尝试在设置中手动修改二进制文件路径
## 更改webhook部分配置不生效
请不要在直播开始后修改相应的配置，比如标题，断播续传等配置，本场直播可能并不会生效
# TODO
- [x] 支持使用ffmpeg压制弹幕至视频文件
- [ ] 工具页面
- [x] 支持ffmpeg不同cpu，gpu以及相关配置
- [x] 支持使用danmufactory自动处理xml文件并进行压制
- [x] 工具页面，danmufactory的GUI
- [x] 工具页面，flv的转封装
- [x] 支持视频合并
- [x] 下载页面
- [ ] 支持局部渲染
- [x] log记录及其展示
- [x] 配置持久化，压制高能进度条
- [x] B站上传支持
- [x] 移除biliup二进制文件依赖
- [x] 支持分p
- [x] 多账户支持
- [ ] webhook支持
- [x] 录播姬webhook支持
- [x] blrec webhook支持
- [x] 支持自动上传
- [x] 支持弹幕压制
- [x] 断播续传
- [x] 支持自定义ffmpeg以及ffprobe
# 开发
交流群：872011161
node请使用20及以上版本。
## Install
```bash
$ pnpm install
$ pnpm run install:bin
```
如果二进制依赖安装失败或者不支持你的平台，请尝试[手动下载安装](https://github.com/renmu123/biliLive-tools/releases/tag/0.2.1)二进制依赖。
新建`packages\app\resources\bin`文件夹，里面需要三个个文件。
同时需要在应用的设置里设置相关可执行文件地址。
1. `DanmukuFactory.exe` [自编译版本](https://github.com/renmu123/DanmakuFactory/tree/test)
2. `ffmpeg.exe` [n7.0](https://github.com/BtbN/FFmpeg-Builds/releases)
3. `ffprobe.exe` [n7.0](https://github.com/BtbN/FFmpeg-Builds/releases)
## Development
分别运行各个子项目下的`dev`scripts
## Build
```bash
# APP应用
$ pnpm run build:app
# APP应用且没有ffmpeg二进制文件
$ pnpm run build:app:no-ffmpeg
# CLI应用
$ pnpm run build:cli
```
# License
GPLv3