The OBS Studio connection allows you to directly interact with your instance of OBS Studio to perform changes to scenes and sources. To enable this, you must do the following:
- Start OBS Studio and navigate to Tools -> Websocket server settings, ensure "Enable Websocket server" is checked. You may optionally change the server port and password, but not required.
- If you changed your server port or you enabled authentication and set a password, you must update those values in Mix It Up in the two text boxes as well.
- Click on the "Connect" button.
If you are able to connect successfully, you should see a Windows notification appear stating the connection was successful. You'll be able to interact with it using Streaming Software Actions
When launching Mix It Up, if OBS Studio is not already running, it will fail to connect as expected. However, Mix It Up will automatically attempt to connect the next time any interaction is attempted with OBS Studio, such as via the Streaming Software Actions.
¶ Common Troubleshooting Steps
In the rare case you experience issues connecting the OBS Studio service, start by checking the following troubleshooting steps:
¶ OBS Studio Connection Failed
If you get an error message saying "Failed to connect to OBS Studio web socket" in Mix It Up, it usually means you missed a step.
-
Start by checking that you have enabled the WebSocket server in Tools -> WebSockets Server Settings
-
Ensure the port number is the same in both Mix It Up and in Websocket Server Settings.
-
If you enabled authentication, make sure the password in both Mix It Up and websocket server settings match. If you forgot your password, change it and then update it in Mix It Up and try connecting the service.
¶ Websocket Server Settings Missing (OBS STUDIO Version 27 or lower)
The following is only applicable for OBS Studio version 27 or lower. Starting with Version 28 onward, websocket functionality is already included in OBS Studio by default. You DO NOT have to follow these steps
When installing the websocket, most users will be able to use the installer that is packaged alongside Mix It Up. However, if you have OBS Studio installed in a non-standard location, the installer will not be able to put the web socket plugin correctly into your OBS Studio installation. After running the installer and restarting OBS Studio, if you do not see a option titled "Websocket server settings" under the Tools menu, then the web socket plugin was not correctly installed. If that occurs, you will need to do a manual installation by downloading the latest ZIP file of the web socket plugin and un-zip it into your OBS Studio installation folder. The installation instructions alongside the downloadable ZIP file can be found in the followin link: https://github.com/obsproject/obs-websocket/releases/latest
If you are still having issues installing websocket, please join the OBS Studio Discord server and get in touch with one of their support members. https://discord.com/invite/obsproject