Skip to main content

mcast-tools

Multicast you can see. Send and receive IPv4 and IPv6 multicast on Linux and Windows, with live dashboards that show loss, duplicates and reordering as they happen, plus hop count and DSCP remarking on Linux receivers.

pipx install mcast-tools    # or: pip install mcast-tools

mcast-receive dashboard: 50 pps from a sender 4 hops away, its DSCP re-marked from EF to AF41 on the path

Why mcast-tools?

iperf can push multicast. mcast-tools shows you what the network did to it:

  • Live dashboards. Status, rate, loss, duplicates, reordering and stalls, updated in real time.
  • Hop count and DSCP remark detection. Every packet carries the TTL and DSCP its sender set, so a Linux receiver shows how far it travelled and whether anything on the path re-marked it.
  • ASM and SSM. Any-source (*,G) and source-specific (S,G) joins, with the IGMPv3/MLDv2 rules enforced and explained.
  • IGMP/MLD version control. Force IGMPv1–3 or MLDv1–2 on an interface for the length of a run, restored on exit (Linux, as root).
  • IPv4 and IPv6, auto-detected. The group decides: 239.0.10.101 is IPv4, ff3e::8000:1 is IPv6. No flags.
  • Script-friendly. --quiet and --json give one-line summaries for automation.

Quick start

No lab needed: two terminals on one machine will do. In the first:

mcast-receive 239.0.10.101

In the second, or on another host:

mcast-send 239.0.10.101

Receiving on Windows? Allow inbound UDP port 19779 in Windows Defender Firewall first, with one PowerShell command.

A few more to try:

# SSM: accept one source only (pin the sender's source to match)
mcast-receive 232.1.1.1 --source 10.1.1.10
mcast-send 232.1.1.1 --source 10.1.1.10

# The same over IPv6, with MLDv2
mcast-receive ff3e::8000:1 --source 2001:db8::5
mcast-send ff3e::8000:1 --source 2001:db8::5

# Mark traffic EF; a Linux receiver flags any remarking along the path
mcast-send 239.0.10.101 --rate 1Mbps --dscp ef --ttl 64

# Which groups is this host joined to? (Linux)
mcast-status

Every command has --help listing all of its options.

The tools

Command What it does
mcast-send Streams multicast at your chosen rate, size, TTL and DSCP
mcast-receive Joins ASM or SSM and runs the live dashboard
mcast-status Lists the host's group memberships (Linux)

Linux and Windows

mcast-send and mcast-receive run natively on both. On Windows 11, mcast-receive is verified with Linux senders over IPv4 and IPv6, ASM and SSM, and mcast-send over IPv4.

Linux-only for now: mcast-status, IGMP/MLD version forcing, hop count and DSCP remark detection on the receiving side, choosing the interface (Windows uses its default one; IPv6 receivers can take an interface index), and sending to link-local IPv6 groups.

Learn more

The guide covers every option, IPv6 scopes and zones, SSM source pinning, the Windows details and what's on the wire.

Python 3.10+. MIT licensed.

Metadata

Release files for mcast-tools 0.2.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 mcast-tools 0.2.3
File Size Uploaded Provenance Actions
mcast_tools-0.2.3.tar.gz 49.9 kB With provenance Details for mcast_tools-0.2.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcast-tools 0.2.3
File Interpreter ABI Platform Actions
mcast_tools-0.2.3-py3-none-any.whl Python 3 none any Details for mcast_tools-0.2.3-py3-none-any.whl

Total release size: 85.6 kB

Release files / mcast_tools-0.2.3.tar.gz

Download URL mcast_tools-0.2.3.tar.gz
Size 49.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b014ebd7cf0de87b8107c04be1640b55ab46d1a6fd58fc0159cdedf4d8a12232
BLAKE2b-256 checksum
How to use checksums
794f78e2a14e74b175d6442971a60ac457ca38815355b51600f82f201d3f6619
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 18, 2026.

Transparency log

Release files / mcast_tools-0.2.3-py3-none-any.whl

Download URL mcast_tools-0.2.3-py3-none-any.whl
Size 35.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a6889a220f81c81d1ad7424577a2fe596e3607cc5b2a8b02760ded2fcf8479d5
BLAKE2b-256 checksum
How to use checksums
21de7afefa92846cda55b3455710dcd982bc5f45306fb4f371166db44bb484d3
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 18, 2026.

Transparency log

Security for mcast-tools 0.2.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 mcast_tools-0.2.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 18, 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.

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