obs-websocket

Automate OBS Studio scene changes and streaming controls via obs-websocket WebSocket RPC.

15|4|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/damionrashford/media-os --skill obs-websocket
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obs-websocket
Source: https://github.com/damionrashford/media-os/tree/main/skills/obs-websocket
Command: npx skills add https://github.com/damionrashford/media-os --skill obs-websocket

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires websocket-client, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Remote-control OBS Studio via the obs-websocket API to automate scenes, streaming state, and other controls from scripts or dashboards.

Core Features & Use Cases

  • Remote scene switching, starting/stopping streams and recordings, toggling sources, and adjusting audio mixers via the WebSocket API.
  • Subscribing to live events and issuing batched requests to orchestrate complex live productions across local or remote OBS instances.

Quick Start

Connect to ws://host:4455 and issue your first SetCurrentProgramScene command to begin automation.

Frequently Asked Questions about obs-websocket

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate scene switching in OBS Studio via WebSocket?

You can start and stop OBS Studio streams by sending remote control commands through the obs-websocket RPC. The WebSocket connection subscribes to events and issues requests that toggle streaming state safely across local or remote instances.

How does the obs-websocket v5 handshake protocol work for remote control?

Yes, you can toggle sources and adjust audio mixers in OBS Studio by sending WebSocket RPC commands. The automation script issues requests to the remote instance to manipulate sources and audio levels during live streaming.

What's the best way to issue batched requests to OBS Studio for live productions?

You need the websocket-client dependency installed in your Python environment to connect to OBS Studio. This library handles the WebSocket connection required for the Identify handshake and subsequent RPC communication.

Does this remote control approach work with local and remote OBS instances?

Yes, this remote control approach works with both local and remote OBS instances via WebSocket connections. By pointing your script to ws://host:4455, you can automate streaming controls and subscribe to events over the network.