obsws-python/README.md

obs_sdk

A Python SDK for OBS Studio WebSocket v5.0

This is a wrapper around OBS Websocket. Not all endpoints in the official documentation are implemented. But all endpoints in the Requests section is implemented. You can find the relevant document using below link. obs-websocket github page

Requirements

• OBS Studio
• OBS Websocket v5 Plugin
• Python 3.11 or greater

How to install using pip

pip install obsstudio-sdk

How to Use

• Load connection info from toml config. A valid config.toml might look like this:

[connection]
host = "localhost"
port = 4455
password = "mystrongpass"

It should be placed next to your __main__.py file.

Otherwise:

• Import and start using Parameters are as follows: host: obs websocket server port: port to access server password: obs websocket server password

Example __main__.py

from obsstudio_sdk.reqs import ReqClient

# pass conn info if not in config.toml
cl = ReqClient('localhost', 4455, 'mystrongpass')

# Toggle the mute state of your Mic input
cl.toggle_input_mute('Mic/Aux')