-
Notifications
You must be signed in to change notification settings - Fork 5
Bot
OverMesh has a built-in mesh bot — it listens on configured channels and responds to commands sent by any node on the mesh. Useful for remote diagnostics, mesh testing, or just having something respond when you're out of range of your machine.
Go to Bot tab → Settings → toggle Bot enabled. The bot label (the name it signs responses with) is configurable — default is OM Bot.
Select which channels the bot listens on. It only responds to commands on those channels.
Send any of these as a plain text message on a channel the bot is listening on:
| Command | What it does |
|---|---|
ping |
Responds with a witty PONG and RF signal info (SNR/RSSI) |
ack |
Acknowledgement response with RF info |
test |
Signal test — responds with RF info |
sitrep |
Situation report: online node count, air utilization, channel utilization |
cmd |
Lists all currently enabled commands |
motd |
Returns the current Message of the Day (if configured) |
joke |
Returns a random HAM radio / electronics / RF dad joke. Quality not guaranteed. |
relay "NAME" message |
Relays a message to another node by short name; confirms back to sender |
There's also a hidden command. You'll figure it out (or you won't — it's not important).
Commands are case-insensitive and trailing punctuation is stripped, so Ping! and ping both work.
The bot can broadcast a scheduled message to the mesh automatically.
Configure it in Bot → MOTD:
- Message — what to send
- Mode — interval (every N hours) or fixed time (daily at HH:MM)
- Channel — which channel to broadcast on
Hit Test now to send it immediately without waiting for the schedule.
The relay command lets a node ask the bot to forward a message to another node:
relay "EDC1" hello from afar
The bot finds the node by short name, sends it a DM with the message and your name, and confirms back to you. Useful when two nodes can't reach each other directly but both can reach yours.
Relay mode (DM to node vs. broadcast) is configurable in Bot → Settings.
Each connected radio has its own bot configuration. The active radio (selected via header pill) determines which bot config you're editing. Switch radios, switch bot context.
The Bot tab shows a live log of recent bot interactions — who sent what, what the bot responded, on which channel. Useful for confirming the bot is working when you're not at the machine.