matterbridge 0.0.1

No project description provided

matterbridge

Pythonic API for creating a Matter bridge, registering devices/endpoints, and processing events.

Requirements

• Python 3.8+ (abi3)
• zeroconf runtime dependency (required for mDNS)

Installation

pip install matterbridge

Quick start

from matterbridge import Bridge, DeviceConfigBuilder, EndpointPreset, device_type, cluster

bridge = Bridge("/tmp/matterbridge-py")

endpoint = EndpointPreset(device_type("on_off_light"))
endpoint.cluster_list([cluster("on_off")])
endpoint.node_label("light-1")

cfg = DeviceConfigBuilder("light-1")
cfg.vendor_name("Bridge")
cfg.product_name("On/Off Light")
cfg.serial_number("LIGHT-0001")
cfg.endpoint(endpoint)

dev = bridge.add_device(cfg.build())

if not bridge.is_commissioned():
    info = bridge.open_commissioning_window_qr()
    if info is not None:
        print(info["qr_code_text"])
        print(info["qr_code"])

events, _runner = bridge.start()

while True:
    evt = events.recv_timeout(100)
    if evt is not None:
        print(evt)

Threading notes

• EventStream is a single-consumer stream; avoid reading from multiple threads at once.
• All other binding APIs are thread-safe; operations are marshaled to a single worker thread.