{
  "id": "meshcore-proxy",
  "name": "MeshCore Proxy",
  "kind": "utility",
  "status": "active",
  "maturity": "stable",
  "description": "TCP proxy that enables remote access to a locally-connected MeshCore companion radio. Connects to a MeshCore radio via USB serial or Bluetooth LE and exposes it over TCP, allowing remote clients like meshcore-cli, Home Assistant, and MeshCore apps to interact with the radio as if directly connected.",
  "maintainers": [
    {
      "name": "rgregg",
      "url": "https://github.com/rgregg"
    }
  ],
  "repository": "https://github.com/rgregg/meshcore-proxy",
  "license": "MIT",
  "languages": [
    "python"
  ],
  "platforms": [
    "linux",
    "macos",
    "windows"
  ],
  "interfaces": [
    "cli"
  ],
  "connections": [
    "serial",
    "usb",
    "ble",
    "tcp"
  ],
  "node_roles": [
    "companion"
  ],
  "capabilities": [
    "proxying"
  ],
  "install": [
    {
      "type": "pypi",
      "package": "meshcore-proxy",
      "url": "https://pypi.org/project/meshcore-proxy/",
      "command": "pipx install meshcore-proxy"
    },
    {
      "type": "source",
      "url": "https://github.com/rgregg/meshcore-proxy"
    }
  ],
  "popularity": {
    "githubStars": 37,
    "githubForks": 10,
    "githubWatchers": 2,
    "githubOpenIssues": 9,
    "githubContributors": 3,
    "lastChecked": "2026-07-21",
    "releaseDownloads": 0,
    "latestReleaseDownloads": 0
  },
  "verification": {
    "sourceAvailable": true,
    "releasesAvailable": true,
    "signedReleases": false,
    "ciBuilds": true,
    "hasDocumentation": true,
    "lastChecked": "2026-07-21",
    "notes": [
      "Exposes USB/BLE companion radios over TCP for remote access.",
      "Compatible with meshcore-cli, Home Assistant integration, and MeshCore apps.",
      "Available on PyPI as meshcore-proxy."
    ]
  },
  "tags": [
    "proxy",
    "tcp",
    "remote-access"
  ],
  "last_reviewed": "2026-07-03",
  "source": {
    "path": "data/software/meshcore-proxy/software.yaml",
    "updatedAt": "2026-07-21T08:04:18Z"
  },
  "latest_version": "0.4.0",
  "released": "2026-01-17",
  "releases": [
    {
      "version": "v0.4.0",
      "name": "0.4 - First Friday",
      "datetime": "2026-01-17T04:47:13Z",
      "url": "https://github.com/rgregg/meshcore-proxy/releases/tag/v0.4.0",
      "prerelease": false,
      "notes": "Mainstream release for easier installation",
      "notesHtml": "<p>Mainstream release for easier installation</p>\n"
    },
    {
      "version": "v0.3.3-alpha",
      "name": "0.3.3-alpha - First Friday",
      "datetime": "2026-01-17T04:28:46Z",
      "url": "https://github.com/rgregg/meshcore-proxy/releases/tag/v0.3.3-alpha",
      "prerelease": false,
      "notes": "## What's Changed\r\n* Add signal handling for graceful Docker shutdown by @Copilot in https://github.com/rgregg/meshcore-proxy/pull/2\r\n* Fix BLEConnection AttributeError on disconnect handler setup by @Copilot in https://github.com/rgregg/meshcore-proxy/pull/4\r\n* Fix PyPI release pipeline with dynamic versioning from git tags by @Copilot in https://github.com/rgregg/meshcore-proxy/pull/6\r\n* Versioning is hard by @rgregg in https://github.com/rgregg/meshcore-proxy/pull/7\r\n\r\n## New Contributors\r\n* @Copilot made their first contribution in https://github.com/rgregg/meshcore-proxy/pull/2\r\n* @rgregg made their first contribution in https://github.com/rgregg/meshcore-proxy/pull/7\r\n\r\n**Full Changelog**: https://github.com/rgregg/meshcore-proxy/compare/v0.2.0-alpha...v0.3.3-alpha",
      "notesHtml": "<h2>What's Changed</h2>\n<ul>\n<li>Add signal handling for graceful Docker shutdown by @Copilot in <a href=\"https://github.com/rgregg/meshcore-proxy/pull/2\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/pull/2</a></li>\n<li>Fix BLEConnection AttributeError on disconnect handler setup by @Copilot in <a href=\"https://github.com/rgregg/meshcore-proxy/pull/4\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/pull/4</a></li>\n<li>Fix PyPI release pipeline with dynamic versioning from git tags by @Copilot in <a href=\"https://github.com/rgregg/meshcore-proxy/pull/6\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/pull/6</a></li>\n<li>Versioning is hard by @rgregg in <a href=\"https://github.com/rgregg/meshcore-proxy/pull/7\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/pull/7</a></li>\n</ul>\n<h2>New Contributors</h2>\n<ul>\n<li>@Copilot made their first contribution in <a href=\"https://github.com/rgregg/meshcore-proxy/pull/2\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/pull/2</a></li>\n<li>@rgregg made their first contribution in <a href=\"https://github.com/rgregg/meshcore-proxy/pull/7\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/pull/7</a></li>\n</ul>\n<p><strong>Full Changelog</strong>: <a href=\"https://github.com/rgregg/meshcore-proxy/compare/v0.2.0-alpha...v0.3.3-alpha\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/compare/v0.2.0-alpha...v0.3.3-alpha</a></p>\n"
    },
    {
      "version": "v0.2.0-alpha",
      "name": "0.2.0 - Midnight release",
      "datetime": "2026-01-16T07:51:46Z",
      "url": "https://github.com/rgregg/meshcore-proxy/releases/tag/v0.2.0-alpha",
      "prerelease": false,
      "notes": "Second release today - this one fixes a crash in the BLE stack on MacOS when exiting the app. Still lots of testing to perform, but the releases make it easier to test via docker and pipx.\r\n\r\n**Full Changelog**: https://github.com/rgregg/meshcore-proxy/compare/v0.1.0-alpha...v0.2.0-alpha",
      "notesHtml": "<p>Second release today - this one fixes a crash in the BLE stack on MacOS when exiting the app. Still lots of testing to perform, but the releases make it easier to test via docker and pipx.</p>\n<p><strong>Full Changelog</strong>: <a href=\"https://github.com/rgregg/meshcore-proxy/compare/v0.1.0-alpha...v0.2.0-alpha\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/compare/v0.1.0-alpha...v0.2.0-alpha</a></p>\n"
    },
    {
      "version": "v0.1.0-alpha",
      "name": "v0.1.0-alpha - First Release",
      "datetime": "2026-01-16T07:22:44Z",
      "url": "https://github.com/rgregg/meshcore-proxy/releases/tag/v0.1.0-alpha",
      "prerelease": false,
      "notes": "This is the initial release - tested with USB Serial and BLE on MacOS. Need to do more testing on other platforms.\r\n\r\n**Full Changelog**: https://github.com/rgregg/meshcore-proxy/commits/2026-01-15",
      "notesHtml": "<p>This is the initial release - tested with USB Serial and BLE on MacOS. Need to do more testing on other platforms.</p>\n<p><strong>Full Changelog</strong>: <a href=\"https://github.com/rgregg/meshcore-proxy/commits/2026-01-15\" target=\"_blank\" rel=\"noopener noreferrer\">https://github.com/rgregg/meshcore-proxy/commits/2026-01-15</a></p>\n"
    }
  ],
  "changelogSource": "github",
  "changelogUpdatedAt": "2026-07-05T17:14:41.927Z"
}