Skip to main content

dmxcontrol3-network-interface

Generated gRPC/protobuf client library for DMXControl 3, plus Python ports of the helpers from the C# LumosProtobuf library.

pip install dmxcontrol3-network-interface

The import package is dmxc_protobuf:

import grpc
from dmxc_protobuf.Client import AudioClient_pb2_grpc

channel = grpc.insecure_channel("localhost:50051")
stub = AudioClient_pb2_grpc.AudioClientStub(channel)

Helpers

Module Contents
dmxc_protobuf.connection UmbraConnectionClient (login/logoff, mandatory ping, broadcasts, client control requests, client change events, discovery handling), ConnectionClientData protocol, create_umbra_channel, LoginException
dmxc_protobuf.udp UmbraDiscoveryClient (multicast discovery of Umbra servers), UdpListener, get_local_ipv4_addresses
dmxc_protobuf.net_constants Ports, the multicast address and message size limits
dmxc_protobuf.i18n translatable / _ to build TranslateableData
dmxc_protobuf.extensions Helpers for generated messages: translateable_to_formatted_string, object_data_to_object_simple, project_version_id_from_string, merge_todos, color_is_white, ...
dmxc_protobuf.tools contains_non_ascii_characters

The connection client uses grpc.aio. Event handlers are added with += and may be plain or async functions:

import asyncio
from dmxc_protobuf.connection import UmbraConnectionClient, create_umbra_channel
from dmxc_protobuf.Common.Types.UmbraServiceTypes_pb2 import ClientInfo, ClientProgramInfo, ReadyToWorkState


class Data:
    def __init__(self):
        self.umbra_channel = create_umbra_channel("127.0.0.1")
        self.host_metadata = []  # metadata sent with every call
        self.client_program_info = ClientProgramInfo(clientInfo=ClientInfo(clientname="My Tool"))
        self.clientname = "My Tool"
        self.network_id = ""

    def create_channel(self, host, port):
        return create_umbra_channel(host, port)


async def main():
    client = UmbraConnectionClient(Data())
    client.broadcast_received += lambda args: print("broadcast", args.message)
    await client.connect()
    await client.report_ready_to_work(ReadyToWorkState(readyToWork=True))
    ...
    await client.disconnect()


asyncio.run(main())

get_local_ipv4_addresses lists every interface if the optional ifaddr package is installed; without it, it falls back to the host name lookup and the default route.

Metadata

Release files for dmxcontrol3-network-interface 3.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dmxcontrol3-network-interface 3.3.3
File Size Uploaded Provenance Actions
dmxcontrol3_network_interface-3.3.3.tar.gz 220.0 kB With provenance Details for dmxcontrol3_network_interface-3.3.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dmxcontrol3-network-interface 3.3.3
File Interpreter ABI Platform Actions
dmxcontrol3_network_interface-3.3.3-py3-none-any.whl Python 3 none any Details for dmxcontrol3_network_interface-3.3.3-py3-none-any.whl

Total release size: 718.9 kB

Release files / dmxcontrol3_network_interface-3.3.3.tar.gz

Download URL dmxcontrol3_network_interface-3.3.3.tar.gz
Size 220.0 kB
Tags Source
SHA-256 checksum
How to use checksums
2077a1f6dd27556a54e5c6c601824cfd6fda1b54d2a026f083deaaa2b700048a
BLAKE2b-256 checksum
How to use checksums
d358e7650ada873032a1b6db59ee63d07ac73740af34b9091f4a8f874374a999
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / dmxcontrol3_network_interface-3.3.3-py3-none-any.whl

Download URL dmxcontrol3_network_interface-3.3.3-py3-none-any.whl
Size 498.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a966f5736c6c85d9c1cf34c0c47e5ce60fdc8722093b24b2f4006603561e0b34
BLAKE2b-256 checksum
How to use checksums
ec0292cc6619d7c290f5081bf64cc074a45eb40f4e23e55e104369c0258ee5d9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for dmxcontrol3-network-interface 3.3.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for dmxcontrol3_network_interface-3.3.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.3.3 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page