Bitfocus Companion 完整指南把 Stream Deck 变成专业媒体控制面板【免费下载链接】companionBitfocus Companion enables the Elgato Stream Deck and other controllers to be a professional shotbox surface for an increasing amount of different presentation switchers, video playback software and broadcast equipment.项目地址: https://gitcode.com/gh_mirrors/co/companionBitfocus Companion 是一个开源媒体控制系统它把 Stream Deck 或任意物理控制器变成专业控制面板一个键就能指挥 OBS、摄像机、音频和灯光不用再在多个软件之间来回奔波。媒体控制痛点导播台为什么总差一个一键切换晚上九点的直播现场。导播在 OBS 里切机位在另一台软件里压音乐还得管第三块面板的灯光。想切到 2 号机位、音乐渐弱、舞台灯亮起得按顺序点三个不同软件。漏点一下直播就穿帮了。Bitfocus Companion 就是为这个痛点而生的它接管物理控制器的按键分配把一串操作压缩成一个键还能把各个软件的状态同步回按钮灯光。⚡ 30秒看懂 Bitfocus Companion 是什么开源媒体控制面板一句话定位把任意按键盒变成专业 shotbox现场导播台的开源媒体控制中枢。核心能力硬件不挑Stream Deck、Loupedeck、Elgato Key 等物理控制器都能认软件不挑700 连接模块覆盖 OBS、vMix、QLab、灯光音响设备按钮完全可编程短按、长按、双击、多步序列每步都能触发不同操作双向反馈按钮背光随软件状态变化一眼看出场景是否就绪分布式部署一台服务器同时服务多个控制终端管理界面左侧功能入口、右侧配置区按钮配置与连接管理快速切换。 Bitfocus Companion 内部分层拆解3 层各管一件事整个系统是三层结构每层只干一件事硬件接入层目录companion/lib/Surface/。像个翻译官不管设备的 USB 协议多奇怪都翻译成统一的按钮旋钮屏幕语言上层不用关心硬件细节。设备驱动本身也是模块化的新机型装个模块就能接。控制逻辑层目录companion/lib/Controls/。每个按钮在这里被当作一台小状态机管理按下、松开、长按、双击每种手势可以指向不同的动作序列动作执行器按你定义的顺序逐步跑完操作。协议交互层如companion/lib/Service/OscApi.ts。动作要发出去时这一层把它翻译成 OSC、HTTP 或原始 TCP/UDP 发出去。每种协议各有一个独立服务但内部说的是同一种话控制逻辑完全不用关心具体协议。 关键能力深潜按钮序列、状态反馈与分布式控制怎么实现按钮是一串动作序列不是单次触发用在哪直播时一个键要完成音频淡出→切场景→上字幕没人想连按三下。怎么做按钮可以挂多个步骤每种手势指向不同的步骤组合按顺序执行。你拿到的收益导播只记键位、不记顺序复杂操作压缩成一次按键。按钮配置界面为每个按键绑定动作序列支持多页面与快捷键。按钮灯是一块状态显示屏用在哪舞台上要一眼看出哪台摄像机是活动机位看笔记本太慢。怎么做变量系统持续从已连接软件取状态表达式引擎做如果 A 就的判断条件成立时按钮背光或图标跟着变。你拿到的收益不用看屏幕控制器面板本身成了状态板。一台服务器带多个控制端用在哪大型活动导播台、灯光台、音响室各要一套控制买多台设备太贵。怎么做Companion 提供 Satellite 通道TCP 和 WebSocket远端客户端或浏览器页面可以在任何终端上渲染同一套按键布局操作再通过网络回传给中心服务器。你拿到的收益硬件复用、布局一致新增终端只改一条网络配置。浏览器控制面板网页打开同款按键布局无硬件也能远程操作。️ 2 个真实场景的按钮配置步骤直播导播从 0 到一键切换第一步Stream Deck 接上电脑启动 Companion自动识别设备。 第二步Web 界面点添加连接选 OBS。 第三步给按钮绑定切场景压音乐把活动状态设成红灯。 完成按一下就出效果。会议室 AV无头服务器 平板第一步Docker 无头方式在服务器上跑 Companion挂载配置目录。 第二步平板浏览器打开服务器地址看到同款控制面板。 第三步把开始投屏绑到按钮上全会议室的人都能一键发起。 生态与扩展700 连接模块如何运转模块系统像个 App Store入口是companion/lib/Instance/ModuleStore.ts负责安装、更新、卸载。每个模块自带清单声明自己需要哪个 API 版本和哪些依赖系统加载时校验兼容性不匹配就拒装不会拖垮整个程序。700 多个连接模块从 OBS、vMix 到灯光音响全覆盖设备驱动从 4.3 版本起也模块化新机型装个模块就能加进来社区模块还在持续更新。模块管理界面已装连接模块与版本一目了然更新统一处理。✅ 上手与选型3 步跑起 Bitfocus Companion 的部署方式适合谁做直播、会议室 AV、剧院演出需要用物理按钮同时操作多套软件的人。桌面端官网下载安装包分稳定版和 beta装上直接跑服务器端用 Docker 镜像无头运行记得挂载卷持久化配置参与开发克隆仓库 https://gitcode.com/gh_mirrors/co/companion 然后运行yarn dev启动本地开发⚠️ 三个常见坑Linux 下 USB 控制器需要装 udev 规则程序会提示你操作Docker 不支持 USB 直通物理 Stream Deck 要本地跑或用卫星方案生产环境选稳定版beta 功能多但可能有 bugCompanion 把按键变成了可编程的资源硬件层管接入逻辑层管序列协议层管送达。想动手试试先接上控制器挑一套你最常用的软件绑定第一个按钮序列——按下去的那一刻你就明白专业团队为什么离不开它了。【免费下载链接】companionBitfocus Companion enables the Elgato Stream Deck and other controllers to be a professional shotbox surface for an increasing amount of different presentation switchers, video playback software and broadcast equipment.项目地址: https://gitcode.com/gh_mirrors/co/companion创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
