meshconsole 2.2.0__tar.gz

meshconsole-2.2.0/.gitignore

@@ -0,0 +1,136 @@
+# Meshtastic Tool - Git Ignore File
+# Excludes database, logs, and other generated files from version control
+
+# Database files
+*.db
+*.sqlite
+*.sqlite3
+meshtastic_messages.db
+
+# Log files
+*.log
+*.log.*
+meshtastic_tool.log
+meshtastic_tool.log.*
+
+# Python cache and compiled files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.venv/
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+
+# Configuration files with sensitive data (optional - uncomment if needed)
+# config.ini
+# .env
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+.pytest_cache/
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Backup files
+*.bak
+*.backup
+*~
+
+# Export files (generated by the tool)
+meshtastic_data.json
+meshtastic_data.csv
+exports/
+
+# Coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+CLAUDE.md

meshconsole-2.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 M9WAV
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

meshconsole-2.2.0/PKG-INFO

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: meshconsole
+Version: 2.2.0
+Summary: A powerful CLI and web interface for Meshtastic mesh networking devices
+Project-URL: Homepage, https://github.com/m9wav/MeshConsole
+Project-URL: Repository, https://github.com/m9wav/MeshConsole
+Project-URL: Issues, https://github.com/m9wav/MeshConsole/issues
+Author-email: M9WAV <m9wav@hackers.uk>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: amateur-radio,ham,lora,mesh,meshtastic,networking,radio
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications
+Classifier: Topic :: Communications :: Ham Radio
+Requires-Python: >=3.9
+Requires-Dist: flask-cors>=4.0.0
+Requires-Dist: flask>=2.0.0
+Requires-Dist: meshtastic>=2.0.0
+Requires-Dist: protobuf>=3.20.0
+Requires-Dist: pypubsub>=4.0.0
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="logo.png" alt="MeshConsole" width="400"/>
+</p>
+
+<p align="center">
+  <strong>A web-based monitoring and control dashboard for Meshtastic mesh networks.</strong>
+</p>
+
+<p align="center">
+  <a href="https://m9wav.uk/">m9wav.uk</a>
+</p>
+
+---
+
+So I got really into Meshtastic after picking up a couple of LoRa radios and wanted a way to monitor my mesh network from my computer. The official app is fine but I wanted something I could leave running on a server, log everything to a database, and maybe poke at later.
+
+This started as a quick script and... well, it grew. Now it's got a web UI and everything. Figured I'd clean it up and share it.
+
+## What it does
+
+- Connects to your Meshtastic device over **USB or TCP/IP** (WiFi)
+- Logs all packets to a SQLite database
+- Shows a live web dashboard with all the node activity
+- Lets you send messages and run traceroutes from the web UI
+- Exports your data to JSON/CSV if you want to analyze it elsewhere
+- Auto-reconnects if the connection drops
+
+The web interface shows positions on a map, telemetry data (battery, signal strength, etc), and you can see message history. Pretty handy for debugging mesh issues.
+
+## Setup
+
+```bash
+pip install -r requirements.txt
+cp config.example.ini config.ini
+```
+
+Edit `config.ini` with your setup. The main thing is picking USB or TCP:
+
+```ini
+[Device]
+# "usb" for plugged-in device, "tcp" for network
+connection_type = usb
+
+# Only needed for TCP mode
+ip = 192.168.1.100
+
+# Usually leave blank for auto-detect, but you can specify
+# serial_port = /dev/cu.usbserial-0001
+```
+
+If you're using TCP, your device needs to have WiFi enabled and you need to know its IP.
+
+## Running it
+
+**Listen for packets (with web interface):**
+```bash
+python3 meshconsole.py listen --web
+```
+
+Then open http://localhost:5050 in your browser.
+
+**Just listen (no web):**
+```bash
+python3 meshconsole.py listen --verbose
+```
+
+**List nodes your device knows about:**
+```bash
+python3 meshconsole.py nodes
+```
+
+**Send a message:**
+```bash
+python3 meshconsole.py send --dest !12345678 --message "hey there"
+```
+
+**Traceroute to a node:**
+```bash
+python3 meshconsole.py traceroute --dest !12345678
+```
+
+You can also force USB or TCP mode from the command line regardless of what's in your config:
+
+```bash
+python3 meshconsole.py listen --usb --web
+python3 meshconsole.py nodes --usb --port /dev/cu.usbserial-0001
+```
+
+## The web dashboard
+
+When you run with `--web`, you get a dashboard at port 5050. It shows:
+
+- Live packet feed (updates automatically)
+- Node list with signal info
+- Map with positions (if nodes are reporting GPS)
+- Stats about your network
+
+There's a password for sending messages/traceroutes so you can leave the dashboard open without worrying about someone messing with your network. Set it in `config.ini` under `[Security]`. Leave `auth_password` blank if you don't care.
+
+## Files
+
+After running for a while you'll have:
+- `meshtastic_messages.db` - SQLite database with all your packets
+- `meshtastic_tool.log` - Logs (rotates automatically)
+
+The database is useful if you want to do your own analysis. The `packets` table has everything including the full raw packet data as JSON.
+
+## Exporting data
+
+```bash
+python3 meshconsole.py export --format json
+python3 meshconsole.py export --format csv
+```
+
+Spits out `meshtastic_data.json` or `meshtastic_data.csv`.
+
+## Troubleshooting
+
+**Can't connect via USB:**
+- Make sure you have the right drivers (CP2102/CH340/etc)
+- Check `ls /dev/cu.usb*` (Mac) or `ls /dev/ttyUSB*` (Linux) to see if the device shows up
+- Try specifying the port explicitly with `--port`
+
+**Can't connect via TCP:**
+- Make sure WiFi is enabled on your Meshtastic device
+- Check you can ping the IP
+- The device uses port 4403 by default
+
+**Web interface not loading:**
+- Check if port 5050 is already in use
+- Try a different port in `config.ini` under `[Web]`
+
+**Seeing your own messages in the log:**
+- Shouldn't happen - the tool auto-detects your local node and filters it out
+- If it's not working, check the logs for the detected node ID
+
+## Dependencies
+
+- meshtastic
+- flask
+- flask-cors
+- protobuf
+- pypubsub
+
+All in `requirements.txt`.
+
+## License
+
+MIT. Do whatever you want with it.
+
+---
+
+Built by [M9WAV](https://m9wav.uk/). If you find bugs or have ideas, feel free to open an issue.

meshconsole-2.2.0/README.md

@@ -0,0 +1,153 @@
+<p align="center">
+  <img src="logo.png" alt="MeshConsole" width="400"/>
+</p>
+
+<p align="center">
+  <strong>A web-based monitoring and control dashboard for Meshtastic mesh networks.</strong>
+</p>
+
+<p align="center">
+  <a href="https://m9wav.uk/">m9wav.uk</a>
+</p>
+
+---
+
+So I got really into Meshtastic after picking up a couple of LoRa radios and wanted a way to monitor my mesh network from my computer. The official app is fine but I wanted something I could leave running on a server, log everything to a database, and maybe poke at later.
+
+This started as a quick script and... well, it grew. Now it's got a web UI and everything. Figured I'd clean it up and share it.
+
+## What it does
+
+- Connects to your Meshtastic device over **USB or TCP/IP** (WiFi)
+- Logs all packets to a SQLite database
+- Shows a live web dashboard with all the node activity
+- Lets you send messages and run traceroutes from the web UI
+- Exports your data to JSON/CSV if you want to analyze it elsewhere
+- Auto-reconnects if the connection drops
+
+The web interface shows positions on a map, telemetry data (battery, signal strength, etc), and you can see message history. Pretty handy for debugging mesh issues.
+
+## Setup
+
+```bash
+pip install -r requirements.txt
+cp config.example.ini config.ini
+```
+
+Edit `config.ini` with your setup. The main thing is picking USB or TCP:
+
+```ini
+[Device]
+# "usb" for plugged-in device, "tcp" for network
+connection_type = usb
+
+# Only needed for TCP mode
+ip = 192.168.1.100
+
+# Usually leave blank for auto-detect, but you can specify
+# serial_port = /dev/cu.usbserial-0001
+```
+
+If you're using TCP, your device needs to have WiFi enabled and you need to know its IP.
+
+## Running it
+
+**Listen for packets (with web interface):**
+```bash
+python3 meshconsole.py listen --web
+```
+
+Then open http://localhost:5050 in your browser.
+
+**Just listen (no web):**
+```bash
+python3 meshconsole.py listen --verbose
+```
+
+**List nodes your device knows about:**
+```bash
+python3 meshconsole.py nodes
+```
+
+**Send a message:**
+```bash
+python3 meshconsole.py send --dest !12345678 --message "hey there"
+```
+
+**Traceroute to a node:**
+```bash
+python3 meshconsole.py traceroute --dest !12345678
+```
+
+You can also force USB or TCP mode from the command line regardless of what's in your config:
+
+```bash
+python3 meshconsole.py listen --usb --web
+python3 meshconsole.py nodes --usb --port /dev/cu.usbserial-0001
+```
+
+## The web dashboard
+
+When you run with `--web`, you get a dashboard at port 5050. It shows:
+
+- Live packet feed (updates automatically)
+- Node list with signal info
+- Map with positions (if nodes are reporting GPS)
+- Stats about your network
+
+There's a password for sending messages/traceroutes so you can leave the dashboard open without worrying about someone messing with your network. Set it in `config.ini` under `[Security]`. Leave `auth_password` blank if you don't care.
+
+## Files
+
+After running for a while you'll have:
+- `meshtastic_messages.db` - SQLite database with all your packets
+- `meshtastic_tool.log` - Logs (rotates automatically)
+
+The database is useful if you want to do your own analysis. The `packets` table has everything including the full raw packet data as JSON.
+
+## Exporting data
+
+```bash
+python3 meshconsole.py export --format json
+python3 meshconsole.py export --format csv
+```
+
+Spits out `meshtastic_data.json` or `meshtastic_data.csv`.
+
+## Troubleshooting
+
+**Can't connect via USB:**
+- Make sure you have the right drivers (CP2102/CH340/etc)
+- Check `ls /dev/cu.usb*` (Mac) or `ls /dev/ttyUSB*` (Linux) to see if the device shows up
+- Try specifying the port explicitly with `--port`
+
+**Can't connect via TCP:**
+- Make sure WiFi is enabled on your Meshtastic device
+- Check you can ping the IP
+- The device uses port 4403 by default
+
+**Web interface not loading:**
+- Check if port 5050 is already in use
+- Try a different port in `config.ini` under `[Web]`
+
+**Seeing your own messages in the log:**
+- Shouldn't happen - the tool auto-detects your local node and filters it out
+- If it's not working, check the logs for the detected node ID
+
+## Dependencies
+
+- meshtastic
+- flask
+- flask-cors
+- protobuf
+- pypubsub
+
+All in `requirements.txt`.
+
+## License
+
+MIT. Do whatever you want with it.
+
+---
+
+Built by [M9WAV](https://m9wav.uk/). If you find bugs or have ideas, feel free to open an issue.

meshconsole-2.2.0/pyproject.toml

@@ -0,0 +1,70 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "meshconsole"
+version = "2.2.0"
+description = "A powerful CLI and web interface for Meshtastic mesh networking devices"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "M9WAV", email = "m9wav@hackers.uk" }
+]
+keywords = ["meshtastic", "mesh", "networking", "lora", "radio", "ham", "amateur-radio"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Communications",
+    "Topic :: Communications :: Ham Radio",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "meshtastic>=2.0.0",
+    "Flask>=2.0.0",
+    "Flask-CORS>=4.0.0",
+    "protobuf>=3.20.0",
+    "pypubsub>=4.0.0",
+    "requests>=2.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "build",
+    "twine",
+]
+
+[project.urls]
+Homepage = "https://github.com/m9wav/MeshConsole"
+Repository = "https://github.com/m9wav/MeshConsole"
+Issues = "https://github.com/m9wav/MeshConsole/issues"
+
+[project.scripts]
+meshconsole = "meshconsole.core:main"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src/meshconsole",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/meshconsole"]
+
+[tool.hatch.build]
+include = [
+    "src/meshconsole/**/*.py",
+    "src/meshconsole/templates/**",
+]

meshconsole-2.2.0/src/meshconsole/__init__.py

@@ -0,0 +1,13 @@
+"""
+MeshConsole - A tool for interacting with Meshtastic devices.
+
+Author: M9WAV
+License: MIT
+"""
+
+__version__ = "2.2.0"
+__author__ = "M9WAV"
+
+from meshconsole.core import MeshtasticTool, MeshtasticToolError, PacketSummary
+
+__all__ = ["MeshtasticTool", "MeshtasticToolError", "PacketSummary", "__version__"]

meshconsole-2.2.0/src/meshconsole/__main__.py

@@ -0,0 +1,8 @@
+"""
+Entry point for running meshconsole as a module: python -m meshconsole
+"""
+
+from meshconsole.core import main
+
+if __name__ == "__main__":
+    main()