{"id":14985199,"url":"https://github.com/qbaware/homeassistant-eldom","last_synced_at":"2026-01-27T11:10:30.797Z","repository":{"id":255162858,"uuid":"848324901","full_name":"qbaware/homeassistant-eldom","owner":"qbaware","description":"Integrating Eldom smart boilers and convector heaters into Home Assistant","archived":false,"fork":false,"pushed_at":"2026-01-16T22:36:48.000Z","size":1179,"stargazers_count":12,"open_issues_count":6,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-17T11:24:58.829Z","etag":null,"topics":["convector","convector-heater","custom-integration","eldom","homeassistant","homeassistant-integration","smart-home","water-boiler","water-heater"],"latest_commit_sha":null,"homepage":"","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/qbaware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"buy_me_a_coffee":"danielgospodinow"}},"created_at":"2024-08-27T14:55:41.000Z","updated_at":"2026-01-16T22:36:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"d4ab0997-3ea6-40a3-b850-c630cabf138a","html_url":"https://github.com/qbaware/homeassistant-eldom","commit_stats":{"total_commits":30,"total_committers":1,"mean_commits":30.0,"dds":0.0,"last_synced_commit":"bf324d06c6013e3620a7f713a1fc5ec44ae832d1"},"previous_names":["qbaware/homeassistant-eldom"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/qbaware/homeassistant-eldom","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbaware%2Fhomeassistant-eldom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbaware%2Fhomeassistant-eldom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbaware%2Fhomeassistant-eldom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbaware%2Fhomeassistant-eldom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qbaware","download_url":"https://codeload.github.com/qbaware/homeassistant-eldom/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbaware%2Fhomeassistant-eldom/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28812371,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T07:41:26.337Z","status":"ssl_error","status_checked_at":"2026-01-27T07:41:08.776Z","response_time":168,"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":["convector","convector-heater","custom-integration","eldom","homeassistant","homeassistant-integration","smart-home","water-boiler","water-heater"],"created_at":"2024-09-24T14:10:30.083Z","updated_at":"2026-01-27T11:10:30.792Z","avatar_url":"https://github.com/qbaware.png","language":"Python","readme":"[![Discord](https://img.shields.io/discord/1312381782942810192?logo=discord\u0026labelColor=white\u0026label=Discord)](https://discord.gg/4sRmgb9Vph)\n[![hassfest](https://github.com/qbaware/homeassistant-eldom/actions/workflows/hassfest-validation.yaml/badge.svg?branch=main)](https://github.com/qbaware/homeassistant-eldom/actions/workflows/hassfest-validation.yaml)\n[![HACS-action](https://github.com/qbaware/homeassistant-eldom/actions/workflows/hacs-action-validation.yaml/badge.svg)](https://github.com/qbaware/homeassistant-eldom/actions/workflows/hacs-action-validation.yaml)\n\n---\n\n# Eldom Integration For Home Assistant\n\nConnect your [Eldom](https://eldominvest.com/en/index.html) devices to Home Assistant and operate them via Eldom's Cloud APIs with [pyeldom](https://github.com/qbaware/pyeldom).\n\n![eldom-integration](https://github.com/user-attachments/assets/d058d86b-0796-4d2f-b686-e9d4312ecd76)\n\n[![\"Buy Me A Coffee\"](https://buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/danielgospodinow), or you can just ⭐️ the repository. I'd love that too. :smile:\n\n---\n\n## ⚠️ Attention\n\nRelease [5.0.1](https://github.com/qbaware/homeassistant-eldom/releases/tag/5.0.1) contains a breaking change in the config flow. It requires you to re-add your account. This is **safe** for your existing automations and no negative impact is expected.\n\n## Supported devices\n\nCurrently, there's primarely support for devices that are managed by the `My Eldom` app (or the `myeldom.com` website).\n\nDevices that are managed via the `Eldom` app (or the `iot.myeldom.com` website) are in experimental support from release [5.0.1](https://github.com/qbaware/homeassistant-eldom/releases/tag/5.0.1). Some of the devices under experimentation are flat boilers and convector heaters.\n\n## Features\n\nThis integration allows you to control Eldom devices via Home Assistant.\n\nNote that there's only one way to control your Eldom devices - via their Cloud APIs. There's no support for local network control.\n\n#### 1. Flat boilers\n\n- Operational mode selection\n  - `Electric` (corresponds to \"Heating\")\n  - `Eco` (corresponds to \"Smart\")\n  - `High Demand` (corresponds to \"Study\")\n  - `Off`\n- Set target temperature\n- Display current temperature\n- Enable `Powerful mode` switch (only works while `Eco` mode is enabled)\n- Display sensors\n  - Heater is currently on/off\n  - Day energy consumption\n  - Night energy consumption\n  - Saved energy\n\n#### 2. Smart boilers\n\n- Operational mode selection\n  - `Electric` (corresponds to \"Heating\")\n  - `Eco` (corresponds to \"Smart\")\n  - `High Demand` (corresponds to \"Study\")\n  - `Off`\n- Set target temperature\n- Display current temperature\n- Enable `Powerful mode` switch (only works while `Eco` mode is enabled)\n- Display sensors\n  - Heater is currently on/off\n  - Day energy consumption\n  - Night energy consumption\n  - Saved energy\n\n#### 3. Naturela boilers\n\n- Operational mode selection\n  - `Electric` (corresponds to \"On\")\n  - `Eco` (corresponds to \"Holiday\")\n  - `Off`\n- Display current temperature\n- Enable `Powerful mode` switch (only works while the boiler is not off)\n- Display sensors\n  - Heater is currently on/off\n  - Day energy consumption\n  - Night energy consumption\n\n#### 4. Convector heaters\n\n- Operational mode selection\n  - `Heat`\n  - `Off`\n- Set target temperature\n- Display current temperature\n\n### Showcase\n\n![Flat boiler detailed view](./docs/flat-boiler-detailed-view-new.png)\n\n![Flat boiler main view](./docs/flat-boiler-main-view-new.png)\n\n## Installation\n\n### HACS Installation (Recommended)\n\n0. Install HACS if it's not already installed. Look at [this](https://www.youtube.com/watch?v=0hDyVoDGFbc) video.\n1. Open HACS.\n2. Select `Integrations`, then select the 3-dots in the upper-right corner, then select `Custom Repositories`.\n3. Put the reposity URL in the `Repository` field, then select `Integration` in the `Category` dropdown list and click `Add`.\n4. Now, you can search for `Eldom` in HACS and install the integration.\n5. After the installation, you need to restart Home Assistant.\n6. Now, you can proceed with [Usage](#usage).\n\nI've made a video tutorial on YouTube on how to do all this:\n\n[![Watch the video](https://img.youtube.com/vi/57qsCXNVMMA/hqdefault.jpg)](https://youtu.be/57qsCXNVMMA)\n\n### Custom components\n\n1. Download or clone the integration to your local machine.\n2. Navigate to the `custom_components` directory in your Home Assistant installation directory.\n3. Copy the folder `custom_components/eldom` from the downloaded integration to the Home Assistant `custom_components` directory.\n4. Restart Home Assistant.\n\n## Usage\n\n- After installation, go to `Settings \u003e Devices \u0026 services \u003e Add integration` and search for `Eldom`.\n- Provide an Eldom account `email` and `password` and click `Submit`.\n\n## Custom UI Card\n\nIf you find the default card boring, you can try out this custom one.\n\n![image](https://github.com/user-attachments/assets/623fef6c-1c99-4ec2-ae4e-e9db7400e784)\n\n\u003cdetails\u003e\n  \u003csummary\u003eYAML\u003c/summary\u003e\n  \n  ```yaml\n  features:\n    - type: target-temperature\n    - type: water-heater-operation-modes\n      operation_modes:\n        - \"off\"\n        - eco\n        - electric\n        - high_demand\n  type: tile\n  entity: water_heater.flat_boiler_edab63cb2b9c\n  color: primary\n  name: Flat Boiler\n  hide_state: false\n  show_entity_picture: false\n  vertical: true\n  state_content:\n    - state\n    - last-changed\n  ```\n\u003c/details\u003e\n\n## Community\n\nFor additional questions, you can head over to our [Discord channel](https://discord.gg/4sRmgb9Vph).\n","funding_links":["https://buymeacoffee.com/danielgospodinow","https://www.buymeacoffee.com/danielgospodinow"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqbaware%2Fhomeassistant-eldom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqbaware%2Fhomeassistant-eldom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqbaware%2Fhomeassistant-eldom/lists"}