mikufans录播姬

简体中文 README | Simplified Chinese

GitHub is a global platform, and theoretically, everyone should use English. But since this project is mostly meant for Chinese user and rely on a Chinese website BiliBili (wikipedia), most things related to this project like code comments, documentations and other related repositories are written in Chinese. This README file will always use English so people like you can understand what is this, and perhaps make some use out of it.

Software UI is available in

• 简体中文 (Source and default)
• 繁体中文
• 日本語
• English

Installation

See rec.danmuji.org (in Chinese) for Windows installer with auto update.

Alernatively, you can download from releases page.
The zip file available at the releases page does not have auto update enabled. You are welcome to watch this repository for new releases. (Click the "Watch" dropdown menu, then "Custom", and check the "Releases" checkbox).

Binary files of the command line version are available for Linux, macOS, and Windows at releases.

Docker images can be pulled from Docker Hub bililive/recorder or ghcr.io/bililiverecorder/bililiverecorder.

See rec.danmuji.org/user/install for step by step installation guides (in Chinese).

Feature

• Easy to use
• Start recording automatically when stream starts
• Record multiple stream at same time
• Fix broken recording caused by broken bilibili stream server
• Toolbox mode to fix broken bilibili stream recording recorded by other software¹
• Pure C#, no native dependency like ffmpeg²
• Open source!

¹: Only unprocessed flv file downloaded directly from stream servers can be fixed. If the file is downloaded or processed by FFmpeg it no longer can be fixed, FFmpeg will fvck up the already broken recording even further.
²: A minimal version of FFmpeg is bundled with the desktop edition of BililiveRecorder for the remux feature in toolbox.

Versioning

This project is following Semantic Versioning since version 2.0.0.

Please note this does not include the public .NET API of BililiveRecorder.Flv, or any project within this repository for that matter. They are considered as internal implementation thus could have breaking changes in any releases.

Building from source

Note: full git history is required for version generation to work.

WPF version:

cd BililiveRecorder.WPF
msbuild -t:restore
msbuild

Command line version:

# Build WebUI, optional
git submodule update --init --recursive
./webui/build.sh
# For building on Windows:
# ./webui/build.ps1

dotnet build BililiveRecorder.Cli

Project structure

graph BT
    toolbox(BililiveRecorder.Toolbox) --> flv(BililiveRecorder.Flv)
    core(BililiveRecorder.Core) --> flv
    wpf(BililiveRecorder.WPF) --> core
    wpf --> toolbox
    cli(BililiveRecorder.Cli) --> toolbox
    cli ---> core
    web(BililiveRecorder.Web) --> core
    cli --> web

Reference & Acknowledgements

• Adobe Flash Video File Format Specification 10.1.2.01.pdf
• coreyauger/flv-streamer-2-file Used as a reference in the early stages of development
• zyzsdy/biliroku - (probably) first BiliBili stream recording tool.