
OBS-captions-plugin
OBS 直播自动生成实时字幕,静音观众也能看懂
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-01 · 当前星标 ★ 1349
使用教程
环境要求
- 已安装 OBS Studio(Windows / macOS / Linux)
- 能从 GitHub Releases 页面下载对应系统的插件压缩包(Windows/Linux:Closed_Captions_Plugin.zip;macOS
- 有权限向 OBS 安装目录或 OBS 设置目录写入文件(Windows 复制时需在弹窗中确认替换)
- 使用 Google Cloud Speech Recognition API 进行语音识别(字幕功能依赖它工作)
安装与启动步骤
-
1关闭 OBS
安装前先完全退出 OBS Studio,否则插件文件可能被占用或安装后不生效。
-
2下载并解压插件包
到 GitHub Releases 页面下载对应系统的最新压缩包并解压:Windows/Linux 包内是 obs-plugins 文件夹,macOS 包内是 cloud-closed-captions.plugin。
-
3Windows 安装
把解压出的 obs-plugins 文件夹复制粘贴到 OBS 安装目录(默认 C:\Program Files\obs-studio\ 或 C:\Program Files (x86)\obs-studio\,该目录下已有 obs-plug
-
4macOS 安装
把 cloud-closed-captions.plugin 放入 obs-studio 设置目录下的 plugins 文件夹;可用 OBS 菜单 File -> Show Settings Folder 打开该目录,没有 plugins
mkdir -p "$HOME/Library/Application Support/obs-studio/plugins" -
5Linux 安装
把 libobs_google_caption_plugin.so 按 OBS 插件目录结构放到插件文件夹中,路径通常如 README 所示(发行版和安装方式不同,插件目录位置差异较大)。
mkdir -p "$HOME/.config/obs-studio/plugins/libobs_google_caption_plugin/bin/64bit" cp libobs_google_caption_plugin.so "$HOME/.config/obs-studio/plugins/libobs_google_caption_plugin/bin/64bit/" -
6启动并确认入口
启动(macOS 为重启)OBS,确认 Tools 菜单底部出现 Cloud Closed Captions 选项。
-
7选择字幕音频源
点击 Captions Preview 窗口里的 Settings,在 Caption Source 中选择要识别的音频源;最好选只包含麦克风的 OBS 源,识别效果最佳。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
Caption Source | 是 | 选择用于生成字幕的 OBS 音频源,建议是仅含麦克风的源 | Microphone |
Caption When | 否 | 控制何时输出字幕,复杂音频设置可选 Mute Source is heard on stream | Mute Source is heard on stream |
Mute Source | 否 | 观众实际听到的混合音频源,用于判断何时可以出字幕 | Desktop Audio |
如何确认成功
启动 OBS 后,Tools 菜单底部出现 Cloud Closed Captions,点击能打开 Captions Preview 窗口即安装成功。
常见问题
Q:支持哪些直播平台?
A:README 只测试过 Twitch.tv;其他带原生字幕支持的平台或许可用,但可能性不大。
Q:麦克风静音时还会识别吗?
A:不会。只有选中的音频源未静音、且在当前活跃场景中使用时才会生成字幕,避免误识别。
Q:字幕延迟大吗?
A:字幕延迟通常小于半秒,观众基本察觉不到。
Q:双 PC 或调音台等复杂音频设置怎么办?
A:新建一个只含麦克风的音频输入采集源并静音,Caption Source 设为它,Caption When 设为 Mute Source is heard on stream,Mute Source 设为观众听到的混合音频源。
Q:能把字幕保存下来吗?
A:可以,插件支持把整场直播/录像的文字记录保存为 SRT 字幕文件或 txt,也可把当前字幕保存为文本文件供其他工具使用。
注意事项
- 安装前务必关闭 OBS,安装后再启动或重启。
- README 仅声明测试过 Twitch.tv,其他平台不保证可用。
- 插件只对未静音且在活跃场景中的选中音频源做识别,这是为了安全性设计。
- Windows 复制到 OBS 安装目录时会出现覆盖确认,多次点击「是」即可,只是把插件文件合并进已有的 obs-plugins 文件夹。
核心亮点
- 直接集成 OBS,作为滤镜/源使用,无需额外推流工具
- 基于 Google 语音识别,识别准确率在同类免费方案中较稳
- 支持多语言和字幕样式调整,能适配不同直播画面布局
不足之处
- 依赖 Google 语音识别服务,需要配置 API 凭据且可能产生费用
- 识别延迟和网络状况强相关,实时性受限于云端返回速度
适用场景
- 游戏主播给直播加实时字幕,方便静音观看的观众
- 在线教学或访谈直播中自动生成字幕,提升无障碍体验
- 录屏教程时同步生成字幕,减少后期手动打轴工作量
替代项目
obs-localvocal、whisper.cpp
下一篇:gipformer
同类项目推荐
K6nele
开源
装上它,任何安卓输入框都能语音打字
An Android app that offers speech-to-text user interfaces to other apps
mlx-qwen3-asr
开源
Mac 本地跑 Qwen3 语音识别,音频不出设备
Qwen3-ASR speech recognition on Apple Silicon via MLX
yandex-speechkit-lib-python
开源
几行代码接入 Yandex 语音识别与合成,快速构建语音应用
Python SDK for Yandex Speechkit API.
whisper-shortcut
开源
菜单栏一键语音,转文字、控剪贴板、AI 对话全搞定
Voice-first macOS menu bar app: dictate, voice-edit clipboard, read aloud, AI chat w···
web-voice-processor
开源
浏览器麦克风音频一键转 16kHz PCM,直喂语音识别
A library for real-time voice processing in web browsers
aidictation
开源
多端离线听写,开口即成文字
Open-source speech-to-text and dictation app for macOS, Windows, iPhone, iPad, and A···
Kaze
开源
按住说话,松手出字,全程本地不联网
Local speech to text app - Talk instead of typing.
harfiyen
开源
浏览器里离线转写土耳其语,边说边出字幕
Tarayıcıda çalışan Türkçe konuşma tanıma ve altyazı aracı. Otomatik nokta···
react-native-spokestack
开源
给 React Native 应用加上语音交互,一句话搞定识别、合成和理解
Spokestack: give your React Native app a voice interface!