danmaku-sender

Project Overview

BiliDanmakuSender is a danmaku restoration tool built with Python 3.12 and PySide6 (Qt), compiled with Nuitka for better runtime performance. It targets danmaku migration, backup recovery, and large-scale restoration, sending local XML danmaku files to chosen videos task by task. Each task can configure its own sending strategy, and every successfully sent danmaku is stored so the tool can deduplicate, resume, and track survival.

Send local danmaku files back to videos in batches, and keep an eye on whether they survive.

Key Features

• Multi-task queue: each task sets its own delay, burst mode, and auto-stop conditions, and XML files can be dropped onto the queue
• Risk-control avoidance: native WBI signing, random delays, burst mode, automatic retry on rate limits, and a fatal-error circuit breaker
• Danmaku editor: batch newline removal, overlong text truncation, and timeline shifting, with undo/redo and rainbow array generation
• Live validation: check length, newlines, out-of-range times, and blocked words before sending
• Danmaku monitor: show per-task survival rates in real time and periodically fetch online danmaku to verify survival
• History: every sent danmaku is stored, queryable by keyword, BV number, or status
• Fingerprint deduplication: skip danmaku with the same content, time, and color to avoid duplicates
• Resume: resend the same file and already-sent danmaku are skipped, continuing from the last point
• Account management: sign in by QR scan or manual SESSDATA and bili_jct entry, with credentials encrypted into the system keyring
• System integration: use the system proxy or force a direct connection, and get Windows notifications when tasks finish, pause, or abort

Target Audience

• Uploaders who restore danmaku for videos
• Collectors who back up and recover danmaku
• Enthusiasts who batch-restore danmaku
• Developers studying Bilibili APIs and risk control

Quick Start

1. Download the packaged build from Releases and run BiliDanmakuSender.exe, or install Python 3.12 and run from source
2. Click the avatar area at the top-left and sign in by QR scan or manual SESSDATA and bili_jct entry
3. On the Sender page, click New Task, enter a BV number or video link, and pick a part
4. Load a local XML danmaku file and adjust random delay, burst mode, and auto-stop settings
5. Click Start Queue to send, watch survival rates in the Monitor, and inspect details in History

Core Advantages

• Batch-friendly: queue many videos for restoration, each with independent strategy
• Dedup and resume: fingerprints are stored, so repeat files only fill in the gaps
• Observable: send history and online verification together make survival rates clear

System Requirements

Item	Requirement
OS	Windows
Runtime	Python 3.12 or later (the packaged build is install-free)
Account	A Bilibili account with danmaku sending permission

Notes

• Follow Bilibili's rules and local laws; do not use it for spam or other violations
• Cookies expire, so re-extract SESSDATA and bili_jct when needed
• Frequent sending may trigger risk control; keep random delays and burst mode enabled