Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pollen-robotics/gst-signalling-py

Python implementation of the Gstreamer signalling
https://github.com/pollen-robotics/gst-signalling-py

Last synced: 3 months ago
JSON representation

Python implementation of the Gstreamer signalling

Host: GitHub
URL: https://github.com/pollen-robotics/gst-signalling-py
Owner: pollen-robotics
License: apache-2.0
Created: 2023-08-30T13:05:40.000Z (over 1 year ago)
Default Branch: develop
Last Pushed: 2024-10-16T13:42:53.000Z (3 months ago)
Last Synced: 2024-10-18T13:45:56.302Z (3 months ago)
Language: Python
Size: 130 KB
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # gst-signalling-py: Gstreamer WebRTC signalling in Python

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) ![linter](https://github.com/pollen-robotics/reachy2-sdk/actions/workflows/lint.yml/badge.svg) ![pytest](https://github.com/pollen-robotics/reachy2-sdk/actions/workflows/unit_tests.yml/badge.svg) ![coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/FabienDanieau/17eb617c2e60c2dc189478dd3be6e323/raw/covbadge.json)

This repository provides a Python implementation of the [Gstreamer WebRTC signalling](https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/-/tree/main/net/webrtc) protocol. 

It provides an API close to the gstreamer API with a [producer](./src/gst_signalling/gst_producer.py) and a [consumer](./src/gst_signalling/gst_consumer.py). This allows to simply write producer/consumer examples using gstreamer signalling. It works with single producer and multiple consumers for exchanging data. See the [data producer example](./src/example/datachannel-single-producer-multiple-consumer/) for more details.

It also provides tools to list and monitor the peers connected to a signalling server.

_Note that there is no example of audiovideo streaming. Gstreamer provides [rust plugins](https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs) that directly communicate with a signalling server_

## Installation

Simply install the package using pip:

```bash

pip install -e .

```

## Usage

See the [examples](src/example/) for more details.

## Protocol

### Roles

Gstreamer signalling defines 3 roles (so the WebRTC peers are not symmetrical)

- producer (produces data, video or audio streams)

- consumer (access to a producer stream, can access all or a subset of its streams)

- listener (gets notified by the server of new producers status)

### Protocol sequence diagram

```mermaid

sequenceDiagram

  Server-->>Producer: Welcome (PeerId)

	Server-->>Consumer: Welcome (PeerId)

  Producer->>Server: PeerStatusChanged  # declare yourself as producer

	Consumer->>Server: StartSession # with producer PeerId

	Server-->>Producer: StartSession (SessionId)

	Server-->>Consumer: SessionStarted (SessionId)

	Producer->>Server: Peer (offer sdp)

	Server-->>Consumer: Peer (offer sdp)

	Consumer->>Server: Peer (answer sdp)

	Server-->>Producer: Peer (answer sdp)

```

See [this page](https://pollen-robotics.notion.site/Gstreamer-WebRTC-signaling-8cc2391ef0004ef6b399095ea507121f?pvs=4) for more details.

## Contribute

Please refer to our [template repository](https://github.com/pollen-robotics/python-template) for guidlines and coding style.

Development tools can be installed with

```bash

pip install -e .[dev]

```

### Unit tests

The [gstreamer signalling server](https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs/-/tree/main/net/webrtc/) is required to run on the localhost. Then run

```bash

pytest

```