由于个人原因没有时间继续维护本项目，目前本项目的“未知直播间地址时，也可以通过主播主页来监测直播”功能已失效，“自动转码”因会损坏视频而被移除(请用b站录播姬的录播修复功能对视频进行修复后再手动转码)，其他功能仍可正常使用，故在不出大问题前不作修改。

对于“未知直播间地址时，也可以通过主播主页来监测直播”功能，因旧接口被抖音移除，已花费大量时间尝试新接口但均以失败告终，因为没有时间所以没有继续尝试。

目前因为一些接口失效，命令行或log中会产生大量报错，但不影响基本功能(旧接口报错备用接口生效)，因此不用管。

补充：2024.6.20弹幕录制似乎已失效，测试发现是抖音更新了接口需要signature导致的

2024.6.22 稍微逆了一下发现有点费时间，由于没有空，参考另一个遇到相同问题并已修复的项目billup。懒人开箱即用版还没更新，请clone下来使用。

2024.6.25 增加了一个命令行下按L键查看正在录制的房间的功能(需在config中手动开启，仅Windows下有效)

目前问的较多的一些问题

如果有bug或有什么建议的话请发issues，建议贴上日志( logs 文件夹下遇到 bug 时对应的日志)。

软件仅供个人科研性质使用，禁止商业使用，禁止不正当使用，不接受定制，不接受捐助。

本人从未、将来也不会从本软件中获利。没有义务保证软件长期有效和及时更新，没有义务对所有遇到的问题都作解答，任何对软件的不正当修改和使用所造成的危害由使用者负责。已有非法修改该类软件并用于非法用途的人被相关机关逮捕，请大家引以为戒。

目前更新软件的方式是下载最新软件(建议重新安装依赖)，并把旧软件的 room.json 复制到新目录下，config.txt 可能要重新配置，因为新旧版本配置不兼容。

下载软件并解压，进入到解压后的目录，你能看到在这个目录下的 运行命令行版.bat 等文件，这个目录称为软件根目录。

首先安装 python 并将其添加到环境变量（可以在安装过程中勾选 Add Python x.x to PATH），如果是新手的话可以百度搜索 Python 安装，有手把手教程。

Windows平台可以按键盘上的 Win + R，并在文本框中输入cmd，回车，打开命令提示符，并在命令提示符中输入python --version，如果输出了python的版本，则表明安装成功。

如果是 Windows 10/11，执行命令python后可能什么都不输出，甚至会出现打开微软应用商店的迷惑行为，可以百度搜索python弹出微软应用商店。

如果使用 Linux 应该会安装 python吧。

使用方法见下方

pip install -r requirements.txt

在软件根目录下找到 config.txt，用文本编辑器打开它。里面对各选项都作了说明，可以根据自己的需求调整。

linux 服务器可以考虑使用 bypy 来上传录制到的文件，以便在自己的 PC 中转码和渲染弹幕。可以使用插件(下面说明)来实现自动上传。

可以在 GUI 界面中点击下方的 添加主播 来添加房间，支持 Web_Sid、直播间地址、直播间短链、主播主页。

使用纯命令行的用户，可以先在有 GUI 的平台下添加好房间，再把 room.json 复制到纯命令行平台下。或者：

在软件根目录下找到 room.json，用文本编辑器打开它，下面是几个例子：

id 是房间的 Web_Rid，即用网页版打开直播间(也可以自己在网页输入直播分享的短链，会跳转另一链接)，链接为 live.xxx.com/123456789?roomid=...

这个 123456789 就是 Web_Rid 。

name 可以填主播名，同时也是录制到的文件所存放的目录名，由于一些主播会经常改名，所以不自动获取名称，你可以自己填一个容易记的名字。

auto_record 是否自动监测和录制，一般是 true，如果不想录了又怕删掉它下次不方便加回来，可以改成 false。

record_danmu 为是否录制弹幕，对性能要求较高，根据实际需求和录制设备性能决定。

important 为 true 的情况下，该主播使用独立线程检测，以保证第一时间录到直播。不建议添加太多重要主播。

注：非重要主播全部在同一个线程中进行排队检测，因此主播数量越多，捕捉到开播越不及时。

双击 main.pyw 即可运行 GUI 版。

运行命令行版，Windows 平台直接打开 运行命令行版.bat 就可以了。

Windows 或 Linux 下，在软件根目录下执行指令 python3 main.pyw。

对于命令行版，当配置或房间修改时，需要重新启动软件才能生效。

下载的文件存放于 根目录/download 下。

需要下载 ffmpeg，可以放在软件根目录下或其他位置，在 config.txt 中配置 ffmpeg 所在目录，并配置自动转码选项。

在 src/plugin/plugin.py 中编写你的插件，比如当直播开始时向一个 api POST 一个信息以便通知你开播了：

下载到的文件是flv格式，由于时间戳错误等，许多软件播放有异常，可以使用 PotPlayer 播放，但仍存在拖拽进度条卡顿等问题，你可以尝试转码：

下载 ffmpeg 并将其添加到环境变量中(网上有教程)，假设录到的文件名是 20230114_123456.flv，执行指令：

可以进行无损转码，且速度非常快，还能修复部分由于时间戳错误造成的问题。

建议使用 b站录播姬 的录播修复工具进行修复，ffmpeg容易修坏。不过不能保证 100% 的修复成功率，建议保留录制到的原始文件以便以后修复。

如果不嫌转码麻烦费时的话，可以只保留原始 flv 格式，要用的时候才转为 mp4 格式，以免日后发现转码后的视频有问题时，原flv文件已经删了。

下载的弹幕是类 b站xml 格式的，可以使用 nicovert 来转为 ass 格式字幕文件，播放时拖入 PotPlayer 就能显示弹幕了。

如果要将弹幕渲染到视频中，可以使用命令：

但是这样如果原视频模糊或帧数低的话，弹幕也会模糊或一卡一卡的，你可以先生成一个高质量中间文件，再渲染弹幕：

软件主要以科研为目的，禁止用于任何形式的直接或间接的商业用途，包括但不限于付费帮录制、付费定制改版软件、付费分发本软件或本软件的改版、直接以本软件作为付费爬虫课程的案例等。

禁止非法修改，包括但不限于往软件中植入病毒木马、非法获取用户隐私等

禁止非法使用，包括但不限于未经主播本人同意非法录制和上传直播录像、用于非法监控他人、大量录制给抖音服务器造成压力等。

任何非法修改与非法使用等均与软件作者本人无关，由非法修改者或非法使用者负责。