Skip to content

Set up OBS control in Mastery HQ

Outcome: Mastery HQ connected to OBS Studio — scene switching, mic mute, and stream/record control from a strip inside the app, plus an automatic privacy scene that protects surfaces text-redaction can’t. Time: ~3 minutes. Needs: OBS Studio 28 or newer on the same PC.

Part 1 — turn on OBS’s WebSocket server

Section titled “Part 1 — turn on OBS’s WebSocket server”
  1. In OBS: Tools → WebSocket Server Settings.
  2. Check Enable WebSocket server.
  3. Keep Enable Authentication checked; click Show Connect Info and copy the Server Password. (Port stays 4455.)
  4. OK.
  1. Settings → Streaming, scroll to OBS Studio.
  2. Host 127.0.0.1 and port 4455 are prefilled; paste the password.
  3. Click Connect → the status shows Connected ✓ · N scenes.
  4. Leave Auto-connect when going live on — every future stream connects itself.
  1. In OBS, create a scene named e.g. Privacy (add a BRB image or a solid color).
  2. In Settings → Streaming → Privacy scene, pick it and keep Jump to privacy scene when a sensitive pane opens on.
  3. Test: enter Streaming Mode, open Settings → Agents — OBS switches to Privacy; close it — OBS switches back.

In Streaming Mode while connected, the strip sits above the command bar:

Control Does
Scene dropdown Switches OBS’s program scene (mirrors changes made in OBS too)
Mic button(s) Mute/unmute each mic — red when muted
Go Live / LIVE Start/stop the stream (state mirrored from OBS)
Record / REC Start/stop recording

Enable the server in OBS once → paste the password once → from then on, entering Streaming Mode connects automatically and the strip is your booth. Streamlabs user instead? Streamlabs setup (P2 doc).