Video Switchers & Live Production
OBS Studio Control Software
Control for OBS Studio via WebSocket v5.
Handlers run inside Fantago — the file is a plugin, not a standalone program. Start with the free 60-day trial.
How to connect OBS Studio to Fantago
- Open the Fantago Dashboard and click Add Device.
- Pick the OBS Studio (WS v5) handler from the device type list (internal id
obs_studio). - Enter the IP address of your OBS Studio, then set protocol TCP and port
4455. - Save and connect. Fantago starts polling the device and publishes its feedback variables, ready to use in panels, sequences and logic flows.
- Drag the actions below onto a panel button, a Stream Deck key, a schedule or a logic flow node.
| Protocol | TCP |
|---|---|
| Default port | 4455 |
| Handler version | 1.0.0 |
| Author | Fantago Bridge |
| Internal ID | obs_studio |
Description & Instruction
Setup: Set IP and Port (default 4455).
Params: Set 'password' in Handler Params if enabled in OBS.
Command Integration Guide
This guide explains how to send specific commands to the OBS Studio (WS v5) handler.
Generic Command Format (WebSocket JSON-RPC):
The handler communicates via WebSocket using OBS WebSocket v5 protocol. Direct commands require a JSON-RPC 2.0 message structure.
{"op": 6, "d": {"requestType": "SetCurrentProgramScene", "requestId": "1", "requestData": {"sceneName": "MyScene"}}}(Set Program Scene){"op": 6, "d": {"requestType": "ToggleRecord", "requestId": "2"}}(Toggle Recording){"op": 6, "d": {"requestType": "SetInputMute", "requestId": "3", "requestData": {"inputName": "Mic/Aux", "inputMuted": true}}}(Mute Audio Input)
Integration Examples (assuming device name "OBS_MAIN"):
Via HTTP GET:
Due to the WebSocket nature and JSON-RPC structure, direct HTTP GET for arbitrary commands is not directly supported. It is recommended to use the Fantago UI actions or TCP/UDP listeners.
Via TCP/UDP Listener:
OBS_MAIN:{"op": 6, "d": {"requestType": "SetCurrentProgramScene", "requestId": "1", "requestData": {"sceneName": "MyScene"}}}
The requestId is arbitrary but should be unique per request. The handler internally manages this for actions triggered via Fantago.
Remember to URL-encode the JSON string for HTTP GET requests (if attempting, not recommended).
OBS Studio control — frequently asked questions
Does Fantago support OBS Studio?
Yes. Fantago includes a ready-made OBS Studio (WS v5) handler (version 1.0.0) that talks to the device over TCP, default port 4455. It is bundled with every licence and with the 60-day free trial — there is no per-device fee.
What protocol does the OBS Studio handler use?
TCP, default port 4455. Fantago connects straight to the device over your production network, so no gateway, middleware or vendor software is needed in between.
Can I control OBS Studio from a Stream Deck?
Yes. Every OBS Studio action can be mapped to an Elgato Stream Deck key, to a button on a custom Fantago touch panel, to a timed schedule, or to a logic flow triggered by another device — including devices from a different manufacturer.
Can I modify the OBS Studio handler?
Yes. The handler is a plain JavaScript file (obs_studio.js) that you can download from this page, edit and drop back into Fantago. You can also write your own handler from scratch — see the Developer Guide.
Control OBS Studio from a single interface
Fantago drives OBS Studio alongside 50+ other broadcast, lighting, audio and smart home devices — from custom touch panels, an Elgato Stream Deck, a schedule or a logic flow. One-time licence, no subscription, runs offline.