Skip to main content

Mesh Network Performance Checker 📡

By DASecure

A TUI app to measure and analyze mesh network performance.

Features

  • ✅ Multi-Node Testing — Test all mesh nodes from one place
  • ✅ Latency & Jitter — Measure response time and stability
  • ✅ Packet Loss Detection — Identify connection issues
  • ✅ Throughput Testing — Optional iperf3 integration
  • ✅ Network Scanning — Auto-discover nodes
  • ✅ Internet Speed Test — Check WAN performance
  • ✅ Historical Results — Track performance over time
  • ✅ Interactive TUI — Easy-to-use interface

Installation

pip install meshchecker
meshchecker

pipx

pipx install meshchecker
meshchecker

From Source

git clone https://github.com/dasecure/meshchecker.git
cd meshchecker
pip install -e .
meshchecker

Quick Start

# Interactive mode (recommended)
meshchecker

# Quick setup
meshchecker --setup

# Run test immediately
meshchecker --test

# Include throughput tests (requires iperf3)
meshchecker --test --throughput

Adding Nodes

Interactive Setup

meshchecker --setup

CLI

# Add a node
meshchecker --add-node "Living Room" 192.168.1.10

# Add main router
meshchecker --add-node "Main Router" 192.168.1.1 --main

Usage

Interactive Menu

meshchecker

Then choose:

  1. Run full test — Tests all nodes + internet speed
  2. Run quick test — Tests nodes only (faster)
  3. Setup nodes — Add/remove nodes
  4. View history — See past results
  5. Exit

Command Line Options

# Run full test
meshchecker --test

# Quick test (no internet speed test)
meshchecker --test --no-internet

# With throughput testing (requires iperf3 on nodes)
meshchecker --test --throughput

# View history
meshchecker --history

Throughput Testing

For throughput tests, install iperf3 on your mesh nodes:

macOS:

brew install iperf3

Linux:

sudo apt install iperf3

Windows: Download from https://iperf.fr/

Then run iperf3 server on each node:

iperf3 -s

Metrics Explained

Metric Good Warning Poor
Latency < 50ms 50-100ms > 100ms
Jitter < 10ms 10-30ms > 30ms
Packet Loss < 1% 1-5% > 5%
Throughput > 50 Mbps 10-50 Mbps < 10 Mbps

Results Storage

Results are saved to:

  • macOS/Linux: ~/.meshchecker/results/
  • Windows: %USERPROFILE%\.meshchecker\results\

Each test creates a JSON file with full details.

Troubleshooting

"No nodes configured" Run meshchecker --setup or add nodes with --add-node

"Node unreachable"

  • Check IP address is correct
  • Ensure node is powered on
  • Verify you're on the same network

Throughput shows "N/A"

  • Install iperf3 on the target node
  • Run iperf3 -s on the node before testing

License

MIT © DASecure

Metadata

Release files for meshchecker 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for meshchecker 1.0.0
File Size Uploaded Provenance Actions
meshchecker-1.0.0.tar.gz 11.0 kB Without provenance Details for meshchecker-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for meshchecker 1.0.0
File Interpreter ABI Platform Actions
meshchecker-1.0.0-py3-none-any.whl Python 3 none any Details for meshchecker-1.0.0-py3-none-any.whl

Total release size: 20.9 kB

Release files / meshchecker-1.0.0.tar.gz

Download URL meshchecker-1.0.0.tar.gz
Size 11.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5b3c7851506bbe3b718864529c0301e0d6566c2ca7184c8f57c6de9512f99aa9
BLAKE2b-256 checksum
How to use checksums
68c20804358d51d35bab65d21ca8c76f291e3412032a57fc607528f23c63e193
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / meshchecker-1.0.0-py3-none-any.whl

Download URL meshchecker-1.0.0-py3-none-any.whl
Size 9.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c9a58b521ee05d6da6025b55bdb0659aebe4f8a77bae05872eb4b456f4742282
BLAKE2b-256 checksum
How to use checksums
745b1c55ced29d35f31473d91cb0b486a00ad0e0247ef31179de48959724a66f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Security for meshchecker 1.0.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

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