A terminal user interface (TUI) for monitoring and interacting with Meshtastic mesh networks.

• Real-time packet monitoring - Stream all mesh traffic with color-coded packet types
• Node discovery - Live table of all nodes with signal strength, battery, distance, and more
• Node details - Deep dive into individual nodes with telemetry, position, and message history
• IRC-style chat - Channel-based messaging with support for channels 0-7
• Direct messages - Private conversations with individual nodes (PKI encrypted)
• Reactions & replies - React to messages with emoji and reply with threading
• Channel management - Create, join, and manage channels; invite nodes to channels
• Favorites - Mark important nodes for quick access and alerts
• Device settings - Configure radio, channels, GPS, and device settings
• Advanced tools - Config backup/restore, factory reset, and privacy features
• Persistent storage - Message history and node data saved to SQLite database

pipx installs the application in an isolated environment:

pipx install git+https://github.com/Meshterm/meshterm.git

pip install git+https://github.com/Meshterm/meshterm.git

# Clone the repository
git clone https://github.com/Meshterm/meshterm.git
cd meshterm

# Option 1: Install with pip (editable mode for development)
pip install -e .

# Option 2: Use the provided scripts
bin/install   # Creates venv and installs dependencies
bin/run       # Runs the application

• Python 3.8+
• A Meshtastic device connected via USB

Dependencies (installed automatically):

• meshtastic - Meshtastic Python SDK
• textual - TUI framework
• reverse_geocoder - Offline reverse geocoding
• pgeocode - Postal code lookups

# Auto-detect device
meshterm

# Specify a port
meshterm /dev/ttyACM0

# If installed from source with bin/install
bin/run [port]

Table of all discovered nodes with key metrics. Supports searching, sorting, and quick actions.

Features:

• Search (/) - Filter nodes by name, ID, or location
• Favorites (f) - Mark nodes as favorites for highlighting and alerts
• Invite (i) - Send channel invitations to selected node
• Sorting (</>) - Cycle through sort columns; (r) reverse direction
• PKI indicator - Shows which nodes have completed key exchange

Real-time stream of all packets in the mesh network.

IRC-style chat interface with channel tabs and direct messaging.

Features:

• Channels (0-7) - Switch between broadcast channels
• Direct Messages - Private encrypted conversations (shown as @Name tabs)
• Reactions (Ctrl+R) - React to messages with emoji
• Replies (Ctrl+E) - Reply to specific messages with threading
• Channel Manager (Ctrl+J) - Manage channels and DMs, start new conversations
• Navigation (Left/Right) - Cycle through channels and open DMs
• Close DM (x) - Close the current DM tab

Comprehensive information about a selected node with DM capability. Select a node from the Nodes view and press Enter to see detailed info, telemetry, position, and message history.

Sub-tabs:

• Messages (m) - DM conversation with selected node
• Info (i) - Node details and telemetry

Configure your Meshtastic device settings.

Sub-tabs:

• Radio (r) - LoRa settings (region, modem preset, hop limit)
• Channels (h) - Channel configuration (name, PSK, role)
• GPS (g) - Position settings and manual location
• Device (d) - Device name and role preferences
• Advanced (a) - Backup, reset, and maintenance operations

Meshterm stores data in ~/.meshterm/:

• meshterm.db - SQLite database with messages, nodes, and reactions
• meshterm.log - Plain text log of all messages
• config.json - Application settings (manual location, preferences)

meshterm/
+-- bin/
|   +-- install          # Setup script
|   +-- run              # Application launcher
+-- meshterm/
|   +-- app.py           # Main application
|   +-- state.py         # State management
|   +-- connection.py    # Meshtastic device connection
|   +-- formatting.py    # Display formatting utilities
|   +-- storage.py       # SQLite storage backend
|   +-- views/           # Application views
|   |   +-- log.py       # Packet log view
|   |   +-- nodes.py     # Node table view
|   |   +-- detail.py    # Node detail view
|   |   +-- chat.py      # Chat view
|   |   +-- settings.py  # Settings view
|   +-- widgets/         # Reusable UI components
|       +-- header_bar.py
|       +-- status_bar.py
|       +-- node_table.py
|       +-- chat_log.py
|       +-- chat_input.py
|       +-- channel_manager.py
|       +-- reaction_picker.py
|       +-- help_modal.py
|       +-- config_panels.py
+-- README.md

MIT License - See LICENSE file for details.

Contributions are welcome! Please feel free to submit a Pull Request.

• Meshtastic - The mesh networking project
• Textual - TUI framework
• Rich - Terminal formatting library