{
  "id": "meshcore-insights",
  "name": "MeshCore Insights",
  "kind": "client",
  "status": "active",
  "maturity": "beta",
  "description": "Desktop MeshCore dashboard with USB and BLE connections, live maps, messaging, node and telemetry analysis, offline map tiles, remote management and a raw event console.",
  "screenshots": [
    {
      "file": "screenshot-1.png",
      "caption": "Live node map and searchable mesh-node list"
    },
    {
      "file": "screenshot-2.png",
      "caption": "Node context menu with messaging and analysis actions"
    },
    {
      "file": "screenshot-3.png",
      "caption": "Channel communications with routed-path visualization"
    },
    {
      "file": "screenshot-4.png",
      "caption": "Contact map popup and mesh path lines"
    },
    {
      "file": "screenshot-5.png",
      "caption": "Offline map tile downloader"
    },
    {
      "file": "screenshot-6.png",
      "caption": "Node status, telemetry and analysis tools"
    },
    {
      "file": "screenshot-7.png",
      "caption": "Remote node management and command responses"
    },
    {
      "file": "screenshot-8.png",
      "caption": "Raw MeshCore event console"
    }
  ],
  "maintainers": [
    {
      "name": "BomBefok",
      "url": "https://github.com/BomBefok"
    }
  ],
  "repository": "https://github.com/BomBefok/MeshcoreInsights",
  "license": "GPL-2.0-only",
  "languages": [
    "python"
  ],
  "platforms": [
    "linux",
    "macos",
    "windows"
  ],
  "interfaces": [
    "gui"
  ],
  "connections": [
    "ble",
    "serial",
    "usb"
  ],
  "node_roles": [
    "companion",
    "repeater"
  ],
  "capabilities": [
    "messaging",
    "contacts",
    "channels",
    "remote-administration",
    "monitoring",
    "telemetry",
    "packet-analysis",
    "mapping"
  ],
  "install": [
    {
      "type": "github-release",
      "url": "https://github.com/BomBefok/MeshcoreInsights/releases"
    },
    {
      "type": "source",
      "url": "https://github.com/BomBefok/MeshcoreInsights"
    }
  ],
  "popularity": {
    "githubStars": 1,
    "githubForks": 0,
    "githubWatchers": 0,
    "githubOpenIssues": 1,
    "githubContributors": 1,
    "releaseDownloads": 2,
    "latestReleaseDownloads": 2,
    "lastChecked": "2026-06-23"
  },
  "verification": {
    "sourceAvailable": true,
    "releasesAvailable": true,
    "signedReleases": false,
    "ciBuilds": false,
    "hasDocumentation": false,
    "lastChecked": "2026-06-23",
    "notes": [
      "The compiled demo runs for ten minutes; the project states that a free unlock code is available.",
      "A dedicated user manual is bundled inside the compiled release rather than published separately online."
    ]
  },
  "tags": [
    "desktop",
    "offline-maps",
    "remote-management",
    "analytics"
  ],
  "last_reviewed": "2026-06-23",
  "source": {
    "path": "data/software/meshcore-insights/software.yaml",
    "updatedAt": "2026-06-24T05:12:55+02:00"
  },
  "latest_version": "MeshInsights",
  "released": "2026-03-27",
  "releases": [
    {
      "version": "MeshInsights",
      "name": "MeshInsights Beta 2 release",
      "datetime": "2026-03-27T01:14:13Z",
      "url": "https://github.com/BomBefok/MeshcoreInsights/releases/tag/MeshInsights",
      "prerelease": false,
      "notes": "# ⬡ MeshCore Insights\r\n\r\n> **Desktop dashboard for MeshCore mesh radio networks**\r\n\r\n\r\n> ⚠️ **This software is under active development.** Features may change and bugs may be present. Please report issues on GitHub and check for updated releases regularly. Your feedback directly shapes the roadmap.\r\n\r\nThe demo will run for 10 minutes, Free unlock code is available if needed. ( Purely for mass use :) \r\n\r\nMeshCore Insights connects to a MeshCore companion node via **USB serial or Bluetooth (BLE)** and provides a real-time dashboard — live node map, messaging, node analysis, remote management, and a debug console.\r\n\r\n---\r\n\r\nVarious cosmetic improvements. New features added. Minor bug fixes\r\n\r\n---\r\n## Screenshots\r\n\r\n<img width=\"1632\" height=\"839\" alt=\"image\" src=\"https://github.com/user-attachments/assets/86a5ef55-14a2-4768-9826-ad1ec01b84b5\" />\r\n\r\n<img width=\"388\" height=\"200\" alt=\"image\" src=\"https://github.com/user-attachments/assets/0fe0b545-8246-4a34-b3f2-d08153d502bc\" />\r\n\r\n\r\n<img width=\"397\" height=\"392\" alt=\"image\" src=\"https://github.com/user-attachments/assets/507aaf63-e3b2-4e31-aa7a-edf6e1ef8874\" />\r\n\r\n<img width=\"907\" height=\"812\" alt=\"image\" src=\"https://github.com/user-attachments/assets/442e537e-bded-4ecc-acef-edde3f096a6f\" />\r\n\r\n\r\n---\r\n\r\n## Features\r\n\r\n- **Live Map** — Leaflet-based interactive map of all mesh nodes, colour-coded by last-heard time\r\n- **Messaging** — Channel and direct messaging with path history and message path visualisation\r\n- **Node Analysis** — Battery, SNR, telemetry gauges, noise floor graph, neighbour tables\r\n- **Remote Management** — Login and send admin commands to remote nodes over the mesh\r\n- **Debug Console** — Full raw event stream for troubleshooting\r\n- **Offline Maps** — Download and use tile maps without internet\r\n- **USB & BLE** — Connect via serial port or Bluetooth with auto-scanning\r\n- **Dark / Light Theme** — Toggle between themes at any time\r\n- **Delete Contacts** — Remove nodes from the radio's contact database via the GUI\r\n- **Add / Remove Contacts in favourites\r\n-**Expanded right click contextual menus in node lists.\r\n\r\n---\r\n\r\n## Installation\r\n\r\nClone files\r\n\r\nInstall dependancies and run the code.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\n### USB Connection\r\n1. Connect your MeshCore companion node via USB\r\n2. Select **🔌 USB** in the top bar\r\n3. Choose the correct COM port from the drop-down\r\n4. Click **▶ Connect**\r\n\r\n### Bluetooth (BLE) Connection\r\n1. Select **📶 BLE** in the top bar\r\n2. Click **📶 Scan / Connect**\r\n3. Select your MeshCore device from the scan results (highlighted in cyan)\r\n4. Click **⬡ Connect to Device** — pairing is handled automatically\r\n\r\n> **Windows BLE note:** On first connection Windows pairs the device automatically. If connection fails, remove the device from Windows Bluetooth Settings, restart your MeshCore node, and connect again.\r\n\r\n---\r\n\r\n## User Manual\r\n\r\nA full user manual is bundled with the compiled release as `MeshCore_Insights_Manual.docx`.\r\n\r\nThe manual covers:\r\n- System requirements and installation\r\n- USB and BLE connection setup\r\n- All five tabs: Map, Communications, Node Analysis, Remote Management, Console\r\n- Tools menu operations\r\n- Deleting contacts\r\n- Keyboard shortcuts\r\n- Troubleshooting guide\r\n- Known limitations\r\n\r\n---\r\n\r\n## Interface Overview\r\n\r\n### Top Bar\r\n\r\n| Element | Description |\r\n|---------|-------------|\r\n| 🔌 USB / 📶 BLE | Select connection type |\r\n| Port / Device | COM port selector (USB) or selected device name (BLE) |\r\n| ▶ Connect / ■ Disconnect | Connect or disconnect |\r\n| ⊕ Fit Map | Zoom map to fit all nodes |\r\n| 📡 Advert | Send flood advertisement to the mesh |\r\n| 🗺 Offline Maps | Download map tiles for offline use |\r\n| ☀/☾ Theme | Toggle dark/light theme |\r\n\r\n### Tabs\r\n\r\n| Tab | Purpose |\r\n|-----|---------|\r\n| **Map** | Live node map with side panel, search, and context actions |\r\n| **Communications** | Channel and direct messaging with path history |\r\n| **Node Analysis** | Detailed stats, telemetry, neighbours for \n…",
      "notesHtml": "<h1>⬡ MeshCore Insights</h1>\n<blockquote>\n<p><strong>Desktop dashboard for MeshCore mesh radio networks</strong></p>\n</blockquote>\n<blockquote>\n<p>⚠️ <strong>This software is under active development.</strong> Features may change and bugs may be present. Please report issues on GitHub and check for updated releases regularly. Your feedback directly shapes the roadmap.</p>\n</blockquote>\n<p>The demo will run for 10 minutes, Free unlock code is available if needed. ( Purely for mass use :) </p>\n<p>MeshCore Insights connects to a MeshCore companion node via <strong>USB serial or Bluetooth (BLE)</strong> and provides a real-time dashboard — live node map, messaging, node analysis, remote management, and a debug console.</p>\n<hr />\n<p>Various cosmetic improvements. New features added. Minor bug fixes</p>\n<hr />\n<h2>Screenshots</h2>\n<img alt=\"image\" src=\"https://github.com/user-attachments/assets/86a5ef55-14a2-4768-9826-ad1ec01b84b5\" /><img alt=\"image\" src=\"https://github.com/user-attachments/assets/0fe0b545-8246-4a34-b3f2-d08153d502bc\" /><img alt=\"image\" src=\"https://github.com/user-attachments/assets/507aaf63-e3b2-4e31-aa7a-edf6e1ef8874\" /><img alt=\"image\" src=\"https://github.com/user-attachments/assets/442e537e-bded-4ecc-acef-edde3f096a6f\" /><hr />\n<h2>Features</h2>\n<ul>\n<li><strong>Live Map</strong> — Leaflet-based interactive map of all mesh nodes, colour-coded by last-heard time</li>\n<li><strong>Messaging</strong> — Channel and direct messaging with path history and message path visualisation</li>\n<li><strong>Node Analysis</strong> — Battery, SNR, telemetry gauges, noise floor graph, neighbour tables</li>\n<li><strong>Remote Management</strong> — Login and send admin commands to remote nodes over the mesh</li>\n<li><strong>Debug Console</strong> — Full raw event stream for troubleshooting</li>\n<li><strong>Offline Maps</strong> — Download and use tile maps without internet</li>\n<li><strong>USB &amp; BLE</strong> — Connect via serial port or Bluetooth with auto-scanning</li>\n<li><strong>Dark / Light Theme</strong> — Toggle between themes at any time</li>\n<li><strong>Delete Contacts</strong> — Remove nodes from the radio's contact database via the GUI</li>\n<li>**Add / Remove Contacts in favourites\n-**Expanded right click contextual menus in node lists.</li>\n</ul>\n<hr />\n<h2>Installation</h2>\n<p>Clone files</p>\n<p>Install dependancies and run the code.</p>\n<hr />\n<h2>Quick Start</h2>\n<h3>USB Connection</h3>\n<ol>\n<li>Connect your MeshCore companion node via USB</li>\n<li>Select <strong>🔌 USB</strong> in the top bar</li>\n<li>Choose the correct COM port from the drop-down</li>\n<li>Click <strong>▶ Connect</strong></li>\n</ol>\n<h3>Bluetooth (BLE) Connection</h3>\n<ol>\n<li>Select <strong>📶 BLE</strong> in the top bar</li>\n<li>Click <strong>📶 Scan / Connect</strong></li>\n<li>Select your MeshCore device from the scan results (highlighted in cyan)</li>\n<li>Click <strong>⬡ Connect to Device</strong> — pairing is handled automatically</li>\n</ol>\n<blockquote>\n<p><strong>Windows BLE note:</strong> On first connection Windows pairs the device automatically. If connection fails, remove the device from Windows Bluetooth Settings, restart your MeshCore node, and connect again.</p>\n</blockquote>\n<hr />\n<h2>User Manual</h2>\n<p>A full user manual is bundled with the compiled release as <code>MeshCore_Insights_Manual.docx</code>.</p>\n<p>The manual covers:</p>\n<ul>\n<li>System requirements and installation</li>\n<li>USB and BLE connection setup</li>\n<li>All five tabs: Map, Communications, Node Analysis, Remote Management, Console</li>\n<li>Tools menu operations</li>\n<li>Deleting contacts</li>\n<li>Keyboard shortcuts</li>\n<li>Troubleshooting guide</li>\n<li>Known limitations</li>\n</ul>\n<hr />\n<h2>Interface Overview</h2>\n<h3>Top Bar</h3>\n<table>\n<thead>\n<tr>\n<th>Element</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>🔌 USB / 📶 BLE</td>\n<td>Select connection type</td>\n</tr>\n<tr>\n<td>Port / Device</td>\n<td>COM port selector (USB) or selected device name (BLE)</td>\n</tr>\n<tr>\n<td>▶ Connect / ■ Disconnect</td>\n<td>Connect or disconnect</td>\n</tr>\n<tr>\n<td>⊕ Fit Map</td>\n<td>Zoom map to fit all nodes</td>\n</tr>\n<tr>\n<td>📡 Advert</td>\n<td>Send flood advertisement to the mesh</td>\n</tr>\n<tr>\n<td>🗺 Offline Maps</td>\n<td>Download map tiles for offline use</td>\n</tr>\n<tr>\n<td>☀/☾ Theme</td>\n<td>Toggle dark/light theme</td>\n</tr>\n</tbody></table>\n<h3>Tabs</h3>\n<table>\n<thead>\n<tr>\n<th>Tab</th>\n<th>Purpose</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><strong>Map</strong></td>\n<td>Live node map with side panel, search, and context actions</td>\n</tr>\n<tr>\n<td><strong>Communications</strong></td>\n<td>Channel and direct messaging with path history</td>\n</tr>\n<tr>\n<td><strong>Node Analysis</strong></td>\n<td>Detailed stats, telemetry, neighbours for</td>\n</tr>\n<tr>\n<td>…</td>\n<td></td>\n</tr>\n</tbody></table>\n"
    }
  ],
  "changelogSource": "github",
  "changelogUpdatedAt": "2026-06-23T21:29:39.341Z"
}