WebSocket API for OBS Studio.
Binaries for Windows, MacOS, and Linux are available in the Releases section.
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.
(Psst. You can use --websocket_port(value), --websocket_password(value), and --websocket_debug(flag) on the command line to override the configured values.)
- 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, ...)
- (No known clients supporting 5.0.0 at the moment. Ping us in the Discord if you have one!)
Here's a list of available language APIs for obs-websocket:
- Python 3.7+ (Asyncio): simpleobsws by IRLToolkit
- Rust: obws by dnaka91
- Godot 3.4.x: obs-websocket-gd by you-win
- Javascript (Node and web): obs-websocket-js by OBS Websocket Community
The 5.x server is a typical WebSocket server running by default on port 4455 (the port number can be changed in the Settings dialog under Tools).
The protocol we use is documented in PROTOCOL.md.
We'd like to know what you're building with obs-websocket! If you do something in this fashion, feel free to drop a message in #project-showoff in the discord server!
This project exists thanks to all the people who contribute. Contribute.
Become a financial contributor and help us sustain our community. Contribute
Support this project with your organization. Your logo will show up here with a link to your website. Contribute
