项目背景
在现代社交媒体和直播平台的兴起下,越来越多的人开始在网络上分享自己的生活和技能。其中,Bilibili(哔哩哔哩)是一个备受欢迎的视频分享平台,特别是在中国。很多人喜欢通过Bilibili观看直播内容,但有时候直播结束后,这些内容可能会消失,无法再次观看。为了解决这个问题,一个名为"Biliup"的项目应运而生。
项目链接:biliup/biliup
Biliup是一个开源项目,旨在帮助用户自动录制各大主流直播平台的实时直播流,并将录制内容自动上传到Bilibili视频网站。它不仅支持录制直播内容,还可以处理直播弹幕,并生成Bilibili标准格式的XML弹幕文件,以供后续使用。此外,Biliup还提供了一些实验性功能,如防止录制花屏和一个基于Web的用户界面。
项目特点
Biliup项目具有以下主要特点:
1. 多平台支持
Biliup支持自动录制各大主流直播平台的实时直播流,包括但不限于AcFun、afreecaTV、哔哩哔哩、斗鱼、抖音、虎牙、网易CC、NICO、猫耳FM、Twitch、YY直播等。这意味着你可以录制并保存来自不同平台的直播内容。
2. 自动上传到Bilibili
Biliup不仅录制直播内容,还在录制结束后自动将内容上传到Bilibili视频网站。这确保了你可以在Bilibili上找到你喜欢的直播内容,而不会错过任何精彩时刻。
3. 支持YouTube和Twitch回放列表
Biliup支持自动搬运YouTube和Twitch的直播回放列表到Bilibili。这意味着你可以将这些平台上的内容传输到Bilibili,以拓宽你的目标受众。
4. 处理直播弹幕
Biliup可以录制哔哩哔哩、斗鱼、虎牙、Twitch平台的直播弹幕,并生成Bilibili标准格式的XML弹幕文件。这使得这些弹幕可以被常见的各种弹幕挂载程序使用和处理。
5. 自动选择上传线路
Biliup会自动选择上传线路,以确保国内外VPS的上传质量和速度。这有助于提高上传的效率和可靠性。
6. 控制下载和上传并发量
你可以分别控制下载和上传的并发量,以根据你的需求优化性能。
安装和使用
如果你想使用Biliup来录制和上传直播内容,以下是详细的安装和使用指南:
-
安装Python和pip: 首先确保你的计算机上安装了Python 3.7+和pip,这是运行Biliup所需的基本环境。
-
创建配置文件: 创建一个配置文件,通常命名为
config.toml
,用于配置你希望录制的直播内容和其他设置。示例配置文件可以在项目文档中找到。 -
安装Biliup: 使用pip安装Biliup,运行以下命令:
pip3 install biliup
-
开始使用Biliup: 使用以下命令启动Biliup:
biliup start
-
更多选项和命令: 你可以使用
biliup -h
命令查看更多选项和命令,以满足你的需求。
Docker使用
如果你更喜欢使用Docker容器来运行Biliup,以下是一些简要的指南:
从Docker Hub拉取镜像
-
拉取Biliup Docker镜像:
docker pull ghcr.io/biliup/caution:master
-
启动Biliup容器:
docker run -P --name biliup -v /host/path:/opt -d ghcr.io/biliup/caution:master
-
(可选)启动带有Web界面的Biliup容器:
docker run -P --name biliup -v /host/path:/opt -p 19159:19159 -d --restart always ghcr.io/biliup/caution:latest --http --password yourpassword
手动构建Docker镜像
如果你想手动构建Biliup Docker镜像,可以按照以下步骤:
-
克隆Biliup项目:
git clone https://github.com/ForgQi/bilibiliupload.git
-
进入Biliup项目目录:
cd bilibiliupload
-
构建Docker镜像:
sudo docker build . -t bili
up
4. 启动Docker容器:
```bash
sudo docker run -P -d biliup
进入Docker容器
如果需要进入Biliup Docker容器,可以使用以下命令:
-
查看容器列表并找到你要进入的容器的imageId:
sudo docker ps
-
进入容器:
sudo docker exec -it imageId /bin/bash
从源码运行Biliup
如果你想从源码运行Biliup,可以按照以下步骤:
-
下载Biliup源码:
git clone https://github.com/ForgQi/bilibiliupload.git
-
安装Biliup依赖:
pip3 install -e .
-
启动Biliup:
python3 -m biliup
配置文件示例
Biliup的配置文件采用YAML或TOML格式,以下是一个示例配置,用于指定要录制的直播内容:
streamers:
xxx直播录像:
url:
- https://www.twitch.tv/xxx
tags: biliup
使用建议
以下是一些使用Biliup的建议:
1. 选择上传线路
如果你使用国内VPS,网络费用较高,建议使用国外VPS。根据机器的硬盘等资源设置合理的并发量,选择kodo线路,以确保上传的质量和速度。
2. 登录方案
Biliup提供了两种登录方案,一种是使用浏览器模拟登录,另一种是通过B站的OAuth2接口登录。对于滑动验证码,可以采用二值化、灰度处理找缺口计算移动像素等方式来模拟人操作轨迹。
3. 推荐Biliup配置
建议限制线程池的并发数,以减少磁盘占用的可能性。此外,检测到下载情况卡死或下载超时时,Biliup会自动重试三次以保证可用性。
4. 使用XML弹幕文件
Biliup可以生成Bilibili标准格式的XML弹幕文件。你可以使用相关工具将XML弹幕文件转化为ASS字幕文件,然后在播放器中加载字幕。另外,一些播放器也可以直接挂载XML弹幕文件观看。
项目贡献者和感谢
Biliup项目依赖于一些其他开源项目和工具,特别感谢以下贡献者:
- ykdl、youtube-dl、streamlink 提供了下载器功能。
- THMonster/danmaku
结语
Biliup是一个强大的工具,可以帮助用户自动录制和上传直播内容到Bilibili,以便观众们能够回顾精彩时刻。如果你是一个直播内容创作者或者Bilibili的忠实粉丝,Biliup绝对值得一试。希望这篇文章对你了解和使用Biliup有所帮助。
把readme抄一遍是吧[汗]
readme比我写的好多了
难道是作者本人?