Skip to content

Connect your OBS to the dashboard

By the end, the OBS at your house will show up as Connected in the dashboard and you’ll be able to drive it from your phone while you’re out on the street.

You need: a plan that includes connecting your OBS (Stream Key yes; Stream Key Lite no) · OBS open on your computer · 5 minutes

The Connect OBS tab with the steps, the password mode and the connection link

  1. In the dashboard, open Stream Keys and hit Local OBS on the key you’re going to use. You land on the Connect OBS tab.
  2. In your OBS: Tools → WebSocket Server Settings and enable it. Keep that window handy.
  3. Back in the dashboard, go to Authentication mode and pick one of the three modes (table below). Hit Save: you’ll see Credentials saved.
  4. If you chose Generated, copy the Generated password (paste it into your OBS) and paste it into the password field in Tools → WebSocket Server Settings. Apply the changes in OBS.
  5. Hit Generate connect link and copy it right there and then. The dashboard warns you: “Copy it now: for security it’s only shown once.”
  6. In your OBS, go to Docks → Custom Browser Docks, create a new one, give it whatever name you like and paste the link into the URL field. Accept.
  7. The dock opens inside OBS and shows Conectado ✓. In the dashboard, the header switches to Connected and the final step says Connected! with the Go to control button.
  8. Leave that dock open while you stream.
Mode When to use it What you do
Generated (Recommended) The normal case We give you a password and you paste it into your OBS
Your own You already had a password set in OBS and don’t want to touch it You type it into Your OBS password
No password Your WebSocket server doesn’t require a password Nothing beyond saving it

The mode in the dashboard and the one in your OBS have to match. If you change the password in OBS, come back to the dashboard and save it again.

In the header of the Local OBS page you have the status badge: Connected or Disconnected. Inside Connect OBS, the Local OBS status card separates two different things:

  • Paired with this dashboard — a valid connect link has been generated.
  • Connected — the dock is open and talking to the dashboard right now.

You can be paired and disconnected at the same time: it means the link exists but the dock isn’t open. That’s when you’ll see Waiting for your OBS to connect…

  • Regenerate link: creates a new one and the old one stops working. This is what you do if you lost the link, because it’s never shown again.
  • Revoke: “The current link will stop working and your OBS will disconnect. You’ll need to generate a new one.” Use it if you left the link on a PC you no longer control.

After regenerating, remember to edit the dock in OBS with the new link: the old one keeps trying to reconnect forever.

The dashboard says “Waiting for your OBS to connect…” and never moves on. The dock isn’t reaching the dashboard. Check that you pasted the whole link and that the password in the dashboard is the same one as in your OBS.

The dock shows a red warning: “No se pudo conectar con OBS… Comprueba que OBS está abierto y que obs-websocket está activado.” Your OBS WebSocket server is off, or OBS wasn’t open when the dock started. Enable it in Tools → WebSocket Server Settings and reload the dock.

“There’s an active link. Regenerate it if you need a new one (the old one will stop working).” You already generated one and didn’t copy it. Hit Regenerate link and copy it this time.

“Local OBS is not included in your plan.” Your plan doesn’t come with this. Change it from Billing.