MeshCore Packet Capture

MeshCore Packet Capture · Releases

from GitHub · updated 2026-07-05

5 releases

  1. v2.0.0 # 28 days ago · 2026-06-22 21:21 UTC

    Realigns configuration, install, and runtime layout with meshcoretomqtt.

    Added

    • TOML configuration under /etc/meshcore-packet-capture/ (config.toml + config.d/*.toml, deep-merged; [[broker]] merges by name).
    • Python installer (python3 -m installer) with install / update / migrate, systemd & launchd units, Docker, service account, and BLE/serial/TCP setup.
    • PyPI distribution: pipx install meshcore-packet-capture + meshcore-packet-capture CLI.
    • Bundled broker presets (presets/, installed as config.d/10-*.toml).
    • Unlimited sequentially-numbered MQTT brokers.
    • JWT auth via pure-Python Ed25519 (pynacl), per-broker owner/email, token TTL.
    • Device stats (core/radio/packets) in MQTT status messages.
    • macOS BLE support via a per-user LaunchAgent.

    Changed

    • App installs to /opt, config to /etc, state to /var/lib (FHS).
    • .env/.env.local are now a legacy fallback, overridden by TOML.
    • Requires Python 3.11+ and meshcore >= 2.2.31.
    • Default advert interval standardized at 47 hours.
    • Docker image no longer bundles Node.js (JWT signing is pure-Python).

    Upgrading

    Run the installer to migrate a legacy ~/.meshcore-packet-capture install to the new /opt + /etc layout; your .env/.env.local is converted to config.d/99-user.toml. The old directory is left in place for rollback.

    New Contributors

    Full Changelog: https://github.com/agessaman/meshcore-packet-capture/compare/v0.4...v2.0.0

  2. v0.4 # 4 months ago · 2026-03-28 18:38 UTC

    What's Changed

    New Contributors

    Full Changelog: https://github.com/agessaman/meshcore-packet-capture/compare/v0.3...v0.4

  3. v0.3 # 7 months ago · 2025-12-20 22:51 UTC
    • Refactored auth token signing to use the radio to sign JWTs, with fallbacks to a python implementation (typically unnecessary unless then firmware is 6+ months old). Removes dependency on meshcore-decoder.
    • Improved BLE timeout and reconnect handling.
    • Fixes pairing process in pairing_helper.py on MacOS
    • Improvements in install.sh
  4. v0.2 # 9 months ago · 2025-10-21 04:57 UTC
    • This release includes preliminary installer support for Windows—the installer works, but it won't automatically find and pair nodes due to limitations in scripting the Windows BLE stack. The installer will automatically create the necessary configuration files.
    • Added firmware, model, and packet-capture version to status updates in MQTT brokers
    • improved handling of timeouts and more descriptive error logging

    Thanks to those who have tried the script so far, your feedback has been really helpful.

  5. v0.1 # 9 months ago · 2025-10-16 03:19 UTC
    • Multi-Connection Support: BLE, Serial, and TCP connections
    • Packet Analysis: Route types, payload parsing, and RF metrics (SNR/RSSI)
    • Multi-Broker MQTT: Up to 4 MQTT brokers simultaneously
    • JWT Authentication: Device private key authentication with automatic renewal
    • Connection Management: Automatic reconnection and health monitoring
    • Output Options: Console, file, and MQTT publishing
    • Service Installation: Automated systemd/launchd service setup
    • Docker Support: Containerized deployment
    • Topic Templates: Dynamic MQTT topics with IATA and device placeholders
    • Packet Hashing: SHA-256 packet identification
    • Advert Parsing: MeshCore advertisement data support
    • TLS/WebSocket: Encrypted MQTT connections with WebSocket transport