ai-agent

obs-websocket

Name: obs-websocket
Author: obsproject

Remote-control of OBS Studio through WebSocket

4,380 stars+7★ this week748 forksC++Updated 10/8/2026100% free · open source

What it does

OBS Websocket allows remote control of OBS Studio, a popular video streaming and recording software, through a WebSocket protocol.

When to use it

•When automating OBS Studio workflows, such as switching scenes or starting recordings, through a custom application or script.
•When integrating OBS Studio with other tools or services that support WebSocket communication, such as a web-based control panel or a mobile app.
•When creating custom plugins or extensions for OBS Studio that require remote control capabilities.

Ready-to-paste prompt

To switch to a scene named 'My Scene' using the OBS Websocket, send the following WebSocket message: `{'request-type': 'SetCurrentScene', 'scene-name': 'My Scene', 'message-id': '1'}`

Heads up: The obs-websocket plugin requires OBS Studio version 24.0 or later to be installed, and the WebSocket server must be running and configured correctly before attempting to connect to it.

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/obs-websocket && curl -fsSL https://workflowstacks.com/api/skills/obs-websocket/claude-skill -o ~/.claude/skills/obs-websocket/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How obs-websocket works

Codeflow

Free to inspect

Obs-websocket is a large C++ project (~16k lines across 83 code files). It is a full software project: use it through its install path rather than reading it end to end. Last commit 3 months ago, GPL-2.0 license, no tests found.

Size

Large codebase

~16k lines · 83 code files · ~2 h to skim

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

C++

No API keys detected

C++ 96%C 3%CMake 1%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
src/Config.cpp
Inside src/ — the main logic begins here

What's in each folder

src/Core code — the actual logic82 files

lib/Core code — the actual logic2 files

docs/Documentation17 files

data/Data files57 files

cmake/Folder3 files

CI/Folder1 files

.github/CI / automation (GitHub Actions)9 files

READMENo tests foundDocumentedCI checksGPL-2.0 licenseUpdated 3 mo ago

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/obs-websocket && curl -fsSL https://workflowstacks.com/api/skills/obs-websocket/claude-skill -o ~/.claude/skills/obs-websocket/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

obsproject

Language

C++