proto4webrtc (Python)

Typed mediasoup producer runtime (pymediasoup) for code generated from protobuf messages annotated with proto4webrtc options. The TypeScript consumer counterpart is the npm package protoc-gen-proto4webrtc-ts.

pip install proto4webrtc              # runtime only (ship this)
pip install proto4webrtc[compiler]    # + the code generator (build time)
python -m proto4webrtc_codegen --proto path/to/protos --out out/

from proto4webrtc_gen import Proto4WebrtcProducer, Telemetry

client = Proto4WebrtcProducer(signaling_url="ws://localhost:3000/api/sfu")
client.run_forever()  # blocking: connects, reconnects on drop, until stop()

client.telemetry.send(Telemetry(stamp=time.time(), value0=0.4))

Proto4WebrtcProducer owns the whole client — signaling, device/transport setup, and the reconnect loop. send()/push() are safe to call from any thread, anytime (a no-op before the first connection).

Streams declared lazy are produced only while a consumer keeps pinging "<label>-pings"; the runtime starts and stops them for you. Test client.<stream>.producing to skip the work behind a message while nobody is watching.

The generator lives in the separate distribution proto4webrtc-codegen (pulled in by the [compiler] extra), so production images can install the runtime alone.

Full docs: https://github.com/Emil1483/proto4webrtc