A Home Assistant integration that tracks electricity outage schedules from Ukrainian energy providers, providing outage calendars, countdown timers, and status updates.
| Region | Provider | Data Source |
|---|---|---|
| Kyiv | DTEK | Yasno API |
| Dnipro | DnEM | Yasno API |
| Dnipro | CEK | Yasno API |
| Kyiv Oblast | DTEK | Baskerville42/outage-data-ua |
| Dnipro and Oblast | DTEK | Baskerville42/outage-data-ua |
| Odesa and Oblast | DTEK | Baskerville42/outage-data-ua |
| Khmelnytskyi and Oblast | KhOE | yaroslav2901/OE_OUTAGE_DATA |
| Ivano-Frankivsk and Oblast | POE | yaroslav2901/OE_OUTAGE_DATA |
| Uzhhorod and Oblast | ZOE | yaroslav2901/OE_OUTAGE_DATA |
| Lviv and Oblast | LOE | yaroslav2901/OE_OUTAGE_DATA |
| Ternopil and Oblast | TOE | yaroslav2901/OE_OUTAGE_DATA |
| Chernihiv and Oblast | ChOE | yaroslav2901/OE_OUTAGE_DATA |
| Zaporizhzhia and Oblast | ZOE | yaroslav2901/OE_OUTAGE_DATA |
| Zhytomyr and Oblast | ZOE | yaroslav2901/OE_OUTAGE_DATA |
| Polava and Oblast | POE | yaroslav2901/OE_OUTAGE_DATA |
| Vinnytsia and Oblast | VOE | olnet93/gpv-voe-vinnytsia |
| Sumy and Oblast | SOE | E-Svitlo API |
The quickest way to install this integration is via HACS by clicking the button below:
If it doesn't work, adding this repository to HACS manually by adding this URL:
- Visit HACS → Integrations → ... (in the top right) → Custom repositories
- Click Add
- Paste
https://github.com/ALERTua/ha-svitlo-yeahinto the URL field - Chose Integration as a Category
- Svitlo Yeah | Світло Є will appear in the list of available integrations. Install it normally.
This integration is configurable via UI. On Devices and Services page, click Add Integration and search for * Svitlo Yeah*.
Then you can add the integration to your dashboard and see the information about the next planned outages. Integration also provides a calendar view of planned outages. You can add it to your dashboard as well via Calendar card.
The integration creates the following entities in Home Assistant:
| Entity | Type | Purpose | Description |
|---|---|---|---|
| Electricity | Enum Sensor | Shows current power connectivity state according to the calendar | Indicates the current electricity status with three possible states: connected (normal power), planned_outage (scheduled blackout), or emergency (unscheduled blackout). Reflects the calendar state and shows if there is an ongoing outage event at the moment. Provides additional attributes including event details when an outage is active. |
| Schedule Updated On | Timestamp Sensor | Shows when outage schedule was last updated by the provider | Displays the timestamp when the energy provider last updated the outage schedule on their servers. Reflects server-side data changes, not client fetch times. |
| Schedule Data Changed On | Timestamp Sensor | Shows when actual outage schedule data changed | Tracks the timestamp when the actual data was modified. Useful for notifications when schedules are updated. See examples. |
| Next Planned Outage | Timestamp Sensor | Shows the start time of the next scheduled blackout | Displays the timestamp when the next planned power outage is scheduled to begin. Null when no outages are scheduled. |
| Next Scheduled Outage | Timestamp Sensor | Shows the start time of the nearest outage (scheduled or planned) | Displays the timestamp of the nearest upcoming outage event, comparing scheduled outages and planned outages to show whichever comes first. Null when no outages are scheduled. |
| Next Connectivity | Timestamp Sensor | Shows when power is expected to return | Displays the timestamp when power connectivity is expected to be restored after an outage. Null when no outages are active. |
| Entity | Type | Purpose | Description |
|---|---|---|---|
| Planned Outages Calendar | Calendar Entity | Provides calendar integration for planned outages | Shows all planned power outages as calendar events. Can be used with Home Assistant's calendar cards, automations, and triggers. Events include "Definite" planned outages and "Emergency" unscheduled blackouts. The calendar state is on during any event. |
| Scheduled Outages Calendar | Calendar Entity | Provides calendar integration for outage schedule | Shows the power outages schedule. |
| Event | Description |
|---|---|
| svitlo_yeah_data_changed | Fired when outage data actually changes |
event_type: svitlo_yeah_data_changed
data:
region_name: Київ # yes, Cyrillic. This is how it comes from the API
region_id: 25
provider_id: 902
provider_name: ПРАТ «ДТЕК КИЇВСЬКІ ЕЛЕКТРОМЕРЕЖІ»
group: "3.1"
last_data_change: "2025-11-15T14:20:24.627353+02:00"
config_entry_id: 01KB817HS8R32RSYH5RW01G78Zevent_type: svitlo_yeah_data_changed
data:
region_name: odesa
region_id: null
provider_id: null
provider_name: null
group: "1.1"
last_data_change: "2025-11-15T14:20:24.627353+02:00"
config_entry_id: 01KB817S4AXVFB39X97NGYCV55- Use the Electricity sensor in dashboards to display current power status from the calendar perspective
- Set up notifications when Schedule Data Changed On updates to alert about schedule changes
- Or use the event to trigger on (described above and in automation examples)
- Use the Planned Outages Calendar with calendar triggers for advance warnings before outages
- Monitor Next Planned Outage and Next Connectivity timestamps for countdown displays
See CONTRIBUTING.md for information about adding new regions and contributing to the project.