Meshchat ia an Iced cross-platform GUI application to interact with Meshtastic LoRa radios:
- find Bluetooth Low Energy attached meshtastic devices
- connect to one
- use it to chat with others using the available channels or direct messages to Nodes
- it saves the last device connected to (and channel if applicable), and on re-start it will try to automatically reconnect to that and continue chatting
On the left, the Device view, once you have connected to a BLE Radio, shows configured channels, a list of nodes found and nodes you have marked as a favorite.
On the right, the Channel view, Once you have clicked on a channel or a node, shows you the ongoing chat messages with it, with your messages on the right and others on the left.
|
|
*** WARNING: Alpha quality, and few automated tests! ***
Since the app doesn't try to change the configuration of any attached radio, at most it tries to send messages, the risk of "damage" from any bug is kind of low.
My thinking was to keep the app as simple to look at and use as possible.
- avoid the app being an extremely geeky LoRa/Mesh app.
- try to give users a simple chat experience, similar to ones they will be accustomed to with WhatsApp, Telegram, etc.
- you will need to use some other app to configure their radio and join a mesh
I've made some unusual (and questionable) UI choices even in the minimal UI I have. They just kind of materialized as I went, and I don't claim it's great...If people can use it easily, great. If not, help is welcome to improve it.
Meshchat uses the Iced, Meshtastic and other rust crates that are all cross-platform, so it should run on
many Operating Systems, including macOS, Windows and Linux.
So far, I have used it successfully on:
- macOS (Tahoe)
- Linux (Pop OS!)
- Known bug in BLE device discovery—it detects all BlueTooth devices, not just Meshtastic radios
If you successfully run it on other OS or variants of the above, drop me a message in the repo's discussions with some details, and I will add to a list of known working OS.
Tests are run in GitHub actions on macos-15, ubuntu-latest and window-latest.
It should work with all Meshtastic radios that are supported by the Meshtastic rust crate.
So far, I have tested with a LillyGo T-ECHO and a T-Deck Pro
Again, if you get it working successfully with other radios, drop me a message in discussions and I will create some list of known working radios.
For now, it's very rust-developer-oriented. If you have a working rust toolchain installed, then use:
cargo install meshchat
to get the binary built and installed and in your $PATH.
Later I may work on pre-build binaries attached to GitHub releases,
or cargo binstall support to make it easier.
After a bit of optimizing I did, the release binary size is around 5.6 MBytes
If you clone the repo, you can run meshchat directly with:
cargo run --release
I did this as a bit of an experiment to see if I could get it working with real hardware and the mesh, which I did, so I am delighted.
If you use it successfully on some new OS variant, or LoRa radio, please drop me a message in the discussions.
I may (as usual) play with some aspects of it to learn more rust or Iced or specific things (e.g., I really need to knuckle down and learn about theming and styling in Iced...).
But I would only invest significant amounts of time if I see real interest and usage from people. I have other open source toy projects that keep me busy without this one—the one with the most traction from users will be the one that gets more of my time.
I add to the GitHub Issues as they occur to me. I have marked a few with the "help needed" label, but I would basically welcome help in any area, no matter how small.
Help from someone with some real UI / UX chops would be great.
As usual for such rust projects, much work is needed on CI, Releasing, Bundling for OS, etc. Help there would be great.
If you want to help out, submit a well-written issue, or start a conversation in the discussions or clone the repo, make some improvement and submit a PR.
These are the top-level dependencies of meshchat and their licenses:
- meshtastic - GPL-3.0 License
- iced - MIT License
- iced_futures - Inherits from iced, so MIT
- directories - Apache Version 2, or MIT license at your option
So, due to the meshtastic license, this project is also licensed under the GPL-3.0 License