Skip to main content

Meshtastic Python

codecov PyPI - Downloads CI CLA assistant Fiscal Contributors GPL-3.0

Overview

A Python client for use with Meshtastic devices. This small library (and example application) provides an easy API for sending and receiving messages over mesh radios. It also provides access to any of the operations/data available in the device user interface or the Android application. Events are delivered using a publish-subscribe model, and you can subscribe to only the message types you are interested in.

Getting Started Guide

(Documentation/API Reference is currently offline)

Call for Contributors

This library and CLI has gone without a consistent maintainer for a while, and there's many improvements that could be made. We're all volunteers here and help is extremely appreciated, whether in implementing your own needs or helping maintain the library and CLI in general.

If you're interested in contributing but don't have specific things you'd like to work on, look at the roadmap below!

Roadmap

This should always be considered a list in progress and flux -- inclusion doesn't guarantee implementation, and exclusion doesn't mean something's not wanted. GitHub issues are a great place to discuss ideas.

  • Types
    • type annotations throughout the codebase, and upgrading mypy running in CI to --strict
  • async-friendliness
  • CLI completeness & consistency
    • the CLI should support all features of the firmware
    • there should be a consistent output format available for shell scripting
  • CLI input validation & documentation
    • what arguments and options are compatible & incompatible with one another?
    • can the options be restructured in a way that is more self-documenting?
    • pubsub events should be documented clearly
  • helpers for third-party code
    • it should be easy to write a script that supports similar options to the CLI so many tools support the same ways of connecting to nodes
  • data storage & processing
    • there should be a standardized way of recording packets for later use, debugging, etc.
    • a persistence layer could also keep track of nodes beyond nodedb, as the apps do
    • a sqlite database schema and tools for writing to it may be a good starting point
    • enable maps, charts, visualizations

Stats

Alt

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meshtastic-2.3.13.tar.gz (187.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

meshtastic-2.3.13-py3-none-any.whl (224.5 kB view details)

Uploaded Python 3

File details

Details for the file meshtastic-2.3.13.tar.gz.

File metadata

  • Download URL: meshtastic-2.3.13.tar.gz
  • Upload date:
  • Size: 187.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.19

File hashes

Hashes for meshtastic-2.3.13.tar.gz
Algorithm Hash digest
SHA256 a1269d5848afd49d7d7db76b7f1ca701a5e9d517d7d1891970cc4c7fb4dc83df
MD5 98b43487a813ddd70974cce5b267de03
BLAKE2b-256 4bcf65777c3b26c09183e9906207d11190a258a356e0c8c78e4b1fdefd109ad9

See more details on using hashes here.

File details

Details for the file meshtastic-2.3.13-py3-none-any.whl.

File metadata

  • Download URL: meshtastic-2.3.13-py3-none-any.whl
  • Upload date:
  • Size: 224.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.19

File hashes

Hashes for meshtastic-2.3.13-py3-none-any.whl
Algorithm Hash digest
SHA256 5b9abccbfa6942ec10a1a333fa08d0c23c5cb24709c9cb9c807dcf87fa66e666
MD5 f22201549dd42fcc2439165e378d66fb
BLAKE2b-256 cca575fbc68bb5ae767755147c76c0284c554072c6151d67199ba21a0dad1f44

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page