Skip to main content

Python asyncio implementation of the MoQT protocol

Project description

aiomoqt - Media over QUIC Transport (MoQT)

aiomoqt is an implementaion of the MoQT protocol, based on aioquic and asyncio.

Overview

This package aims to faithfully implement the MoQT Specification (currently draft-08). It is desinged and intended to satisfy a variety of use-cases to operate as a test tool, faciliate education, and adoption of the protocol. It is also designed to support a variety of production use cases (TBD).

Featurtes

  • A session protocol class maintaining an MoQT message registry for control message types.
  • Serialization and deserialization of messages and data streams.
  • An extensible API allowing custom handlers for responses and incoming messages.
  • Support for both asynchronous and synchronous calls using the wait_response flag.

🚀 Status: Alpha

Installation

Install using pip:

pip install aiomoqt

Or using uv:

uv pip install aiomoqt

Usage

Basic Client Example

import asyncio
from aiomoqt.client import MOQTClientSession

async def main():
    client = MOQTClientSession(host='localhost', port=4433)
    async with client.connect() as session:
        response = await session.initialize()
        response = await session.subscribe('namespace', 'track_name', wait_response=True)
        await session._moqt_session_close

asyncio.run(main())

see aiomoqt-python/aiomoqt/examples for more additional examples

Development

To set up a development environment:

git clone https://github.com/gmarzot/aiomoqt-python.git
cd aiomoqt-python
./bootstrap_python.sh
source .venv/bin/activate
uv pip install .

Contributing

Contributions are welcome! If you'd like to contribute, please:

  • Fork the repository on GitHub.
  • Create a new branch for your feature or bug fix.
  • Submit a pull request with a clear description of your changes.

For major changes, please open an issue first to discuss your proposal.

Resources


Acknowledgements

This project takes inspiration from, and has benefited from the great work done by the Meta/moxygen team, and the efforts of the MOQ IETF WG.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aiomoqt-0.2.3.tar.gz (29.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aiomoqt-0.2.3-py3-none-any.whl (33.5 kB view details)

Uploaded Python 3

File details

Details for the file aiomoqt-0.2.3.tar.gz.

File metadata

  • Download URL: aiomoqt-0.2.3.tar.gz
  • Upload date:
  • Size: 29.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.16

File hashes

Hashes for aiomoqt-0.2.3.tar.gz
Algorithm Hash digest
SHA256 0b26787e0ae56d25aeb01bb8b16633db317a833db3a0f04df89c46907aef8ebb
MD5 869a62f464e61e8ef2fd301fb69908a8
BLAKE2b-256 9e3e50d80c4a67785f19620830816e83bc473019e090ca0dcbcf88177c755684

See more details on using hashes here.

File details

Details for the file aiomoqt-0.2.3-py3-none-any.whl.

File metadata

  • Download URL: aiomoqt-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 33.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.16

File hashes

Hashes for aiomoqt-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 82e49be5f08643037d35216e4b39027376720d8362b385373fc2bc655bd94268
MD5 60d6ac01e9c648ec07d631740deca5f4
BLAKE2b-256 daa19a25eaa61b05373467e9607001516e20ff23e8be84cb9a72a339d0e3fc5e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page