python

dvb-si-py

Python bindings for dvb-si — parse DVB SI/PSI sections and demux MPEG-TS into Python dicts. Read-only by design (parse → serde_json → Python objects), which is exactly what broadcast-ops scripting (pcap-to-report, capture triage) needs.

Built with PyO3 + maturin; ships as an abi3 wheel (one wheel for CPython ≥ 3.9). Not part of the Rust workspace — it consumes the published dvb-si / dvb-t2mi crates by version.

Install

$ pip install dvb-si-py

Usage

import dvb_si_py as dvb

# Parse a single SI/PSI section (table) from raw bytes → dict.
section = dvb.parse_section(section_bytes)
print(section["tableId"], section)

# Demux: feed aligned 188-byte TS packets, get the dicts of changed sections.
dm = dvb.Demux()
with open("capture.ts", "rb") as f:
    data = f.read()
for i in range(0, len(data) - 188, 188):
    for sec in dm.feed(data[i:i + 188]):
        print(sec)            # e.g. {"PatSection": {...}}, {"SdtSection": {...}}

# T2-MI: pump payloads off a PID.
t2 = dvb.T2miDemux(0x0040)
for i in range(0, len(data) - 188, 188):
    for payload in t2.feed(data[i:i + 188]):
        print(payload)

Keys mirror the Rust API (camelCase). The binding is read-only: it parses, it does not build/serialize wire bytes — use the Rust crates for that.

Changes

0.3.0

• Rebuilt against dvb-si 12 / dvb-t2mi 12 (typed mpeg_ts::pid::Pid, mpeg-ts 0.6, broadcast-common 10).
• Additive dict keys (the dvb-si 12 serde schema growth, e.g. reserved_future_use* fields on application-signalling entries and the typed extension descriptor bodies such as supplementaryAudio); no existing key was removed or renamed on the PAT/PMT fixture check.
• T2miDemux(pid) now validates the PID as a 13-bit value and raises ValueError for pid > 0x1FFF (previously accepted any u16).

Build from source

$ pip install maturin
$ maturin develop          # build + install into the active virtualenv
$ maturin build --release  # build a wheel

Licence

MIT OR Apache-2.0.