OBS Integration

OBS Integration switches scenes, shows and hides sources, writes into a Text source, and exposes those steps on Button Box.

Zip: obs-integration.zip

Third-party requirements

You need OBS Studio 28 or newer with Tools → WebSocket Server Settings enabled. The protocol is 5.x. Note the port. The default is 4455. Note the password.

Use Direct mode if GRiMbot runs on the same PC as OBS.

Use Streaming PC agent mode if GRiMbot runs anywhere else. That is the same PC Agent used for Streamer.bot. STREAMERBOT_AGENT_TOKEN must be set on the bot.

Setup

Enable the WebSocket server in OBS.

Install the plugin. Open OBS → OBS Settings. Tick Integration enabled.

Pick Direct or Streaming PC agent. Host is 127.0.0.1 for Direct. Enter the port and password from OBS.

Click Save. Then click Test Connection. A failed test is almost always the WebSocket server off or a wrong password.

Windows

OBS Control switches scenes and sources by hand.

OBS On-Stream Text writes into a Text source you already created in OBS. Type a message. Click Show or Show for N seconds. Set text only changes wording without revealing the source. Refresh sources if the list is empty.

Button Box actions include Switch scene, Show source, and Hide source.

What this is not

This plugin does not replace Overlay Browser. Overlays remain Browser Sources. OBS Integration controls OBS. It does not draw GRiMbot HTML.