We’re excited to release a suite of open-source tools for connecting Meshtastic mesh networks with Matrix chat and Home Assistant. All free, all MIT licensed, all built for the OKMesh community.

🔗 The OKMesh Tool Suite

These four tools snap together like building blocks. Use one, use all — they’re designed to work independently or as a complete system.

📡 Meshtastic ⇄ Matrix Bridge

github.com/dakotasnapshot/meshtastic-matrix-bridge

Bidirectional relay between Meshtastic radios and Matrix chat rooms. Messages flow both ways — mesh users see Matrix messages, Matrix users see mesh traffic. Supports multi-channel mapping, dedup/loop prevention, and auto-recovery via watchdog.

  • Connect your mesh to Matrix (or any Matrix-bridged platform)
  • Multi-channel support — map different mesh channels to different rooms
  • SNR/RSSI metadata included on relayed messages
  • Systemd service with auto-restart

🤖 MeshBot — Standalone Meshtastic Auto-Responder

github.com/dakotasnapshot/meshbot

A lightweight bot that connects directly to your Meshtastic radio and responds to keyword commands. No Matrix, no cloud, no API keys — just a radio and a computer.

  • wx — current weather (°F or °C)
  • forecast — 3-day forecast
  • alerts — active NWS weather alerts
  • quake — recent earthquakes from USGS
  • sun — sunrise/sunset times
  • nodes — active mesh node count
  • ping / test — connectivity check
  • time — current local time
  • joke / fortune — because why not
  • cmd — list all commands (standard mesh bot discovery)

Supports TCP (WiFi radios) and USB serial. DM-only mode by default so it won’t spam your channels.

💬 MatrixBot — Matrix Room Auto-Responder

github.com/dakotasnapshot/matrixbot

Same bot commands as MeshBot, but runs inside Matrix rooms. Bridge-aware — it recognizes commands relayed through the Meshtastic bridge, so mesh users get bot responses without any extra setup.

Use it standalone in any Matrix room, or pair it with the bridge for the full experience.

🚨 HA-Matrix-Alerts — Home Assistant EAS/Weather Alert Bridge

github.com/dakotasnapshot/ha-matrix-alerts

The big one for emergency preparedness. Monitors Home Assistant for NWS weather alerts and EAS notifications, then pushes them to Matrix rooms. When paired with the Meshtastic bridge, this gives you full EAS over Meshtastic.

  • NWS weather warnings, watches, and advisories
  • EAS emergency alerts
  • Custom sensor thresholds (temperature, wind, battery, anything in HA)
  • Severity filtering — only forward what matters
  • Deduplication and rate limiting
  • Mesh-friendly short format (under 200 chars)

🧩 How They Fit Together

NWS/NOAA ──► Home Assistant ──► ha-matrix-alerts ──► Matrix Room ──► meshtastic-matrix-bridge ──► Mesh Radios 📡
                                                         ▲
                                                    matrixbot
                                                 (auto-responds)

Example: A tornado warning is issued by NWS. Home Assistant picks it up. HA-Matrix-Alerts forwards it to your Matrix room. The Meshtastic bridge relays it to every radio on the mesh. All automatic, all within seconds.

📋 Getting Started

Each repo has a detailed README with installation instructions, configuration examples, and systemd service files. The basic pattern for all of them:

  1. Clone the repo
  2. Create a virtual environment and install dependencies
  3. Copy config.example.yaml to config.yaml and edit
  4. Run directly or install as a systemd service

No paid APIs, no cloud accounts, no subscriptions. Everything uses free public data sources (wttr.in, USGS, NWS API, icanhazdadjoke).

🤝 Contributing

All repos are MIT licensed and accept pull requests. If you build something cool with these tools, let us know in the OKMesh community!

Questions? Reach out on Discord (falcon97000) or open an issue on GitHub.