Skip to content
CornetaPortuguês

Help center · Help

How to connect and set up OBS automatically

Turn on the WebSocket server in OBS and click Set it up for me on the Live screen. Corneta connects, switches the OBS service to the local address and confirms when both are ready.

Published
Reading time
3 min read
Corneta version
0.11.0
Tested with
Corneta 0.6.0 (Windows 11), OBS Studio 32.x (WebSocket v5)

The expected result

At the end of this step, the Live screen shows OBS as set up and pointing at Corneta. That doesn't put any video on air yet: it only prepares the way for Corneta to tell OBS to stream when you hit GO LIVE.

Before you click

  • open OBS Studio before Corneta;
  • use OBS Studio 28 or newer, which already ships with the WebSocket;
  • close any other app that might be changing your streaming settings;
  • if the WebSocket asks for a password, have that password at hand.

Set it up in three steps

  1. In OBS, open Tools → WebSocket Server Settings.
  2. Check Enable WebSocket server and keep port 4455. Corneta's automatic integration uses that port on the same computer. If it's taken, resolve the conflict or use the manual setup below.
  3. In Corneta, open Live → Hook up OBS and click Set it up for me.

If Enable Authentication is on in OBS, click Show Connect Info and paste the password Corneta asks for. This is the WebSocket password, not a platform's stream key.

Enlarge image

Fit
Hook up OBS panel with the local server, the local key and the connection status.

Once it shows as set up, OBS is already pointing at Corneta.

Once it shows as set up, OBS is already pointing at Corneta.Source: CornetaCorneta version: 0.11.0

When the status changes to Set up, Corneta has already switched the OBS service to Custom... and put the local server and key in the right fields.

If Corneta suggests adjusting the video

Starting with 0.9.0, the wizard shows OBS video right below Set up. It compares the resolution, the FPS and, in OBS's simple output mode, the bitrate with what the destinations receiving the copy accept without re-encoding.

  • If OBS sends more than any of those destinations accepts, click Adjust OBS. Corneta only lowers values, keeps the screen's aspect ratio and saves the previous settings before changing anything.
  • Undo puts OBS back the way it was before Corneta's first adjustment.
  • In advanced output mode, Corneta can't reach the bitrate setting. The warning tells you the maximum so you can check it under Settings → Output in OBS.
  • OBS only lets you change the video while streaming and recording are both stopped. Stop both in OBS and try again.

If it doesn't connect

What showed upLikely causeHow to confirmWhat to do
Couldn't find OBS to connect toOBS closed, WebSocket off, a port other than 4455 or a firewall blocking itOpen the OBS window and go back to the Tools menuTurn on the WebSocket server and try again
That WebSocket password didn't matchA password different from the one OBS shows, or Corneta has no password when OBS asks for oneClick Show Connect Info in OBSCopy the current password and paste it into Corneta
Couldn't set OBS up on my ownThe connection dropped midway or OBS refused the settings changeLook at the technical detail in the same windowTry again or use plan B below
Not pointing here yet in Hook up OBSControl works, but the streaming service wasn't switchedOpen Settings → Stream in OBSClick Set it up for me again
The ingest server crashedAnother program is using the local port that receives the video from OBSClose other streaming apps or RTMP servers and try againClose that program or change the port under Settings → OBS → Advanced and click Set it up for me

Plan B: set it up by hand

Open Hook up OBS, choose I'd rather set it up by hand and copy the Server and Stream key fields. In OBS, go to Settings → Stream, choose Service: Custom... and paste both.

Without the WebSocket, Corneta can't hit play in OBS on its own. After GO LIVE, click Start Streaming in OBS.

All set here? Continue with your first stream.