{"id":13834490,"url":"https://github.com/mpolitze/thingsboard-homematic-client","last_synced_at":"2025-07-10T04:32:15.014Z","repository":{"id":150468566,"uuid":"200084603","full_name":"mpolitze/thingsboard-homematic-client","owner":"mpolitze","description":null,"archived":false,"fork":false,"pushed_at":"2022-11-20T19:09:11.000Z","size":24,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-05T14:15:28.286Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/mpolitze.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}},"created_at":"2019-08-01T16:28:17.000Z","updated_at":"2022-11-15T22:12:48.000Z","dependencies_parsed_at":"2023-07-28T13:00:53.051Z","dependency_job_id":null,"html_url":"https://github.com/mpolitze/thingsboard-homematic-client","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpolitze%2Fthingsboard-homematic-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpolitze%2Fthingsboard-homematic-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpolitze%2Fthingsboard-homematic-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mpolitze%2Fthingsboard-homematic-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mpolitze","download_url":"https://codeload.github.com/mpolitze/thingsboard-homematic-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225618850,"owners_count":17497591,"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":"2024-08-04T14:00:35.695Z","updated_at":"2024-11-20T19:32:04.985Z","avatar_url":"https://github.com/mpolitze.png","language":"Python","funding_links":[],"categories":["Integrations"],"sub_categories":["IoT systems"],"readme":"# Thingsboard-HomematicIP Bridge\n\nPull changes from Homematic IP Access Point / Cloud and push them into Thingsboard via REST API.\n\nThe latest build is avialable as a container running a cron job to push the values every 10 minutes.\n\nIf you need more freuquent updates you have to modify the crontab in the container or build your own image. Please be gentile to the Homematic IP API!\n\n## Setup with container\n\n1. Follow steps below to create a working `config.ini`\n2. Create a volume to store the config `podman volume create thingsboard-homematic-client-config`\n3. Copy the contents of the `config.ini` to the volume `podman run -it --rm -v thingsboard-homematic-client-config:/config ghcr.io/mpolitze/thingsboard-homematic-client:latest vi /config/config.ini`\n4. Run the container as deamon `podman run -d --name thingsboard-homematic-client -v thingsboard-homematic-client-config:/config ghcr.io/mpolitze/thingsboard-homematic-client:latest`\n\n## Development\n\nYou can run the bridge in a local virtual environment, in a standard python container or use the lates released container image from `ghcr.io/mpolitze/thingsboard-homematic-client:latest`. Setup for virtual environment is below.\n\n### Run development container\n\n```sh\npodman run -it --rm -v${PWD}:/root/src python:alpine /bin/sh\n```\n\n### Create virtual environment\n\n```sh\npython3 -m venv .env\n```\n\n### Activate virtual environment\n\n(Windows)\n```sh\n.env\\Scripts\\activate\n```\n\n(Linux)\n```sh\nsource .env/bin/activate\n```\n\n### Install required packages\n\n(Build dependencies for alpine)\n```sh\napk add --update --no-cache --virtual .build-deps gcc musl-dev git\n```\n\n```sh\npip3 install -r requirements.txt\n```\n\n### Register with HmIP Access Point\n\n```sh\npython3 .env/Scripts/hmip_generate_auth_token.py\n```\n\n### Add Thingsboard configuration to config.ini\n\n```ini\n[TB]\nurl = \u003e\u003e\u003ethingsboard url here\u003c\u003c\u003c\nrootDeviceId = \u003e\u003e\u003eroot deivce id here\u003c\u003c\u003c\nusername = \u003e\u003e\u003eusername here\u003c\u003c\u003c\npassword = \u003e\u003e\u003epassword here\u003c\u003c\u003c\n```\n\n### Run bridge\n```sh\npython3 ./src/main.py\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmpolitze%2Fthingsboard-homematic-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmpolitze%2Fthingsboard-homematic-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmpolitze%2Fthingsboard-homematic-client/lists"}