mirror
/
meshtastic-matrix-relay
kopia lustrzana https://github.com/mate-dev/meshtastic-matrix-relay
1
0
Forkuj 0
Kod Zgłoszenia Packages Projekty Wydania Wiki Aktywność
A powerful and easy-to-use relay between Meshtastic devices and Matrix chat rooms, allowing seamless communication across platforms
203 Commity
3 Gałęzie
0 Tagi
252 KiB
Python 91.7%
Inno Setup 8.3%
 
 
Go to file
Geoff Whittington cc7c8850a0 Add nodes to sample config 2023-05-19 11:02:48 -04:00
.github/workflows Discover the version from Git tag 2023-04-25 20:20:52 -04:00
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 Revert formatting 2023-05-19 11:02:25 -04:00
.gitignore custom plugin support 2023-04-27 19:58:29 -04:00
DEVELOPMENT.md Docs changes 2023-05-07 18:40:30 -05:00
LICENSE Create LICENSE 2023-04-26 10:48:45 -04:00
README.md Documentation updates 2023-05-18 14:18:00 -05:00
config.py Feature/refactor (#18) 2023-04-27 13:04:54 -04:00
db_utils.py New weather plugin, improvements to ping and telemetry 2023-05-12 09:43:57 -04:00
log_utils.py Feature/refactor (#18) 2023-04-27 13:04:54 -04:00
main.py Merge branch 'geoffwhittington:main' into main 2023-05-18 13:28:13 -05: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 Add nodes command (#44) 2023-05-17 21:06:11 -04:00
requirements.txt Add help command to list active plugin commands (#43) 2023-05-17 19:31:33 -04:00
sample_config.yaml Add nodes to sample config 2023-05-19 11:02:48 -04: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
  • Supports mapping multiple rooms and channels 1:1
  • Relays messages to/from a MQTT broker, if configured in the Meshtastic firmware (Note: Messages relayed via MQTT currently share the relay's meshnet_name)

We would love to support Matrix E2EE rooms, but this is currently not implemented. If you are familiar with matrix-nio, we would gladly accept a PR for this feature!

Windows Installer

The latest installer is available here

Plugins

Generate a map of your nodes

Produce high-level details about your mesh

Getting Started with Matrix

See our Wiki page Getting Started With Matrix & MM Relay.

Already on Matrix?

Join us!

Supported Platforms

The relay is compatible with the following operating systems:

  • Linux
  • MacOS
  • Windows

Refer to the development instructions for details about running the relay on MacOS and Linux.