DISCLAIMER: This repo has been put on hold and may not be updated for quite a bit. It's also a bit outdated and probably has issues. I will eventually be carrying over the meshtastic functionalites, as well as meshcore to my newer project: CartoTUI

Meshtastic TUI

A cross-platform terminal user interface (TUI) for Meshtastic radios, written in Python using prompt_toolkit.
Control, chat, and manage nodes on your Meshtastic mesh network. Features dynamic serial port detection, node monitoring, and direct messaging.

Features

• Real-Time Meshtastic Chat: Send/receive broadcast and direct (DM) messages.
• Dynamic Serial Port Selection: Auto-detect all available serial ports, switch via TUI.
• Node List Monitoring: View nodes, SNR, last-heard, and select for DM or traceroute.
• Message Status: Shows delivery and error status.
• Custom Theme/Keybinds: Color scheme and efficient navigation.

---

Meshtui Installation Guide

This guide will walk you through the steps to install and run meshtui, a terminal user interface for Meshtastic.

---

Prerequisites

Before you begin, make sure you have the following installed on your system:

• Python 3.8 or higher: Check your Python version:

  python3 --version

• Git: Required to clone the project repository.

---

Installation Steps

For Windows Users (Executable)

Simply download the MeshTUI.exe from the assets of the release. Run it directly!

For Linux and macOS Users (From Source)

If you're on Linux or macOS, you will need to run the application from source. Ensure you have Python 3.x installed, then:

1. Clone the repository:

   git clone https://github.com/SAMS0N1tE/meshtui.git
   cd meshtui
   
   

   (Replace your-username/your-repo-name with the actual path to your repository.)

2. Create and activate a virtual environment (Recommended, but not required): This keeps the project's dependencies isolated. Run these commands inside the project directory (MIM):

   python -m venv venv

   Now, activate the environment:

   • Windows (Command Prompt/PowerShell):

     .\venv\Scripts\activate

   • Linux / macOS (bash/zsh):

     source venv/bin/activate

   You should see (venv) appear at the beginning of your terminal prompt.

3. Install dependencies:

   pip install -r requirements.txt
   
   

4. Run the application:

   python start_meshtui.py
   
   

💡 Feedback & Contributions

This is an initial release, and we welcome your feedback! If you encounter any bugs, have suggestions for new features, or would like to contribute, please open an issue or a pull request on the GitHub repository.