MeshCore Packet Capture · Releases
from GitHub · updated 2026-07-055 releases
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-captureCLI. - Bundled broker presets (
presets/, installed asconfig.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.localare 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-captureinstall to the new/opt+/etclayout; your.env/.env.localis converted toconfig.d/99-user.toml. The old directory is left in place for rollback.New Contributors
- @vergoh made their first contribution in https://github.com/agessaman/meshcore-packet-capture/pull/26
- @maxious made their first contribution in https://github.com/agessaman/meshcore-packet-capture/pull/32
Full Changelog: https://github.com/agessaman/meshcore-packet-capture/compare/v0.4...v2.0.0
- TOML configuration under
v0.4 # 4 months ago · 2026-03-28 18:38 UTC
What's Changed
- Add device listing for FreeBSD by @samm-git in https://github.com/agessaman/meshcore-packet-capture/pull/9
- Enhance advert state management to avoid adverts on every launch and update install.sh to 1.2.1 by @agessaman in https://github.com/agessaman/meshcore-packet-capture/pull/14
- Enhance packet capture and installation scripts for MeshCore 1.14.0 compatibility by @agessaman in https://github.com/agessaman/meshcore-packet-capture/pull/16
- Align advert and control parsing with MeshCore by @robekl in https://github.com/agessaman/meshcore-packet-capture/pull/19
- Preserve decoded advert metadata by @robekl in https://github.com/agessaman/meshcore-packet-capture/pull/20
- Harden advert parsing against partial payloads by @robekl in https://github.com/agessaman/meshcore-packet-capture/pull/22
- Avoid duplicate packet publishes from RAW events by @robekl in https://github.com/agessaman/meshcore-packet-capture/pull/21
New Contributors
- @samm-git made their first contribution in https://github.com/agessaman/meshcore-packet-capture/pull/9
- @robekl made their first contribution in https://github.com/agessaman/meshcore-packet-capture/pull/19
Full Changelog: https://github.com/agessaman/meshcore-packet-capture/compare/v0.3...v0.4
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
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.
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