{"id":39859283,"url":"https://github.com/faanskit/ha-checkwatt","last_synced_at":"2026-01-18T13:56:45.047Z","repository":{"id":214331678,"uuid":"731459810","full_name":"faanskit/ha-checkwatt","owner":"faanskit","description":"Home Assistant CheckWatt Integration","archived":false,"fork":false,"pushed_at":"2025-08-28T20:40:32.000Z","size":777,"stargazers_count":14,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-08-29T02:09:49.668Z","etag":null,"topics":["battery","checkwatt","frequency","hacs-integration","home-assistant","inverter","solar","solar-inverter"],"latest_commit_sha":null,"homepage":"https://github.com/faanskit/ha-checkwatt","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/faanskit.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":"2023-12-14T06:08:35.000Z","updated_at":"2025-08-28T20:38:21.000Z","dependencies_parsed_at":"2024-01-25T11:35:34.808Z","dependency_job_id":"5fb72755-1287-4682-8568-0c6e6c9e658b","html_url":"https://github.com/faanskit/ha-checkwatt","commit_stats":{"total_commits":128,"total_committers":4,"mean_commits":32.0,"dds":0.1796875,"last_synced_commit":"6dcea6be79f43024fd4e41f06f96af29aeb9f5f3"},"previous_names":["faanskit/ha-checkwatt"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/faanskit/ha-checkwatt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-checkwatt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-checkwatt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-checkwatt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-checkwatt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faanskit","download_url":"https://codeload.github.com/faanskit/ha-checkwatt/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faanskit%2Fha-checkwatt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28537478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T13:04:05.990Z","status":"ssl_error","status_checked_at":"2026-01-18T13:01:44.092Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["battery","checkwatt","frequency","hacs-integration","home-assistant","inverter","solar","solar-inverter"],"created_at":"2026-01-18T13:56:44.471Z","updated_at":"2026-01-18T13:56:45.023Z","avatar_url":"https://github.com/faanskit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Home Assistant CheckWatt Custom Integration\nThis integration uses cloud polling from the CheckWatt EnergyInbalance portal using a reverse engineered private API.\n\nThe strategy for this integration is to reduce the amount of sensors published while at the same time maximize the information available and provide them as attributes.\n\nThe integration also aims to balance the user needs for information with loads on CheckWatts servers why some data may not always be up-to date.\n\nOut-of-the box, this integration provides two sensors:\n- CheckWatt Daily Net Income : Your estimated net income today\n- CheckWatt Annual Net Income : Your estimated annual net income\n- Battery State of Charge: Your batterys state of charge\n\nThe Daily Net Income sensor also have an attribute that provides information about tomorrows estimated Net Income.\n\n![checkwatt main](/images/ha_main.png)\n\n# Known Issues and Limitations\n1. The integration uses undocumented API's used by the EnergyInBalance portal. These can change at any time and render this integration useless without any prior notice.\n2. The monetary information from EnergyInBalance is always provisional and can change before you receive your invoice from CheckWatt.\n3. The annual yeild sensor includes today's and tomorrow's estimated net income.\n4. CheckWatt EnergyInBalance does not (always) provide Grid In/Out information. Why it is recommended to use other data sources for your Energy Panel.\n5. The FCR-D state and status is pulled from a logbook parameter within the API and is a very fragile piece of information. Use with care.\n6. The integration will update the Energy sensors once per minute, the Daily Net Income sensor once every fifteenth minute and the Annual Net Income around 2 am every morning. This to not put too much stress on the CheckWatt servers (the net income operation is slow resource heavy)\n\n# Installation\n### HACS installation\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=faanskit\u0026repository=ha-checkwatt\u0026category=integration)\n\n\n### Git installation\n1. Make sure you have git installed on your machine.\n2. Navigate to you home assistant configuration folder.\n3. Create a `custom_components` folder of it does not exist, navigate down into it after creation.\n4. Execute the following command: `git clone https://github.com/faanskit/ha-checkwatt.git checkwatt`\n5. Restart Home-Assistant.\n\n## Enable the integration\nGo to Settings / Devices \u0026 Services / Integrations. Click **+ ADD INTEGRATION**\n\nFind CheckWatt from the list of available brands:\n\n![checkwatt config step 1](/images/configure_step_1.png)\n\nEnter your EnergyInBalance credentials and press **SUBMIT**:\n\nTake note that Home Assistant will store your credentials and if this is a security concern for you, abort at this stage.\n\n![checkwatt config step 2](/images/configure_step_2.png)\n\nThe integration will now install and assuming it all went well you will get a success message and the possibility to add its sensors to an area of your choice.\n\n![checkwatt config step 3](/images/configure_step_3.png)\n\nOn your Overview you will now have two new sensors in a new group:\n\n![checkwatt config done](/images/configure_done.png)\n\nThese sensors will show you your estimated daily and annual net income alongside with some basic attributes like Street Address, Zip Code and City.\n\nThe Daily Net Income sensor will also show tomorrows estimated net income as an attribute.\n\n![checkwatt basic daily](/images/basic_sensor_daily.png)\n![checkwatt basic annual](/images/basic_sensor_annual.png)\n\n\n## Configuration\nThe integration provides basic sensors for most peoples needs. The integration can also be a one-stop-shop for the Home Assistant Energy panel and can therefore be configured to also fetch all required data for that from EnergyInBalance.\n\nFor those who need additional information, detailed attributes can be provided by configuring the integration accordingly. Through the detailed sensors you can get gross revenue, fees, fee rates, FCR-D status and much more.\n\nIf you need more sensor and more detailed attributes in the sensors,  configure the integration as follows.\n\nGo to Settings / Devices \u0026 Services / CheckWatt. Click **CONFIGURE**:\n\n![checkwatt options step 1](/images/options_step_1.png)\n\nSelect if you want the integration to provide energy sensors and if detailed attributes shall be provided.\n\nPress **SUBMIT** and the configurations will be stored:\n\n![checkwatt options step 2](/images/options_step_2.png)\n\nAfter the configuration is done you need to restart the integration. Click **...** and select **Reload**\n![checkwatt options step 3](/images/options_step_3.png)\n\nAfter the system as reload you will have 1 device and 9 sensors available.\n![checkwatt options done](/images/options_done.png)\n\nYour sensors will now also contain a lot of detailed attributes.\n![checkwatt detailed daily](/images/detailed_sensor_daily.png)\n![checkwatt detailed annual](/images/detailed_sensor_annual.png)\n\n## Setting up Energy Panel\nWith the energy sensors provided by the integration, it is possible to configure the Home Assistant Energy Panel. The Energy panel is available on the left-hand menu of Home Assistant by default.\n\nWhen you enter the energy panel the first time you will be guided by a Wizard:\n\n![checkwatt energy step 1](/images/energy_step_1.png)\n\nFor the Grid Consumption, select the Import Energy sensor from the integration and complement it with the cost tracker using the *Spot Price VAT* sensors.\n\n**Take note** that you should use the sensor that includes VAT for Electricity that you purchase. Please **also note** that this sensor does not include markups from your electricity provider.\n\n![checkwatt energy step 2](/images/energy_step_2.png)\n\nFor Grid Consumption, select the Export Energy sensor from the integration and complement it with the cost tracker using the *Spot Price* sensors.\n\n**Take note** that you should use the sensor that excludes VAT for Electricity that you sell.\n\n![checkwatt energy step 3](/images/energy_step_3.png)\n\nWhen configured, it looks like this. Press **SAVE + NEXT** to continue the Wizard.\n\n![checkwatt energy step 4](/images/energy_step_4.png)\n\nAdd the Solar Energy sensor from the integration and press **SAVE + NEXT**\n\n![checkwatt energy step 5](/images/energy_step_5.png)\n\nAdd the Battery Energy sensors from the integration.\n*Energy going in to the battery* = Battery Charging Energy Sensor\n*Energy going out of the battery* = Battery Discharging Energy Sensor\n\n Press **SAVE + NEXT**\n\n![checkwatt energy step 6](/images/energy_step_6.png)\n\nFinish off the Wizard and the result will look like this.\nPlease be advised that it will take a few hours before the Energy Panels start showing data.\n\nAlso, currently EnergyInBalance does not always provide proper Grid Input and Output why this data cannot be relied upon.\n\nFor now, you need to pull that data from another integration.\n\n![checkwatt energy done](/images/energy_done.png)\n\n## Final result\nWhen the system is fully set-up it you have sensors that provides you with your daily and annual net income and if you have configured it accordingly, you also have sensors available for the Home Assistant Energy Dashboard.\n\nThe final result can look like this:\n\n![checkwatt main](/images/ha_main.png)\n\n## Events\nThe integration publish [events](https://www.home-assistant.io/integrations/event/) which can be be used to drive automations.\n\nBelow is a sample of an automation that acts when CheckWatt fails to engage your battery and deactivates it.\n\n```yaml\nalias: Deactivated\ndescription: \"\"\ntrigger:\n  - platform: state\n    entity_id:\n      - event.skarfva_fcr_d_state\n    attribute: event_type\n    from: fcrd_activated\n    to: fcrd_deactivated\ncondition: []\naction:\n  - service: notify.faanskit\n    data:\n      message: \"CheckWatt failed, please investigate.\"\nmode: single\n```\n\n\n# Expert Section\nIf you think that some of the attributes provided should be sensors, please consider to use [Templates](https://www.home-assistant.io/docs/configuration/templating/) before you register it as an [issue](https://github.com/faanskit/ha-checkwatt/issues). If it can be done via a Template Sensor, it will most likely be rejected.\n\n## Use templates\nThis is an example of a Template based Sensor that pulls tomorrows estimated daily net income from the attribute of the CheckWatt Daily Net Income sensor.\n\nIt goes without saying, but this should be put in your `configuration.yaml`:\n```yaml\ntemplate:\n  - sensor:\n      - name: \"CheckWatt Tomorrow Net Income\"\n        unique_id: checkwatt_tomorrow_yield\n        state: \"{{ state_attr('sensor.skarfva_checkwatt_daily_yield', 'tomorrow_gross_income')}}\"\n        unit_of_measurement: \"SEK\"\n        device_class: \"monetary\"\n        state_class: total\n```\nThe result will look something like this:\n\n![template based sensor](/images/expert_sensor.png)\n\n\n## Use developer tools\nThe names of the attributes can be found in the Home Assistant Developer Tools section in your Home Assistant environment under the **STATES** sheet:\n\n![home assistant developer tools](/images/dev_tools_states.png)\n\n# Acknowledgements\nThis integration was loosely based on the [ha-esolar](https://github.com/faanskit/ha-esolar) integration.\nIt was developed by [@faanskit](https://github.com/faanskit) with support from:\n\n- [@flopp999](https://github.com/flopp999)\n- [@angoyd](https://github.com/angoyd)\n\nThis integration could not have been made without the excellent work done by the Home Assistant team.\n\nIf you like what have been done here and want to help I would recommend that you firstly look into supporting Home Assistant.\n\nYou can do this by purchasing some swag from their [store](https://home-assistant-store.creator-spring.com/) or paying for a Nabu Casa subscription. None of this could happen without them.\n\n# Licenses\nThe integration is provided as-is without any warranties and published under [The MIT License](https://opensource.org/license/mit/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaanskit%2Fha-checkwatt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaanskit%2Fha-checkwatt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaanskit%2Fha-checkwatt/lists"}