🎥 BiliLive-tools: All-in-One Live Streaming Toolkit for Danmaku & Video

BiliLive-tools automates danmaku conversion, video encoding, and B站 uploads in one workflow. An open-source all-in-one solution replacing fragmented tools.

The Terminator of Fragmented Tools — Automating Danmaku Processing, Video Encoding, and Uploads End-to-End

As the B站 content ecosystem thrives, live recording has become a vital part of content creation. Yet the traditional recording workflow is painfully cumbersome: danmaku conversion, video compression, multi-part uploads… each step demands a different tool, and the learning curve is brutal. BiliLive-tools was born to solve exactly this. This free, open-source, all-in-one tool handles danmaku conversion and video encoding, then uploads directly to B站 — completely eliminating workflow fragmentation and boosting efficiency for recording and clipping editors by 300%!

I. BiliLive-tools Core Feature Breakdown

1. End-to-End Automated Workflow

• Recording Support: Natively supports live recording from B站, Douyu, Huya, and Douyin, with automatic capture of danmaku and gift data.
• Danmaku Processing: Built-in DanmakuFactory-compatible engine for XML danmaku conversion, timeline alignment, and keyword-based clipping.
• Smart Encoding: Leverages FFmpeg for efficient H.265/H.264 transcoding, with hardcoded subtitle burning (avoiding player compatibility issues).
• Seamless Uploads: Auto-integrates with B站's submission system, fixing the notorious multi-part video ordering chaos, with resume-on-failure support.

2. Revolutionary Efficiency Tools

3. Feature Matrix

II. Installation & Configuration Guide

1. Multi-Platform Installation

• Windows Users:
• Download the exe installer from the GitHub Release page.
• Extract and run bililive-tools.exe — the environment initializes automatically.
• Linux Users:

npm i bililive-cli -g # Global CLI install
docker-compose up -d # Docker deployment

• Backup Download: Quark Pan — https://pan.quark.cn/s/6da253a1ecb8.

2. Key Configuration Steps

• Webhook Setup (using B站 Recorder as example):
• Open Recorder settings → Webhook → Add URL: http://localhost:1919/webhook.
• Set trigger event to "Recording Finished".
• B站 Login Configuration:
• Log into B站 in your browser, press F12 → Network → find the nav request → copy the cookie value from Request Headers.
• Paste it into the cookies.txt file in the software directory.
• Encoding Preset (recommended):

"encode_preset": {
 "crf": 23,
 "encoder": "h264_nvenc", // NVIDIA GPU acceleration
 "danmaku_opacity": 0.8 // Danmaku transparency
}

III. Practical Operation Guide

1. Fully Automated Recording Processing

• Launch the software and enter Monitor Mode.
• When the Recorder finishes recording → Webhook fires.
• Automatic execution:
• Danmaku XML conversion (compatible with B站 subtitle system).
• Video encoding (original quality → 720P 60fps).
• Generate multi-part metadata file.
• Upload to B站 Draft Box.

2. Danmaku Clipping Techniques

Want to extract the "highlight moments" from a livestream? Use Danmaku Density Analysis:

• Import the recording → select the "Danmaku Analysis" tab.
• Set trigger conditions:
• Danmaku count > 50 messages per 10 seconds.
• Keyword matching (e.g., "hahaha", "wow").
• Automatically generate clip timestamps.
• Export clip segments in one click.

3. Multi-Platform Download Example

Grab a Douyu replay (with danmaku):

bililive-cli download --platform douyu \
 --url "https://v.douyu.com/show/xxxx" \
 --with-danmaku

IV. Competitive Advantages

💡 Why It's Irreplaceable: BiliLive-tools is the only tool delivering a true "Record → Process → Upload" closed loop, solving two critical pain points:

• Multi-part video submission order chaos (auto-sorts by timestamp).
• Danmaku-video desync (built-in timeline calibration algorithm).

V. Pro Tips & Troubleshooting

1. Performance Optimization

• Hardware Acceleration Setup:
• NVIDIA GPU: Edit "encoder": "h264_nvenc" in settings.json.
• Intel iGPU: Use "encoder": "h264_qsv".
• Memory Control: For large video processing, add "memory_limit": "8G" to prevent crashes.

2. Common Issue Troubleshooting

• Danmaku Burning Failure:
  Check font file path — /fonts/msyh.ttf (Microsoft YaHei) is recommended.
• Upload Stalling:
  Change upload_threads: 3 (default 5 threads may be throttled by B站).
• Multi-Part Title Disorder:
  Manually add "parts": ["Title 1","Title 2"] in metadata.json.

3. Raspberry Pi Special Build

Optimized for ARM devices:

wget https://github.com/withsalt/BilibiliLiveTools/releases/download/1.5.0/BilibiliLiveTools_Linux_ARM32.zip
unzip BilibiliLiveTools_Linux_ARM32.zip
./BilibiliLiveTools --low-power-mode # Enable low-power mode

Conclusion: Why Choose BiliLive-tools?

When the traditional workflow demands switching between OBS recording + DanmakuFactory processing + FFmpeg encoding + manual uploads — four separate tools — BiliLive-tools handles everything in a unified interface. User tests show that processing a 3-hour livestream recording dropped from 2 hours down to just 20 minutes.

Project URL: https://github.com/renmu123/biliLive-tools

Best Use Cases:

• Individual streamers archiving live content.
• Esports commentary replay production.
• VUP fan clip creation.
• Permanent storage of educational livestreams.

Note: This is the English translation of the original Chinese version.