{"id":29242745,"url":"https://github.com/kabili207/matrix-meshtastic","last_synced_at":"2025-08-25T16:06:16.665Z","repository":{"id":294357810,"uuid":"973293827","full_name":"kabili207/matrix-meshtastic","owner":"kabili207","description":"A bridge between the Matrix and Meshtastic networks","archived":false,"fork":false,"pushed_at":"2025-06-28T05:39:36.000Z","size":602,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-28T06:28:52.869Z","etag":null,"topics":["bridge","matrix","mautrix","mautrix-go","meshtastic"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kabili207.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-26T17:18:54.000Z","updated_at":"2025-06-28T05:39:39.000Z","dependencies_parsed_at":"2025-06-28T06:23:30.248Z","dependency_job_id":null,"html_url":"https://github.com/kabili207/matrix-meshtastic","commit_stats":null,"previous_names":["kabili207/matrix-meshtastic"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kabili207/matrix-meshtastic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kabili207%2Fmatrix-meshtastic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kabili207%2Fmatrix-meshtastic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kabili207%2Fmatrix-meshtastic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kabili207%2Fmatrix-meshtastic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kabili207","download_url":"https://codeload.github.com/kabili207/matrix-meshtastic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kabili207%2Fmatrix-meshtastic/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263401149,"owners_count":23461054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bridge","matrix","mautrix","mautrix-go","meshtastic"],"created_at":"2025-07-03T20:35:25.278Z","updated_at":"2025-07-03T20:35:33.815Z","avatar_url":"https://github.com/kabili207.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# matrix-meshtastic\nA Matrix-Meshtastic bridge based on [meshtastic-go](https://github.com/meshnet-gophers/meshtastic-go).\n\nThis bridge creates virtual Meshtastic nodes rather than using a real device and thus requires either a functioning\nMQTT server or a physical node with Mesh over UDP enabled.\n\n## Documentation\n\n### Setup\nThe official Mautrix setup covers most of the generic options [Bridge setup](https://docs.mau.fi/bridges/go/setup.html)\n(or [with Docker](https://docs.mau.fi/bridges/general/docker-setup.html))\n\nThe following options are specific to the Meshtastic bridge and all of them are required.\n\n```yaml\n# Network-specific config options\nnetwork:\n    # The full name of the bridge on the Meshtastic network.\n    # Must be less than 40 bytes\n    long_name: \"Matrix Bridge\"\n    # A VERY short name for use on tiny OLED screens\n    # Must be less than 5 bytes\n    short_name: \"MB\"\n    # Primary channel. This will be used to broadcast and receive node info,\n    # location updates, and unencrypted DMs between nodes. Should be left as\n    # the default LongFast with the \"AQ==\" key\n    primary_channel:\n        name: LongFast\n        key: \"1PG7OiApB1nwvP+rz05pAQ==\"\n    # Enable the UDP (Mesh over LAN) connection\n    udp: true\n    # Credentials for connecting to the MQTT server\n    # Using the public MQTT server is not advised due to various limitations\n    mqtt:\n        enabled: true\n        server: tcp://mqtt.example.com:1883\n        username: meshdev\n        password: large4cats\n        root_topic: msh/US\n```\n### General Use\nThe general use instructions [from Mautrix](https://docs.mau.fi/bridges/general/using-bridges.html)\n\n#### Logging in\nAlthough not required in order to chat in existing bridged rooms, you will not be able\nDM users on Meshtastic or bridge new channels unless you login.\n\nTo do so, send a direct message to the Meshtastic bot user (typically `@meshtastic_bot:example.com`)\nand use the `login` command. You will be prompted for the long and short names you wish to use\non the Meshtastic network. Your Meshtastic Node ID will be generated based on your matrix user ID.\n\n#### Joining a channel\nChannels on Meshtastic are based on the name of the channel and a pre-shared key (PSK). To join a\nchannel, message the bot user and use the `join-channel` command, passing both the name and PSK like so:\n`join-channel LongFast 1PG7OiApB1nwvP+rz05pAQ==`\n\n### Recommended Config Settings\n\nThe following additional config options are recommended. If you do enable relaying, it is strongly advised\nthat you enable the `commands` permissions for everyone, as it allows them to set the long and short names\nused on the Meshtastic network.\n\n```yaml\nbridge:\n    relay:\n        enabled: true\n        message_formats:\n            m.text: \"{{ .Message }}\"\n            m.notice: \"{{ .Message }}\"\n            m.emote: \"{{ .Message }}\"\n        displayname_format: \"{{ .DisambiguatedName }}\"\n    permissions:\n        \"*\": commands\n        \"example.com\": user\n        \"@admin:example.com\": admin\n```\n\n### Features \u0026 Roadmap\n[ROADMAP.md](ROADMAP.md) contains a general overview of what is supported by the bridge.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkabili207%2Fmatrix-meshtastic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkabili207%2Fmatrix-meshtastic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkabili207%2Fmatrix-meshtastic/lists"}