{"id":17366985,"url":"https://github.com/gabrielrf/controlid2telegram","last_synced_at":"2025-09-20T19:31:28.743Z","repository":{"id":81479828,"uuid":"149887955","full_name":"GabrielRF/ControlID2Telegram","owner":"GabrielRF","description":"Sends a text message everytime a door opens","archived":false,"fork":false,"pushed_at":"2020-02-23T15:27:14.000Z","size":669,"stargazers_count":6,"open_issues_count":2,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-31T11:23:39.264Z","etag":null,"topics":["controlid","docker","docker-compose","home-automation","idflex","synology","synology-docker","telegram","telegram-bot-api"],"latest_commit_sha":null,"homepage":"","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/GabrielRF.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":"2018-09-22T15:08:49.000Z","updated_at":"2024-07-04T12:16:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"08ad5ff8-0db2-4cc3-aaa5-a37c1777c5ac","html_url":"https://github.com/GabrielRF/ControlID2Telegram","commit_stats":{"total_commits":17,"total_committers":3,"mean_commits":5.666666666666667,"dds":"0.23529411764705888","last_synced_commit":"9f00f0fed3680019255c4136de6909bc04a81d28"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FControlID2Telegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FControlID2Telegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FControlID2Telegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GabrielRF%2FControlID2Telegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GabrielRF","download_url":"https://codeload.github.com/GabrielRF/ControlID2Telegram/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233682731,"owners_count":18713591,"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":["controlid","docker","docker-compose","home-automation","idflex","synology","synology-docker","telegram","telegram-bot-api"],"created_at":"2024-10-15T22:16:41.228Z","updated_at":"2025-09-20T19:31:23.425Z","avatar_url":"https://github.com/GabrielRF.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![](https://dockerbuildbadges.quelltext.eu/status.svg?organization=gabrielrf\u0026repository=controlid2telegram)](https://hub.docker.com/r/gabrielrf/controlid2telegram/builds/)\n\n# ControlID to Telegram\n\n![ControlID2Telegram](img/doorknock.gif)\n\n* [About](#about)\n* [Setup](#setup)\n  * [Docker Compose](#docker-compose)\n  * [Python](#python)\n* [Contribute](#contribute)\n* [Contact](#contact-me)\n\n## About \n\nControlID to Telegram is a Docker Container that sends a text message everytime a door is opened.\n\nIt works on a ControlID IDFlex (not sure if it works on other models) and on Telegram Messaging app.\n\n## Setup\n\n### Docker Compose\n\n```\ncontrolid2telegram:\n    image: gabrielrf/controlid2telegram\n    environment:\n        - BOT_TOKEN=\n        - ALERTS=1,2,3,4,5,6,7,8,9,10,11,12,13\n        - CONTROLID_IP=\n        - HOST_IP=\n        - CONTROLID_USER=\n        - CONTROLID_PASSWORD=\n        - WEBHOOK_HOST=0.0.0.0\n        - WEBHOOK_PORT=5432\n        - MESSAGE_DESTINATION=\n    ports:\n        - 5432:5432\n    restart: always\n```\n\n`BOT_TOKEN`: Telegram bot token provided by BotFather.\n\n`ALERTS`: Categories of alerts that will be sent.\n - 1: Invalid equipment\n - 2: Invalid parameters\n - 3: Not identified\n - 4: Pending ID\n - 5: Timeout\n - 6: Access denied\n - 7: Access granted\n - 8: Pending access\n - 9: User is not admin\n - 10: Unidentified access\n - 11: Access granted by button\n - 12: Access granted by web interface/API\n - 13: Entry canceled\n\n`CONTROLID_IP`: ControlID device ip.\n\n`HOST_IP`: Docker host ip.\n\n`CONTROLID_USER`: ControlID web user.\n\n`CONTROLID_PASSWORD`: ControlID web user password.\n\n`WEBHOOK_HOST`: Webhook host ip. Default is `0.0.0.0`.\n\n`WEBHOOK_PORT`: Webhook port. Any number between 1023 to 65535. \n\n`MESSAGE_DESTINATION`: Telegram User/Group/Channel ID that will receive messages.\n\n### Python\n\nFirst:\n\n```\npip install flask\npip install pytelegrambotapi\n```\n\nOpen `index.py` and fill the variables.\n\nThen:\n\n```\npython index.py\n```\n\n## Contribute\n\nPull Requests and issues are always welcome!\n\n## Contact me\n\n[GabRF.com](https://gabrf.com)\n\n[@GabrielRF](https://t.me/gabrielrf) on Telegram.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielrf%2Fcontrolid2telegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabrielrf%2Fcontrolid2telegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielrf%2Fcontrolid2telegram/lists"}