BiliLocal：给本地视频加弹幕的完整指南

BiliLocal：给本地视频加弹幕的完整指南

【免费下载链接】BiliLocaladd danmaku to local videos项目地址: https://gitcode.com/gh_mirrors/bi/BiliLocal

把视频文件丢进播放器，画面里空无一字——离线追番，这大概是很多用户最没归属感的一刻。BiliLocal 本地弹幕播放器就是为此而生：它基于 Qt 开发，既能按文件名自动匹配并加载 B 站弹幕，也支持直接导入本地弹幕文件，让离线视频拥有在线同款的氛围。

界面与核心功能速览

主窗口分为左右两区：左侧控制面板提供文件选择、弹幕搜索、本地弹幕导入与弹幕记录入口；右侧视频区叠加弹幕层，支持滚动、逆向、顶部、底部、彩色等弹幕形态（对应src/Graphic/中 Mode1 到 Mode7 的渲染模式）。

如上图所示，左侧有文件名输入框与打开、搜索、本地弹幕按钮，下方是弹幕记录列表；画面上彩色弹幕与白色弹幕同屏飘过，说明本地视频已经挂上了弹幕层。

📦 克隆、构建与运行

项目用 qmake 组织构建（入口为BiliLocal.pro），克隆后执行：

git clone https://gitcode.com/gh_mirrors/bi/BiliLocal cd BiliLocal mkdir build && cd build qmake ../BiliLocal.pro make -j4

Linux 下需先装好 Qt5、libvlc、libswscale/libavutil 与 OpenSSL 开发包，其余平台会自动启用对应的播放内核与 OpenGL 渲染。

🔧 功能深挖：匹配、渲染与屏蔽

弹幕怎么找到

把视频拖入窗口或作为命令行参数传入即可：程序按后缀分流——视频交给播放器，.xml/.json 弹幕文件交给 Load 模块解析，字幕文件直接叠加（见src/Local.cpp的 tryLocal）。搜不到在线弹幕时，可用"本地弹幕"按钮手动导入。

界面上可见彩色、滚动与顶部弹幕同屏出现，左侧弹幕记录列表会为加载过的内容留档，回看时不必二次下载。

渲染引擎与播放内核怎么选

桌面端同时编译了光栅与 OpenGL 两套渲染器（src/Render/下各有实现），低配机器可切光栅模式保帧率；播放内核按平台启用 VLC 或 QtMultimedia，弹幕线程数与数量也能在配置中调节。

从这张截图能看到，满屏弹幕的场景下画面与弹幕分层依然清晰，这正是独立渲染层设计的效果。

屏蔽规则与个性化

不想看的弹幕可加入屏蔽词库，Shield 模块按关键词拦截（src/Model/Shield.cpp）。字体、字号、配色等偏好写入 JSON 配置，退出时自动保存，重启直接沿用。

❓ 常见问题

弹幕搜不到？多是文件名与视频标题对不上，先核对拼写；仍不行就改用本地弹幕文件导入。

构建报错找不到头文件？基本是依赖缺失，安装 libvlc-dev、libssl-dev、libswscale-dev 后重试。

能加字幕吗？可以，播放中拖入字幕文件即可叠加显示。

写在最后

BiliLocal 补上了"在线才有弹幕"这块缺失：文件名匹配、本地导入、双渲染引擎、关键词屏蔽，是一套完整的本地弹幕方案。适合离线追番党、视频收藏者，以及所有想把 B 站弹幕氛围搬进本地播放器的用户。

【免费下载链接】BiliLocaladd danmaku to local videos项目地址: https://gitcode.com/gh_mirrors/bi/BiliLocal