{"id":18327889,"url":"https://github.com/theengs/gateway-snap","last_synced_at":"2025-04-06T01:32:13.603Z","repository":{"id":46824967,"uuid":"514800809","full_name":"theengs/gateway-snap","owner":"theengs","description":"Theengs Gateway packaged as a snap","archived":false,"fork":false,"pushed_at":"2024-02-11T17:51:57.000Z","size":69,"stargazers_count":4,"open_issues_count":3,"forks_count":1,"subscribers_count":4,"default_branch":"development","last_synced_at":"2025-03-21T15:11:03.680Z","etag":null,"topics":["ble","home-assistant","home-automation","iot","mqtt","smarthome","snap","snapcraft"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/theengs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-07-17T09:33:37.000Z","updated_at":"2023-09-07T19:07:20.000Z","dependencies_parsed_at":"2024-01-17T19:15:53.225Z","dependency_job_id":"8174b02e-409e-40b4-ab51-3339f3dcdbc1","html_url":"https://github.com/theengs/gateway-snap","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fgateway-snap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fgateway-snap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fgateway-snap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fgateway-snap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theengs","download_url":"https://codeload.github.com/theengs/gateway-snap/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247423477,"owners_count":20936621,"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":["ble","home-assistant","home-automation","iot","mqtt","smarthome","snap","snapcraft"],"created_at":"2024-11-05T19:12:32.814Z","updated_at":"2025-04-06T01:32:12.098Z","avatar_url":"https://github.com/theengs.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build status](https://github.com/theengs/gateway-snap/workflows/Build/badge.svg)](https://github.com/theengs/gateway-snap/actions)\n[![Check status](https://github.com/theengs/gateway-snap/workflows/Check/badge.svg)](https://github.com/theengs/gateway-snap/actions)\n[![GitHub license](https://img.shields.io/github/license/theengs/gateway-snap.svg)](https://github.com/theengs/gateway-snap/blob/development/LICENSE)\n[![theengs-gateway](https://snapcraft.io/theengs-gateway/badge.svg)](https://snapcraft.io/theengs-gateway)\n![amd64](https://img.shields.io/badge/amd64-yes-green.svg)\n![arm64](https://img.shields.io/badge/arm64-yes-green.svg)\n![armhf](https://img.shields.io/badge/armhf-yes-green.svg)\n\n# Theengs Gateway Snap\n\n[Theengs Gateway](https://github.com/theengs/gateway) packaged as a snap.\n\n## How to install\n\n[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-white.svg)](https://snapcraft.io/theengs-gateway)\n\nYou can install the snap on amd64, arm64 and armhf systems with:\n\n```shell\nsnap install theengs-gateway\n```\n\nIf you're running this on Ubuntu Core on a Raspberry Pi, also install the following snaps for Bluetooth:\n\n```shell\nsnap install bluez pi-bluetooth\n```\n\n## How to configure\n\nFirst give the snap access to Bluetooth:\n\n```shell\nsnap connect theengs-gateway:bluez-client :bluez\n```\n\nIf you're running the snap on Ubuntu Core, this command needs to be:\n\n```shell\nsnap connect theengs-gateway:bluez-client bluez:service\n```\n\nYou can show the snap's configuration with:\n\n```shell\n$ snap get -d theengs-gateway\n{\n        \"bindkeys\": \"\",\n        \"ble\": {\n                \"adapter\": \"\",\n                \"enable\": 1,\n                \"scan-duration\": 5,\n                \"time-between\": 5\n        },\n        \"general-presence\": 0,\n        \"ha\": {\n                \"discovery\": 1,\n                \"discovery-device-name\": \"TheengsGateway\",\n                \"discovery-filter\": \"IBEACON\",\n                \"discovery-topic\": \"homeassistant/sensor\",\n                \"hass-discovery\": 1\n        },\n        \"identities\": \"\",\n        \"log-level\": \"INFO\",\n        \"mqtt\": {\n                \"enable-tls\": 0,\n                \"enable-ws\": 0,\n                \"host\": \"\",\n                \"pass\": \"\",\n                \"port\": 1883,\n                \"pub-topic\": \"home/TheengsGateway/BTtoMQTT\",\n                \"lwt-topic\": \"home/TheengsGateway/LWT\",\n                \"sub-topic\": \"home/+/BTtoMQTT/undecoded\",\n                \"publish-advdata\": 0,\n                \"user\": \"\"\n        },\n        \"time-sync\": {\n                \"addresses\": \"\",\n                \"format\": 0\n        },\n        \"presence\": {\n                \"topic\": \"home/TheengsGateway/presence\",\n                \"enable\": 0\n        },\n        \"tracker-timeout\": 120\n}\n```\n\nYou need to set at least the MQTT configuration, for instance:\n\n```shell\nsnap set theengs-gateway mqtt.host=MYBROKER mqtt.user=MYUSER mqtt.pass=MYPASS\n```\n\nHave a look at [Theengs Gateway's documentation](https://gateway.theengs.io/use/use.html#details-options) for the meaning of all configuration options.\n\nAfter changing the configuration, Theengs Gateway should now run as a service. If you want it to start automatically after booting your Linux distribution, enable the service with:\n\n```shell\nsnap start --enable theengs-gateway\n```\n\nHave a look at the snap's logs to troubleshoot problems:\n\n```shell\nsnap logs theengs-gateway -f\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheengs%2Fgateway-snap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheengs%2Fgateway-snap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheengs%2Fgateway-snap/lists"}