Metadata-Version: 2.4
Name: streamlabsio
Version: 2.0.0
Summary: Get real time Twitch/Youtube events through Streamlabs SocketIO API
License: MIT
License-File: LICENSE
Author: Onyx and Iris
Author-email: code@onyxandiris.online
Requires-Python: >=3.10,<4.0.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: loguru (>=0.7.3,<0.8.0)
Requires-Dist: observable (>=1.0.3,<2.0.0)
Requires-Dist: python-socketio[client] (>=5.16.1,<6.0.0)
Description-Content-Type: text/markdown

[![PyPI version](https://badge.fury.io/py/streamlabsio.svg)](https://badge.fury.io/py/streamlabsio)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/onyx-and-iris/streamlabs-socketio-py/blob/dev/LICENSE)
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

# A Python client for Streamlabs Socket API

For an outline of past/future changes refer to: [CHANGELOG](CHANGELOG.md)

### Requirements

-   A Streamlabs Socket API key.
    -   You can acquire this by logging into your Streamlabs.com dashboard then `Settings->Api Settings->API Tokens`

-   Python 3.10 or greater

### Install

```console
pip install streamlabsio
```

### Use

```python
import streamlabsio


def on_streamlabs_event(event, data):
    print(f'{event}: {data.attrs()}')


def on_twitch_event(event, data):
    if event == 'follow':
        print(f'{data.name} just followed!')


def main():
    with streamlabsio.connect(token="<API token>") as client:
        client.obs.on('streamlabs', on_streamlabs_event)
        client.obs.on('twitch_account', on_twitch_event)

        # run for 30 seconds then disconnect client from server
        client.wait(30)


if __name__ == '__main__':
    main()
```

### Client class
*`streamlabsio.connect(*, token: str, raw: bool = False)  -> Client`*

The following keyword arguments may be passed:

-   token: Streamlabs SocketIO api token.
-   raw: Receive raw data messages as json objects.

#### methods

*wait(self, seconds: float | None = None) -> None*

-   float: Time in seconds to block the main thread
    -   If None, the method will block indefinitely.

### Event Data Attributes

For event data you may inspect the available attributes using `attrs()`.

example:

```python
def on_twitch_event(event, data):
    print(f'{event}: {data.attrs()}')
```

### Errors

-   `SteamlabsSIOError`: Base StreamlabsSIO error class
-   `SteamlabsSIOConnectionError`: Exception raised when connection errors occur

### Logging

To view the logs emitted by the streamlabsio library simply add the following to your code:

```python
from loguru import logger

logger.enable('streamlabsio')
```

### Official Documentation

-   [Streamlabs Socket API](https://dev.streamlabs.com/docs/socket-api)

