{"id":15022072,"url":"https://github.com/mictronics/meshtastic2hass","last_synced_at":"2025-04-12T06:06:11.922Z","repository":{"id":217926086,"uuid":"742936763","full_name":"Mictronics/meshtastic2hass","owner":"Mictronics","description":"A Python client for use with Meshtastics devices that forwards telemetry and position messages to Home Assistant (Hass) via MQTT.","archived":false,"fork":false,"pushed_at":"2025-03-10T15:34:58.000Z","size":75,"stargazers_count":31,"open_issues_count":1,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-12T06:06:11.030Z","etag":null,"topics":["hass","home-assistant","meshtastic","mqtt","mqtt-client"],"latest_commit_sha":null,"homepage":"https://www.mictronics.de","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mictronics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-01-13T20:09:01.000Z","updated_at":"2025-03-10T15:35:05.000Z","dependencies_parsed_at":"2024-01-21T12:23:37.047Z","dependency_job_id":"2fe8d41e-95a1-4446-9142-d645d5425dde","html_url":"https://github.com/Mictronics/meshtastic2hass","commit_stats":{"total_commits":48,"total_committers":2,"mean_commits":24.0,"dds":0.02083333333333337,"last_synced_commit":"a99c06a3c07a60225b2bb48670109bddf5a272d2"},"previous_names":["mictronics/meshtastic2hass"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mictronics%2Fmeshtastic2hass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mictronics%2Fmeshtastic2hass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mictronics%2Fmeshtastic2hass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mictronics%2Fmeshtastic2hass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mictronics","download_url":"https://codeload.github.com/Mictronics/meshtastic2hass/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248525144,"owners_count":21118618,"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":["hass","home-assistant","meshtastic","mqtt","mqtt-client"],"created_at":"2024-09-24T19:57:25.102Z","updated_at":"2025-04-12T06:06:11.895Z","avatar_url":"https://github.com/Mictronics.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Meshtastic to Home Assistant (Hass)\n\nA Python client for use with Meshtastic devices. The client connects to a mesh radio via USB serial port. Telemetry and position messages from the mesh are published to an MQTT broker and further into Home Assistant. All MQTT entities will by auto discovered in Home Assistant.\n\n## Usage\n\n```bash\nusage: meshtastic2hass [-h] [--config CONFIG] [--dev DEV] [--mqtt-host MQTT_HOST] [--mqtt-port MQTT_PORT] [--mqtt-user MQTT_USER]\n                       [--mqtt-password MQTT_PASSWORD] [--mqtt-topic-prefix MQTT_TOPIC_PREFIX] [--use-network USE_NETWORK]\n                       [--hostname HOSTNAME] [--version]\n\nConnects Meshtastic radios via MQTT to Home Assistant (Hass).\n\noptions:\n  -h, --help            show this help message and exit\n  --config CONFIG       Path to configuration file in TOML format.\n  --dev DEV             The device the Meshtastic device is connected to, i.e. /dev/ttyUSB0\n  --mqtt-host MQTT_HOST\n                        The MQTT broker host name or IP.\n  --mqtt-port MQTT_PORT\n                        The MQTT broker port.\n  --mqtt-user MQTT_USER\n                        The MQTT broker user name.\n  --mqtt-password MQTT_PASSWORD\n                        The MQTT broker password.\n  --mqtt-topic-prefix MQTT_TOPIC_PREFIX\n                        The MQTT topic prefix\n  --use-network USE_NETWORK\n                        Use network connection to Meshtastic interface instead of serial\n  --hostname HOSTNAME   Meshtastic interface network hostname or IP\n  --version             show programs version number and exit\n```\n## Node Filter\n\nBy default all received Meshtastic nodes will create entities in Home Assistant.\n\nThis might be an undesired behavior when only some nodes are of interest. A node filter can be defined in config.toml.\n\n`filter_nodes = []` takes a set of Meshtastic nodes short names to be includes in filter. Only these nodes will be forwarded to home assistant via MQTT topic, hence creating entities. Keep empty to forward all nodes.\n\nReceiving channels text from nodes is not filtered at all.\n\n## Install packages with pip and requirements.txt\n\nThe following command installs packages in bulk according to the configuration file, requirements.txt. In some environments, use pip3 instead of pip.\n\n`pip install -r requirements.txt`","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmictronics%2Fmeshtastic2hass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmictronics%2Fmeshtastic2hass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmictronics%2Fmeshtastic2hass/lists"}