obs-websocket-py
Python library to communicate with an obs-websocket server.
Decision gist · record as of 2026-08-14
Yes, if you need to control OBS Studio from Python. The package is stable (v1.0, MIT licensed, no known vulnerabilities) and has low install friction. However, maintenance is dormant—the last release was 2023-02-20—so if OBS Studio introduces breaking protocol changes, you may need to fork or wait for community updates. For active OBS automation projects, this is a solid choice; for long-term production systems, monitor the repository for compatibility.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a running OBS Studio instance with obs-websocket server enabled on the specified host and port (default 4455 for v5 API, 4444 for legacy v4 API).
- Low friction install with a single runtime dependency (websocket-client).
- Maintenance is dormant—last release was 2023-02-20, but the repository remains active with a commit on 2024-08-09, suggesting occasional updates without formal releases.
License · maintenance · safety
MIT (permissive) — Licensed under MIT (permissive), so you can use, modify, and distribute this package freely with minimal restrictions, provided you retain the license notice.
last release 2023-02-20 (1271 days) · last repo commit 2024-08-09 · 275 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 98,351 downloads/mo, #13,090 on PyPI
Alternatives
Verify before relying
pip install obs-websocket-py
from obswebsocket import obsws, requests
client = obsws("localhost", 4455, "secret")
client.connect()
version = client.call(requests.GetVersion()).getObsVersion()
client.disconnect()- Whether the package supports OBS Studio versions released after 2023-02-20 without manual updates.
- Compatibility with Python 3.11+ (classifiers list only up to 3.10).
What it is and what it does
obs-websocket-py is a Python client library that communicates with OBS Studio's obs-websocket server over WebSocket, allowing you to send commands and receive events from OBS remotely. It supports both the modern v5 protocol (default port 4455) and the legacy v4 protocol (default port 4444). You instantiate a client with a host, port, and optional password, call connect(), then use the call() method to send requests and receive responses, or register callback functions to listen for OBS events.
The package depends only on websocket-client for the underlying WebSocket communication. It's designed for developers who want to automate OBS—controlling scenes, sources, recordings, and streaming—from Python scripts or applications. The library handles connection lifecycle, authentication, and event dispatch, with support for both synchronous request-response calls and asynchronous event callbacks.
Use it for
- Automate OBS scene switching and source control from a Python application or bot.
- Build a custom control panel or dashboard that monitors and manages OBS streaming state.
- Create event-driven workflows that trigger actions in other tools when OBS events occur.
- Integrate OBS control into a larger broadcast or recording automation system.
- Write integration tests or monitoring scripts that verify OBS configuration and state.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to control OBS Studio from Python.
The package is stable (v1.0, MIT licensed, no known vulnerabilities) and has low install friction. However, maintenance is dormant—the last release was 2023-02-20—so if OBS Studio introduces breaking protocol changes, you may need to fork or wait for community updates. For active OBS automation projects, this is a solid choice; for long-term production systems, monitor the repository for compatibility.
Install
obs-websocket-py on PyPI
Before you install
Low friction install with a single runtime dependency (websocket-client). Maintenance is dormant—last release was 2023-02-20, but the repository remains active with a commit on 2024-08-09, suggesting occasional updates without formal releases.
Requires a running OBS Studio instance with obs-websocket server enabled on the specified host and port (default 4455 for v5 API, 4444 for legacy v4 API).
License in practice
Licensed under MIT (permissive), so you can use, modify, and distribute this package freely with minimal restrictions, provided you retain the license notice.
Quickstart
pip install obs-websocket-py
from obswebsocket import obsws, requests
client = obsws("localhost", 4455, "secret")
client.connect()
version = client.call(requests.GetVersion()).getObsVersion()
client.disconnect()Verify before relying
- Whether the package supports OBS Studio versions released after 2023-02-20 without manual updates.
- Compatibility with Python 3.11+ (classifiers list only up to 3.10).
Package facts
| License | MIT permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagewebsocket-client |
| Maintenance | Dormant 1,271 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 98,351 / month, #13,090 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: PluginsIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Libraries |
Evidence: obs_websocket_py-1.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “obs studio websocket client”
- obs-websocket-pyConnects Python applications to OBS Studio via the obs-websocket…
- esdk-obs-pythonPython SDK for interacting with Huawei OBS (Object Storage Service),…
- lmstudioPython SDK for interacting with LM Studio, a local LLM application,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also websocket-client · observable · esdk-obs-python · ws4py · Pysher · sonos-websocket · python-engineio · signalrcore · TikTokLive · kanboard