A powerful and easy-to-use relay between Meshtastic devices and Matrix chat rooms, allowing seamless communication across platforms
 
 
Go to file
Geoff Whittington b531f91cb4 Remove support for custom plugins 2023-05-13 21:04:10 -04:00
.github/workflows
example_plugins Added custom plugin guidance 2023-04-27 21:21:43 -04:00
gui Updates (#35) 2023-05-07 14:17:23 -04:00
plugins New weather plugin, improvements to ping and telemetry 2023-05-12 09:43:57 -04:00
.gitignore
DEVELOPMENT.md Docs changes 2023-05-07 18:40:30 -05:00
LICENSE
README.md Update README.md 2023-04-28 22:11:11 -05:00
config.py
db_utils.py New weather plugin, improvements to ping and telemetry 2023-05-12 09:43:57 -04:00
log_utils.py
main.py Allow plugins to use database 2023-04-28 03:04:09 -04:00
matrix_utils.py Fixes #40 2023-05-12 09:42:33 -04:00
meshtastic_utils.py Move logging after plugins because sometimes the room doesn't get notified. Add method for lost connection, used in a future commit 2023-05-12 10:47:23 -04:00
mmrelay.iss Fix OverwriteConfig value in install script 2023-05-07 22:05:32 -05:00
plugin_loader.py Remove support for custom plugins 2023-05-13 21:04:10 -04:00
requirements.txt Add missing requests dependency 2023-05-13 20:14:10 -04:00
sample_config.yaml Docs changes 2023-05-07 18:40:30 -05:00

README.md

M<>M Relay

(Meshtastic <=> Matrix Relay)

A powerful and easy-to-use relay between Meshtastic devices and Matrix chat rooms, allowing seamless communication across platforms. This opens the door for bridging Meshtastic devices to many other platforms.

Features

  • Bidirectional message relay between Meshtastic devices and Matrix chat rooms, capable of supporting multiple meshnets
  • Supports both serial and network connections for Meshtastic devices
  • Custom keys are embedded in Matrix messages which are used when relaying messages between two or more meshnets.
  • Truncates long messages to fit within Meshtastic's payload size
  • SQLite database to store node information for improved functionality
  • Customizable logging level for easy debugging
  • Configurable through a simple YAML file
  • New: Supports mapping multiple rooms and channels 1:1

Windows Installer

The latest installer is available here

Plugins

Generate a map of your nodes

Produce high-level details about your mesh

Supported Platforms

The relay can run on:

  • Linux
  • MacOS
  • Windows

Refer to the development instructions for more details.