OBS-captions-plugin

OBS 直播自动生成实时字幕,静音观众也能看懂

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 语音识别 🍴 复刻 94 🐛 待处理 88 👀 关注 29
GitHub ↗
GitHub 星标 ★ 1349
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源免费,依赖Google语音识别服务

项目预览

OBS-captions-plugin 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类语音识别
开发团队ratwithacompiler
定价模式🏷️完全免费
价格说明开源免费,依赖Google语音识别服务
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议GPL-2.0
主要语言C++
GitHub 星标★ 1349
上线时间2019-07-13 00:00:00
代码更新2026-10-09
仓库体积2.5 MB
本站数据更新2026-11-14
维护状态维护中
收录时间2026-10-01
浏览次数3

项目介绍

OBS-captions-plugin 是给 OBS Studio 用的实时字幕插件,通过 Google 语音识别把麦克风或桌面音频转成文字,直接叠加到直播画面上。它解决的是直播、录屏时手动打字幕太慢、观众听不清或静音观看体验差的问题。核心能力包括:在 OBS 里作为滤镜或源使用,自动持续识别语音并输出字幕,支持设置语言、识别延迟和字幕样式,字幕可随音频实时刷新。主播只需在 OBS 中添加该插件并配置 Google 语音识别凭据,就能让直播自动带字幕,适合访谈、游戏解说、在线教学等需要无障碍观看的场景。项目用 C++ 编写,星标约 1.3k,属于成长中的实用工具。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-01 · 当前星标 ★ 1349

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 7 步

环境要求

  • 已安装 OBS Studio(Windows / macOS / Linux)
  • 能从 GitHub Releases 页面下载对应系统的插件压缩包(Windows/Linux:Closed_Captions_Plugin.zip;macOS
  • 有权限向 OBS 安装目录或 OBS 设置目录写入文件(Windows 复制时需在弹窗中确认替换)
  • 使用 Google Cloud Speech Recognition API 进行语音识别(字幕功能依赖它工作)

安装与启动步骤

  1. 1关闭 OBS

    安装前先完全退出 OBS Studio,否则插件文件可能被占用或安装后不生效。

  2. 2下载并解压插件包

    到 GitHub Releases 页面下载对应系统的最新压缩包并解压:Windows/Linux 包内是 obs-plugins 文件夹,macOS 包内是 cloud-closed-captions.plugin。

  3. 3Windows 安装

    把解压出的 obs-plugins 文件夹复制粘贴到 OBS 安装目录(默认 C:\Program Files\obs-studio\ 或 C:\Program Files (x86)\obs-studio\,该目录下已有 obs-plug

  4. 4macOS 安装

    把 cloud-closed-captions.plugin 放入 obs-studio 设置目录下的 plugins 文件夹;可用 OBS 菜单 File -> Show Settings Folder 打开该目录,没有 plugins

    mkdir -p "$HOME/Library/Application Support/obs-studio/plugins"
  5. 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. 6启动并确认入口

    启动(macOS 为重启)OBS,确认 Tools 菜单底部出现 Cloud Closed Captions 选项。

  7. 7选择字幕音频源

    点击 Captions Preview 窗口里的 Settings,在 Caption Source 中选择要识别的音频源;最好选只包含麦克风的 OBS 源,识别效果最佳。

关键配置

配置项必填说明示例
Caption Source是选择用于生成字幕的 OBS 音频源,建议是仅含麦克风的源Microphone
Caption When否控制何时输出字幕,复杂音频设置可选 Mute Source is heard on streamMute 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

上一篇:expo-speech-recognition

下一篇:gipformer

同类项目推荐

K6nele 开源

装上它,任何安卓输入框都能语音打字

An Android app that offers speech-to-text user interfaces to other apps

★ 290 2026-09-27
mlx-qwen3-asr 开源

Mac 本地跑 Qwen3 语音识别,音频不出设备

Qwen3-ASR speech recognition on Apple Silicon via MLX

★ 248 2026-10-01
whisper-shortcut 开源

菜单栏一键语音,转文字、控剪贴板、AI 对话全搞定

Voice-first macOS menu bar app: dictate, voice-edit clipboard, read aloud, AI chat w···

★ 76 2026-08-09
web-voice-processor 开源

浏览器麦克风音频一键转 16kHz PCM,直喂语音识别

A library for real-time voice processing in web browsers

★ 251 2026-09-15
aidictation 开源

多端离线听写,开口即成文字

Open-source speech-to-text and dictation app for macOS, Windows, iPhone, iPad, and A···

★ 137 2026-11-11
Kaze 开源

按住说话,松手出字,全程本地不联网

Local speech to text app - Talk instead of typing.

★ 225 2026-10-11
harfiyen 开源

浏览器里离线转写土耳其语,边说边出字幕

Tarayıcıda çalışan Türkçe konuşma tanıma ve altyazı aracı. Otomatik nokta···

★ 118 2026-10-21
react-native-spokestack 开源

给 React Native 应用加上语音交互,一句话搞定识别、合成和理解

Spokestack: give your React Native app a voice interface!

★ 60 2026-08-09