ptp-monitor

GitHub stars Last commit true true

Overview

Desktop tool (Qt / PySide6) for passively listening to PTP clock traffic on a production audio-over-IP network — to detect problems and record evidence for vendor support cases.

100% passive: it joins the standard PTP multicast group 224.0.1.129 (UDP 319/320) and listens. It never sends a single PTP packet and cannot disturb the clock election or timing of the network.

Features

  • Dante leader (PTPv1) — who sends Sync, sync interval, jitter (mean/min/max/σ), leader change history
  • AES67 grandmaster (PTPv2) — clock identity, priorities, clock class, steps removed, announce timing
  • Per-source stats — message types, rates, sequence gaps/dupes, silence detection, non-standard PTP domains
  • Malformed packets — unparsable datagrams logged with source IP and full hexdump
  • Evidence logs — chronological JSONL journal + optional full packet capture
  • Network-agnostic — no hard-coded addresses; friendly device names via devices.json, reverse DNS and the IEEE OUI database

Links

The UI is currently in French — i18n contributions are welcome.