A web client and frontend made by t2t2 (compatible with tablets and other touch interfaces) is available here : http://t2t2.github.io/obs-tablet-remote/

It is highly recommended to protect obs-websocket with a password against unauthorized control. To do this, open the "Websocket server settings" dialog under OBS' "Tools" menu. In the settings dialogs, you can enable or disable authentication and set a password for it.

Possible use cases

Remote control OBS from a phone or tablet on the same local network
Change your stream overlay/graphics based on the current scene
Automate scene switching with a third-party program (e.g. : auto-pilot, foot pedal, ...)

For developers

The server is a typical Websockets server running by default on port 4444 (the port number can be changed in the Settings dialog). The protocol understood by the server is documented in PROTOCOL.md.

Here's a list of available language APIs for obs-websocket :

Javascript (browser & nodejs): obs-websocket-js by Brendan Hagan
C#/VB.NET: obs-websocket-dotnet
Python 2 and 3: obs-websocket-py by Guillaume Genty a.k.a Elektordi
Python 3.5+ with asyncio: obs-ws-rc by Kirill Mysnik
Python 3.6+ with asyncio: simpleobsws by tt2468
Java 8+: obs-websocket-java by TwasiNET
Golang: go-obs-websocket by Chris de Graaf
HTTP API: obs-websocket-http by tt2468

I'd like to know what you're building with or for obs-websocket. If you do something in this fashion, feel free to drop me an email at stephane /dot/ lepin /at/ gmail /dot/ com !

Compiling obs-websocket

See the build instructions.

Contributing

See the contributing document

Translations

Your help is welcome on translations.

Please join the localization project on Crowdin

Special thanks

In (almost) order of appearance:

Brendan H.: Code contributions and gooder English in the Protocol specification
Mikhail Swift: Code contributions
Tobias Frahmer: Initial German localization
Genture: Initial Simplified Chinese and Traditional Chinese localizations
Larissa Gabilan: Initial Portuguese localization
Andy Asquelt: Initial Polish localization
Marcel Haazen: Initial Dutch localization
Peter Antonvich: Code contributions
yinzara: Code contributions
Chris Angelico: Code contributions
Guillaume "Elektordi" Genty: Code contributions
Marwin M: Code contributions
Logan S.: Code contributions
RainbowEK: Code contributions
RytoEX: CI script and code contributions
Theodore Stoddard: Code contributions
Philip Loche: Code contributions
Patrick Heyer: Code contributions and CI fixes
Alex Van Camp: Code contributions
Freddie Meyer: Code contributions
Casey Muller: CI fixes
Chris Angelico: Documentation fixes

And also: special thanks to supporters of the project!

Supporters

They have contributed financially to the project and made possible the addition of several features into obs-websocket. Many thanks to them!

Support Class designs and develops professional livestreams, with services ranging from broadcast graphics design and integration to event organization, along many other skills.

MediaUnit is a Norwegian media company developing products and services for the media industry, primarly focused on web and events.