[Custom Integration] Tauron Dystrybucja – planned and unplanned power outages in Poland

Share your Projects! Custom Integrations
1

Hi everyone,

I would like to share a custom Home Assistant integration for customers of Tauron Dystrybucja in Poland.

The integration retrieves planned and unplanned power outages for a configured address using Tauron’s publicly available web API.

GitHub repository:

Features

For each configured address, the integration creates:

  • an outage status sensor:
    • No outages
    • Outage announced
    • Outage in progress
  • outage start and end timestamp sensors
  • outage duration sensor
  • full outage description
  • a counter showing the number of announced outages in the next 30 days
  • a calendar entity containing all known outages
  • an event entity triggered whenever Tauron announces a new outage
  • a binary sensor that is active while an outage is in progress

You can configure multiple addresses by adding the integration more than once.

Dashboard example

The data can be displayed using standard Home Assistant cards or a Markdown card showing all upcoming outages:

[UPLOAD SCREENSHOT HERE]

The screenshot above shows several planned outages together with:

  • date and time
  • relative information such as “tomorrow” or “in 3 days”
  • the complete list of affected streets and house numbers

Automations

The integration can be used to create notifications when:

  • Tauron publishes a newly announced outage
  • an outage is about to start
  • an outage is currently in progress

For example, you can receive a mobile notification one day or two hours before the power is switched off.

Installation

The integration is currently waiting for review in the default HACS repository.

Until then, it can be installed as a custom HACS repository:

  1. Open HACS

  2. Go to the three-dot menu

  3. Select Custom repositories

  4. Add:

    https://github.com/Eales/tauron-dystrybucja

  5. Select the Integration category

  6. Install Tauron Dystrybucja

  7. Restart Home Assistant

After installation:

  1. Go to Settings → Devices & Services
  2. Select Add Integration
  3. Search for Tauron Dystrybucja
  4. Select the city and street
  5. Enter the house number

The polling interval can be configured between 15 and 1440 minutes. The default is 60 minutes.

Requirements

Home Assistant 2024.11.0 or newer.

Notes

Tauron sometimes returns outages for a wider geographical area. Therefore, the outage description should always be checked because it contains the actual streets and house numbers affected by the works.

The integration is open source and released under the MIT licence.

Feedback, bug reports and pull requests are very welcome.

1 Like