https://github.com/AsaChiri/DDRecorder

📺Headless全自动B站直播录播、切片、上传一体工具
https://github.com/AsaChiri/DDRecorder

bilibili bilibili-live ffmpeg python vtuber

Last synced: about 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/AsaChiri/DDRecorder
• Owner: AsaChiri
• License: apache-2.0
• Created: 2021-01-01T10:30:05.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-08-23T16:19:51.000Z (over 1 year ago)
• Last Synced: 2024-08-01T02:28:04.170Z (4 months ago)
• Topics: bilibili, bilibili-live, ffmpeg, python, vtuber
• Language: Python
• Homepage:
• Size: 184 KB
• Stars: 435
• Watchers: 8
• Forks: 72
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-bilibili-extra - DDRecorder - Headless 全自动 B 站直播录播、切片、上传一体工具.   (直播相关工具 / 直播脚本)

README

        
# DDRecorder

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

 

**>=1.1.2 版本增加了自动检查更新功能，需要连接至 Github 服务器，敬请留意。**

## 感谢

FortuneDayssss/BilibiliUploader

MoyuScript/bilibili-api

ForgQi/biliup-rs

fastnlp/fastHan

## 参考文献

```

@inproceedings{geng-etal-2021-fasthan,

  author = {Geng, Zhichao and Yan, Hang and Qiu, Xipeng and Huang, Xuanjing},

  title = {fastHan: A BERT-based Multi-Task Toolkit for Chinese NLP},

  booktitle = {Proceedings of the 59th Annual Meeting of the Association for Computational Linguistics and the 11th International Joint Conference on Natural Language Processing: System Demonstrations},

  year = {2021},

  pages = {99--106}, 

  url = {https://aclanthology.org/2021.acl-demo.12}

}

```

## 安装指南（Windows）

1. 在 Release 下载 zip 包解压。

2. 修改配置文件 config.json 可以选择使用自带的 DDRecorderConfigManager（源码：AsaChiri/DDRecorderConfigManager)

3. 双击运行 DDRecorder.exe（这将使用 config.json）或 DDRecorder.exe <配置文件> 

## 安装指南（MacOS/Linux）

1. 安装 Python >= **3.9** https://www.python.org/downloads/release/python-3104/

2. 安装 ffmpeg https://ffmpeg.org/download.html

3. 执行 pip install -r requirements.txt

4. 修改 config 文件夹下的配置文件 config.json

5. 执行 python main.py <配置文件> 

   

## 配置文件字段解释

### 关于登录

**由于 B 站风控原因，账号密码登录失败（被风控）的可能性极高，建议获取 access_token，refresh_token 和 cookies 项目填入配置文件中；目前推荐使用 [biliup-rs](https://github.com/ForgQi/biliup-rs) 进行一次登录获取 access_token，refresh_token 和 cookies 项目后填入配置文件中。如果您使用 DDRecorderConfigManager，则相应功能已经集成。**

### 关于占位符

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

- {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: 上传器相关设置

  

  - lines: 上传使用的线路，可以选择 bda2, kodo, ws, qn, cos, cos-internal(支持腾讯云内网免流 + 提速)

- 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。

  - command: 自定义手动切片触发指令。

- uploader: 上传器相关设置

  - account: 上传账户信息

    - username: 用户名

    - password: 密码

    - access_token: Access token 

    - refresh_token: Refresh token

    - cookies:

      - SESSDATA: your SESSDATA

      - bili_jct: your bili_jct

      - DedeUserID: your DedeUserID

      - DedeUserID__ckMd5: your DedeUserID__ckMd5

      - sid: your sid

  - 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：是否将录像备份到百度云。

## 已知问题

- record 文件夹下产生大量空文件夹。（Work-around patch）

- 自动上传无法登录，电磁力不足无法投稿分 P 稿件。（已更新）

- 被 B 站风控系统 412 后会无法工作。（预期下个功能更新优化。）

- PK 导致分辨率不正确出现花屏。（正在调查。）

## 预期更新

- 弹幕 jsonl 转为 ass 字幕并自动压入录播文件的功能。（预期下个功能更新。）

- 不上传百度也会在切片和或录播上传完成后删去 merge 文件的功能。（_预期下个功能更新。说实话不是很想加这个功能，可能这就是仓鼠症患者吧……_）

- 增加斗鱼、Twitch 和油管支持。（预期当前功能稳定后加入。）