How To Connect Boatswain to OBS Studio

I’ve recently got myself an Elgato Stream Deck, and although it doesn’t natively support Linux, there’s a nice app called Boatswain that does the trick (not to be confused with the OCI container monitoring app of the same name).

I tried to connect Boatswain to my Flatpak-installed version of OBS Studio (of which I’ve already talked in a previous article) to simplify its use, and I discovered that the latest versions of OBS Studio use a WebSocket 5-based API, while unfortunately Boatswain only speaks the old OBS Studio API based on WebSocket 4.

The solution consists in installing an older version of the obs-websocket plugin, which thankfully in Flatpak is just a simple command away:

$ flatpak install com.obsproject.Studio.Plugin.WebSocket

Once this is done, just customize your buttons on Boatswain, adding as many OBS-related tasks as you’d like (to start and stop recording or streaming, to switch scenes, or even to mute your audio input) and have fun!