{"id":25323813,"url":"https://github.com/suddengunter/hsd","last_synced_at":"2025-04-07T23:40:52.085Z","repository":{"id":275371710,"uuid":"920306446","full_name":"SuddenGunter/hsd","owner":"SuddenGunter","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-17T00:23:50.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T01:28:08.220Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/SuddenGunter.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}},"created_at":"2025-01-21T23:13:23.000Z","updated_at":"2025-03-17T00:23:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"f50b45d7-0112-4ebf-873a-14db197bc722","html_url":"https://github.com/SuddenGunter/hsd","commit_stats":null,"previous_names":["suddengunter/hsd"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuddenGunter%2Fhsd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuddenGunter%2Fhsd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuddenGunter%2Fhsd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SuddenGunter%2Fhsd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SuddenGunter","download_url":"https://codeload.github.com/SuddenGunter/hsd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247749976,"owners_count":20989712,"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":[],"created_at":"2025-02-14T00:54:39.859Z","updated_at":"2025-04-07T23:40:52.080Z","avatar_url":"https://github.com/SuddenGunter.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hsd\n\nHome security daemon:\n\n- uses door/window sensor information from zigbee2mqtt and sends alerts to telegram chat.\n- has an API to enable/disable telegram alerts.\n\n## Supported sensors\n\nI only own Aqara Door and Window Sensor T1, so this is  the only supported sensor. Feel free to send PRs to support more devices.\n\n## Note on zigbee2mqtt version compitability\n\nZigbee2MQTT 2.0 broke backward compitability for it's `*/availability` topics, but this app supports both v1 and v2 versions of messages.\n\n## How to run locally (for development)\n\ndocker-compose.yaml and Taskfile.yaml already have most of the stuff you need to start the app, just add your Telegram information to either `hsd.env` file, or just into Taskfile.yaml.\n\n`hsd.env` file example:\n\n```dotenv\nTELEGRAM_BOT_TOKEN=VALUE\nTELEGRAM_CHAT_ID=VALUE\n```\n\nIt's ok for telegram chat id to be a negative integer (don't ask me why, ask telegram developers).\n\nThen run with\n\n```sh\ndocker compose up -d\ntask run\n```\n\nIf everything is configured correctly, you should see `app started` in logs. Now we can do short end-to-end test by running:\n\n```sh\nmosquitto_pub --username hsd --pw hsd --topic 'zigbee2mqtt/door1/availability'  -m 'offline' -h localhost\n```\n\nBot will send a telegram notification to your chat after this (or crashes with some error in logs that could help you debug things).\n\n## How to deploy\n\nPackage into a docker image and ship to your server. Or use one of the tagged images from this repo artifacts.\n\n## TODO \n\n- proper documentation\n- zigbee2mqtt button support to enable/disable alerts\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuddengunter%2Fhsd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuddengunter%2Fhsd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuddengunter%2Fhsd/lists"}