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 是一款免费开源的软件定义控制器它让 Elgato Stream Deck 等硬件面板脱离官方 App 的限制变成可自由编程的专业控制面用来驱动 OBS、vMix、ATEM 等直播与演播设备。如果你是直播导播、现场演出技术员或会议室管理员受够了重复的手动操作这篇指南会带你在二十分钟内从安装走到按下第一个自定义按键。三种真实场景看看你需要它吗直播导播台切一个场景手动往往要做三件事——切信号源、调音量、改标题。Companion 允许把这些动作绑到同一个按钮上一次按键全部完成。现场演出/剧院调光台、音频台、视频切换器分散在不同位置。Companion 部署在一台常开的电脑或树莓派上把多个设备的控制收拢到一块 Stream Deck还能通过页面权限把导播页灯光页分给不同的人。企业会议室摄像头、显示屏、麦克风的状态各不相同。用 Companion 做一块一键入会面板按钮颜色直接反映设备当前状态不用打开任何网页查询。按钮的秘密动作 反馈 变量三件套讲透Companion 里每个按钮都不是图标 一个功能而是由三部分组成的可编程容器动作Action按下时执行的操作可以串联多个。例如切到场景 A → 关闭当前麦克风 → 发送一条 OSC 指令给调光台。反馈Feedback按钮长什么样由条件动态决定。例如如果 OBS 当前场景等于 A按钮背景变绿。变量Variable连接上的设备会把自己的状态上报成变量反馈和动作都能读取它们。举个例子你做了一个推流中按钮它按下时启动 OBS 推流与此同时只要推流状态为 true按钮就保持红色高亮。导播台边任何人一眼就能看出当前是否在播这就是按钮即状态显示屏的效果。快速上手从安装到点亮第一个按钮安装并打开 Bitfocus CompanionWindows / macOS下载对应安装包安装后直接运行会看到启动器窗口。树莓派 / 无头服务器官方提供 CompanionPi 镜像和安装脚本一次部署长期开机。Docker适合已有服务器环境的用户用一条docker run命令即可拉起。启动后在浏览器打开管理面板默认端口 8000推荐 Chrome。⚠️ 提前关闭 Elgato Stream Deck 官方 App让 Companion 独占设备这是最常见的连接失败原因。详见 安装文档。连接 Stream Deck 并确认识别打开左侧Surfaces表面页面设备应自动出现在列表中没有的话点一下Rescan USB即可。你可以给设备命名、调节亮度还能把两块并排的 Stream Deck XL 编入同一个Surface Group当一块 16×4 的大面板用换新硬件时只要插进同组按钮配置不用改一个。Stream Deck 按钮配置流程以 OBS 为例加连接在Connections连接页选择 OBS 模块填入它的 IP 和端口保存后右侧出现该设备的可用变量列表。建按钮在Buttons按钮页点击一个空格子选Regular button如果模块提供了预设直接把预设拖进格子更快预设之后同样可改。加动作编辑按钮 → Actions → 添加Set Program Scene等动作可以按顺序排多条。加反馈添加一条当程序场景等于 XX 时按钮底色变绿的条件。测试没有实体设备也能验证——浏览器打开内置Emulator模拟器它就是一块虚拟 Stream Deck点击按钮和实体操作效果一致。模块生态需要什么设备装什么插件从 4.0 版本起Companion 不再内置所有设备支持而是把它们做成了可在线下载、独立升级的模块插件OBS、vMix、SACN 灯光、各种硬件面板……每个连接都可以单独选择模块版本互不影响。模块的安装、更新与兼容性校验由 ModuleStore.ts 统一处理。如果 Stream Deck 不在本机还可以用Satellite功能在设备所在的小电脑上跑一个轻量客户端通过网络把面板远程插到 Companion 上配合Surface Group实现导播台、灯光位各放一块面板的分布式布局。协议对接层则统一放在 Service 目录 中OSC、HTTP、TCP/UDP 各有一套现成实现。适合谁下一步做什么适合人群直播主与导播把场景切换、推流、字幕等操作压成一键演出/活动工程师多设备集中控制按角色分配页面会议室/中控管理员设备状态可视化操作标准化模块开发者基于companion-module生态快速写出新设备驱动一句话建议先下载 Companion接上或模拟一块Stream Deck只做一个目标——让一个按钮切 OBS 场景并变色成功后再往上添设备、添动作整个控制面就是你的了。【免费下载链接】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），仅供参考
