OpenBLive Studio

一款面向 B站 / 哔哩哔哩主播的轻量级桌面开播助手，支持 OBS 开播联动、直播姬工作流补充、多账号管理与直播互动管理

---

📖 项目介绍

OpenBLive Studio 是一款面向 B站 / 哔哩哔哩直播 场景的第三方桌面端开播与互动工具，适合需要 B站 OBS 开播联动、直播姬轻量补充、多账号切换运营、弹幕互动管理 与 房间秩序维护 的主播、运营和技术流用户。项目采用 Tauri v2 作为桌面容器，前端基于 React 19、Vite、TypeScript 与 Tailwind CSS v4 构建。

当前版本已经覆盖 账号管理、直播数据看板、开播控制、直播互动、房间管理、悬浮弹幕小窗、外部 WS/Overlay 接入、OBS / 命令联动与应用更新 等完整流程，目标是为 B站 OBS 开播 和 直播姬配套使用 提供一个更轻、更快、更清爽的桌面体验。

如果你正在搜索以下方向，这个项目就是为这些需求设计的：

• B站 OBS 开播工具 / 哔哩哔哩 OBS 开播助手
• 直播姬替代补充 / 直播姬精简版工作流
• B站多账号直播管理 / 多账户快速切换开播
• B站弹幕互动管理工具 / 直播间房管辅助工具
• B站 OBS 弹幕 Overlay / WebSocket 弹幕接入方案

🎯 适合的使用场景

• 使用 OBS Studio 推流，希望把直播标题、分区、推流码、开播状态与桌面工具统一管理。
• 使用 直播姬 之外的开播方式，但仍然希望保留对 B站直播互动、房间管理与弹幕处理 的完整控制。
• 同时运营 多个 B站账号 / 直播间，需要快速切换账号并管理不同开播身份。
• 需要一套更适合 互动高峰期 的工具，把弹幕、礼物、SC、禁言、黑名单、房管操作集中在一起。
• 需要将直播消息通过 WebSocket / Overlay / Shell Command / OBS WebSocket 输出到自己的直播工作流中。

✨ 当前支持的功能

• 🔑 多账号管理：支持扫码登录、保存多个 Bilibili / B站账号，并快速切换当前开播账号，适合多频道、多身份或代播场景。
• 📊 直播数据看板：提供整体表现雷达图、历史场次趋势，以及最近一场直播的详细数据摘要，便于复盘每次 B站直播表现。
• 🎛️ 开播控制台：支持同步直播间资料、编辑标题 / 分区 / 标签、复用最近分区、获取并复制推流地址与推流码、一键开播 / 关播，是典型的 B站 OBS 开播辅助面板。
• 💬 直播互动能力：实时接收弹幕、礼物、大航海、Super Chat、进场、撤回等消息，支持快捷发弹幕、房间表情与直播投票，强化主播和观众的实时互动。
• 🛡️ 直播间管理能力：支持禁言管理、黑名单管理、房管管理与分页浏览，适合在高弹幕密度场景下完成直播秩序维护。
• 🪟 悬浮弹幕小窗：内置独立弹幕窗，支持开机自动显示、透明度调节、显示 / 隐藏与置顶控制，方便搭配 OBS、直播姬或副屏使用。
• 🔌 外部接入能力：内置 HTTP + WebSocket 服务，开放 /overlay、/api/chat、/ws，兼容 blivechat 风格 Overlay，方便构建自己的 B站直播弹幕展示 方案。
• 🎚️ OBS / 自动化联动：支持 OBS WebSocket 联动，也支持通过 Shell Command 在开播 / 下播时触发外部动作，适合集成进现有直播工作流。
• 🔄 项目与更新：内置版本检查与平台差异化更新入口，同时提供项目介绍、技术栈与鸣谢信息。
• 🌐 多语言与调试配置：支持 auto / zh-CN / en-US，并提供默认折叠的高级调试配置用于代理、镜像和签名参数排障。

🖼️ 界面预览

首页 / 账号管理

数据看板

直播控制

直播互动

弹幕小窗

🛠️ 技术栈

• 桌面容器：Tauri v2 + Rust
• 前端框架：React 19
• 构建工具：Vite 7
• 样式方案：Tailwind CSS v4
• 图表组件：Recharts
• 兼容 Overlay 前端：overlay-compat（Vue 2）

📚 文档导航

• OBS 联动配置教程
• 外部 WebSocket API 文档
• Overlay / blivechat 兼容层说明

🧩 高级调试配置（默认折叠）

仅在以下场景建议填写，留空时程序会使用内置默认值：

• 需要通过代理、网关或镜像域名转发 Bilibili API
• 需要临时切换 App 签名参数、弹幕网关或 LiveHime 版本参数进行排障

可覆盖项包括：

• host_www
• host_api
• host_live_api
• host_passport
• host_live_web
• cookie_domain
• danmu_host
• app_key
• app_sec
• http_user_agent
• livehime_version_override
• livehime_build_override
• live_platform

同时支持通过环境变量注入，且优先级低于设置页中的保存值：

• OPENBLIVE_HOST_WWW
• OPENBLIVE_HOST_API
• OPENBLIVE_HOST_LIVE_API
• OPENBLIVE_HOST_PASSPORT
• OPENBLIVE_HOST_LIVE_WEB
• OPENBLIVE_COOKIE_DOMAIN
• OPENBLIVE_DANMU_HOST
• OPENBLIVE_DANMU_WSS_PORT
• OPENBLIVE_APP_KEY
• OPENBLIVE_APP_SEC
• OPENBLIVE_HTTP_USER_AGENT
• OPENBLIVE_LIVEHIME_VERSION
• OPENBLIVE_LIVEHIME_BUILD
• OPENBLIVE_LIVE_PLATFORM

补充说明：

• Host 支持填写 host 或完整 URL，程序会自动归一化为 origin。
• cookie_domain 支持填写 host 或 URL，程序会自动提取域名并规范化。
• host_live_web 会同时影响侧边栏“打开直播间”外链。
• http_user_agent 支持一键生成当前操作系统对应的系统 UA，也可手动覆盖。

🚀 贡献与开发指南

如果您希望在本地运行、修改或打包本项目，可以参考以下步骤。

前提条件

1. Node.js（建议 v18+）
2. pnpm（建议 v8+）
3. Rust 开发环境（需安装 rustup、cargo 以及对应操作系统构建工具，详见 Tauri 官方安装指南）

本地开发步骤

1. 克隆仓库

   git clone https://github.com/mozi1924/openblive.git
   cd openblive

2. 安装依赖

   pnpm install

3. 启动开发环境

   pnpm tauri dev

构建与打包

项目包含三部分：

• 主前端：根目录 React + Vite
• Overlay 前端：overlay-compat
• 桌面后端：src-tauri（Rust + Tauri）

推荐按以下顺序进行本地验证：

pnpm build:desktop      # 构建主前端与 overlay 前端
pnpm build:backend      # 编译 Rust 后端（release）
pnpm package:desktop    # 打包桌面安装包

也可以直接执行：

pnpm verify:release

打包产物默认位于 src-tauri/target/release/bundle/。

GitHub Release 自动构建

仓库内提供了 .github/workflows/release.yml，用于在发布时自动构建并上传安装包到 GitHub Release。

• 触发方式 1：推送版本标签（如 v0.1.1）
• 触发方式 2：手动触发 workflow_dispatch
• 构建平台：macOS / Windows / Linux

macOS 使用提示

macOS 用户在下载并移动应用后，需要先移除隔离属性，再启动：

sudo xattr -dr com.apple.quarantine "/Applications/OpenBlive Studio.app"

如果应用不在 Applications 目录，请将命令中的路径替换为实际安装位置。

⚖️ 关于开源生态与官方平台兼容性的说明

本项目（OpenBLive）作为社区独立开发的轻量化工具，旨在作为官方客户端（直播姬）的生态补充，而非替代品。我们在此诚挚呼吁官方平台能够包容并支持本项目的存在，原因如下：

• 🌐 完善跨平台生态（Linux / macOS）
  官方直播姬目前主要聚焦于 Windows 平台，这使得大量使用 Linux 或 macOS 的创作者、工程师、独立游戏开发者在平台开播时面临巨大的技术门槛。OpenBLive 实现了原生跨平台支持，填补了这一生态空白，能为平台吸引并留住更多高素质的跨平台创作者。
• ⚡ 优化低功耗与边缘设备体验
  官方直播姬功能全面，但对于使用轻薄笔记本、迷你主机（Mini PC）或移动推流设备的创作者来说，其性能开销和内存占用往往会成为核心痛点。OpenBLive 经过极致的编译优化（最终体积仅约 6MB），将 CPU 和内存占用降到了最低。这保证了即使在配置有限的设备上，创作者也能流畅完成推流，极大地降低了直播的硬件门槛。
• 🌍 推进国际化与无障碍传播（i18n Support）
  随着多元化创作者的加入，非简体中文用户（海外留学生、海外创作者等）对直播工具的需求日益增加。由于官方工具暂未全面支持国际化（i18n），OpenBLive 的多语言支持能够帮助这部分用户无缝接入平台生态，促进社区的多元化和友好交流。

总结：
封杀优秀的社区开源工具，不仅会伤害核心开发者与硬核创作者的感情，也会将原本属于平台的跨平台用户、低配置用户和海外用户拒之门外。我们希望与平台共同维护一个健康、开放、多元且充满活力的技术与创作社区。

📈 Star History

🤝 特别鸣谢

• 感谢 bilibili-api-collect 项目，其整理归纳的哔哩哔哩 API 接口文档为本项目的账号登录、开播控制等核心功能提供了重要参考。
• 感谢 ChaceQC/bilibili_live_stream_code 项目，为本项目提供了 API 链路与实现思路参考。
• 感谢 TNXG/bilibili_live_stream 项目，为本项目提供了功能设计启发。
• 感谢 Radekyspec/StartLive 项目，为本项目提供了工程实践启发。
• 感谢 xfgryujk/blivechat 项目，为本项目的外部弹幕 WS 服务与兼容 Overlay 前端提供了参考。

📄 开源协议

本项目采用 MIT License 开源协议。