{"id":37140796,"url":"https://github.com/peprolinbot/tg-ha-door","last_synced_at":"2026-01-14T16:30:09.683Z","repository":{"id":304719395,"uuid":"1019719509","full_name":"peprolinbot/tg-ha-door","owner":"peprolinbot","description":"A simple Telegram bot to allow controlling a Home Assistant garage door.","archived":false,"fork":false,"pushed_at":"2025-08-12T14:24:43.000Z","size":182,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-01T12:39:45.069Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/peprolinbot.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":"2025-07-14T19:03:31.000Z","updated_at":"2025-08-12T14:24:46.000Z","dependencies_parsed_at":"2025-07-14T23:50:49.483Z","dependency_job_id":"efdb215d-da4e-4efb-b4ac-446164a19589","html_url":"https://github.com/peprolinbot/tg-ha-door","commit_stats":null,"previous_names":["peprolinbot/tg-ha-door"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/peprolinbot/tg-ha-door","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peprolinbot%2Ftg-ha-door","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peprolinbot%2Ftg-ha-door/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peprolinbot%2Ftg-ha-door/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peprolinbot%2Ftg-ha-door/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peprolinbot","download_url":"https://codeload.github.com/peprolinbot/tg-ha-door/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peprolinbot%2Ftg-ha-door/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28425945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T15:24:48.085Z","status":"ssl_error","status_checked_at":"2026-01-14T15:23:41.940Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-14T16:30:08.927Z","updated_at":"2026-01-14T16:30:09.654Z","avatar_url":"https://github.com/peprolinbot.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./logo.png\" alt=\"Logo\" width=\"150\"/\u003e\n\n\u003cbr\u003e\n\n![GitHub License](https://img.shields.io/github/license/peprolinbot/tg-ha-door?style=for-the-badge\u0026color=orange) ![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/peprolinbot/tg-ha-door?style=for-the-badge) [![built with nix](https://builtwithnix.org/badge.svg)](https://builtwithnix.org)\n\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/peprolinbot/tg-ha-door/docker.yaml?style=for-the-badge\u0026label=Docker%20Build)\n\n\u003c/div\u003e\n\n# tg-ha-door\n\nA simple Telegram bot written in [Go] with [go-telegram] to allow multiple people (e.g. your family) controlling a [Home Assistant] garage door.\n\n## 🔧 Deploy it\n\n### 🐳 Docker (Recommended)\n\nThis is quick, easy and simple. Just run these command replacing the variables as appropiate:\n\n```bash\ndocker run -d --name tg-ha-door \\\n    -e TG_BOT_TOKEN=4839574812:AAFD39kkdpWt3ywyRZergyOLMaJhac60qc \\\n    -e TG_KEY_CHAT_ID=123456 \\\n    -e TG_LOG_CHAT_ID=654321 \\\n    -e HA_URL=http://homeassistant.local:8123 \\\n    -e HA_AUTH_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJOZXZlciBnb25uYSBnaXZlIHlvdSB1cCIsImlhdCI6MTIzNDU2NzgsImV4cCI6ODc2NTQzMjEsImhlbGxvIjoiR29vZCB0cnkifQ.VMlDF1fNNGkChoDc7vUgtazEq4xjSBcnj0sDr4Y5_-U \\\n    -e HA_DOOR_ENTITY_ID=cover.garage_door \\\n    -e DOOR_OPEN_CLOSE_TIME=60 \\\n    ghcr.io/peprolinbot/tg-ha-door\n```\n\n### ❄️ Nix package\n\nIf you use [NixOS] or have [Nix] installed, you can easily use the flake in this repo, which includes a package and a NixOS module ([search its options here](https://peprolinbot.github.io/tg-ha-door)). Be sure to set all the required environment variables. You can, for example, do:\n\n```bash\nnix run github:peprolinbot/tg-ha-door\n```\n\n### Environment Variables\n\n| Name             | Description                                                                                                                                                                                                                           | Required? |\n|-----------|-----------------------------------------------------------------------------------------------------------------------|----------|\n| `TG_BOT_TOKEN` | The token you obtained from @BotFather ([more info](https://core.telegram.org/bots/tutorial#obtain-your-bot-token))         | Yes             |\n| `TG_KEY_CHAT_ID` | Id of the chat (channel probably) whose members should be allowed to use the bot (no one else can)                                                       | Yes             |\n| `TG_LOG_CHAT_ID` | Id of the channel where all the events will be logged       (feature will be disabled if not set)                                                               | No                |\n| `HA_URL`  |  URL of the Home Assistant instance to use, e.g. `http://homeassistant.local:8123`                                                                                                 | Yes             |\n| `HA_AUTH_TOKEN`  |  Token used to authenticate against the Home Assistant instance (Long-lived acces token is recommended)                                        | Yes              |\n| `HA_DOOR_ENTITY_ID`  |  The door's (which must be of cover type) entity_id in Home Assistant, e.g. `cover.garage_door`                                                 | Yes              |\n| `DOOR_OPEN_CLOSE_TIME`  |  The time (in seconds) to wait between the Open and Close commands when using the automatic Open and Close button                              | Yes              |\n\n_**Tip💡:**_ You can use a [Home Assistant cover template](https://www.home-assistant.io/integrations/template/#cover) if your door isn't shown as a cover\n\n#### Build the image\n\nYou will need [Nix] installed with flakes support\n\n```bash\ngit clone https://github.com/peprolinbot/tg-ha-door\ncd tg-ha-door\nnix build .#docker # This will build for the current architecture\ndocker load \u003c ./result\ndocker images # You should see the loaded image\n```\n\n## 💪🏻 Development\n\nYou will need [Nix] installed with flakes support, and the included `devShell` will take care of the rest\n\n```bash\ngit clone https://github.com/peprolinbot/tg-ha-door\ncd tg-ha-door\nnix develop\ngo run . # For example\n```\n\n[Go]:https://go.dev/\n[go-telegram]:https://github.com/go-telegram\n[Home Assistant]: https://www.home-assistant.io\n[Nix]: https://nixos.org/download/#download-nix\n[NixOS]: https://nixos.org/download/#download-nix\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeprolinbot%2Ftg-ha-door","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeprolinbot%2Ftg-ha-door","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeprolinbot%2Ftg-ha-door/lists"}