ІНСТРУКЦІЯ З НАЛАШТУВАННЯ СПОВІЩЕНЬ ЗМІНИ ГРАФІКУ
The number of users and requests to API which is hosting schedules is constantly growing. I maintain this project personally in my free time. However, the free server is reaching its limits, so I need to upgrade to a paid version. While the costs are manageable and I can cover them myself, I’ve opened a donation jar. If you would like to support the project and ensure its stability, you can do so by clicking the jar image ⬇
An integration for Home Assistant that displays the current electricity supply status for your region and queue.
Version 2.8.6 allows changing settings via UI (with optional preserving old IDs), supports almost all regions via a new unified reliable API, and automatically cleans up old entities.
- ✅ Displays the current power status (
On / Off), - ✅ Detects the next power-on and power-off times,
- ✅ Shows the time of the last schedule update,
- ✅ Unified Reliable API: Uses a specialized proxy that aggregates data from DTEK/YASNO and other official sources for maximum accuracy.
- ✅ Configure via UI: Change your queue, sub-queue, or update interval on the fly without reinstalling.
- ✅ Smart Cleanup: Automatically removes old entities and devices when you change settings.
- ✅ Includes built-in localization (UA / EN),
- ✅ Schedules precise entity state changes at the exact time of power switch — without calling the API again.
The integration now uses own API (thanks to yaroslav2901 for the multiple regions parser) for the following regions, ensuring high reliability:
- Kyiv City & Kyiv Region
- Dnipro City (Dnem & CEK) & Dnipropetrovsk Region
- Odesa Region
- Lviv Region
- Kharkiv Region
- Poltava Region
- Cherkasy Region
- Chernihiv Region
- Chernivtsi Region
- Zhytomyr Region
- Sumy Region
- Rivne Region
- Ternopil Region
- Ivano-Frankivsk Region
- Khmelnytskyi Region
- Zakarpattia Region
- Zaporizhzhia Region
(Other regions are supported via svitlo.live API).
- Unified Coordinator: All regions/queues share a single cached data source to minimize network requests.
- Smart Caching: Data is cached for 10-15 minutes. If you have multiple queues setup, they reuse the same downloaded JSON.
- Precise Ticking: The integration calculates the next switch time and schedules an internal timer. If the power is off until 18:00, the sensor will switch to "On" exactly at 18:00:00 without waiting for the next API poll.
- The API returns the schedule in local Ukrainian time (Europe/Kyiv).
- The integration converts this to UTC for Home Assistant, ensuring all times are displayed correctly regardless of your HA timezone.
The integration does not expose any API keys.
Access to data is handled via a secure Cloudflare Worker proxy that:
- Aggregates data directly from official utility providers.
- Returns a standardized JSON response.
- Requires no private credentials from the user.
The quickest way to install this integration is via HACS:
- Open HACS → Integrations.
- Search for
Svitlo.live(or add this repo as a custom repository). - Click Download.
- Restart Home Assistant.
- Go to Settings → Devices & Services → Add Integration.
- Search for Svitlo.live.
- Select your Region and Queue.
You don't need to reinstall the integration to change your queue!
- Go to the integration card in Home Assistant.
- Click Configure (the cogwheel icon ⚙️).
- Select the new queue/sub-queue from the list.
- (Optional) Adjust the Scan Interval (default: 900 seconds / 15 min).
- Click Submit. The integration will reload, delete old entities, and create new ones automatically.
| Type | Name | Description |
|---|---|---|
| 🟢 Binary Sensor | Electricity status |
True/False power indicator |
| 📘 Sensor | Electricity |
Text status: “Grid ON / OFF” |
| ⏰ Sensor | Next grid connection |
Next power-on time (if currently off) |
Next outage |
Next power-off time (if currently on) | |
| 🔄 Sensor | Schedule updated |
Last successful API refresh |
| 📅 Calendar | calendar.svitlo_<region>_<queue> |
“💡 Electricity available” events (Kyiv local time) |
| ⏳ Sensor | Minutes to grid connection |
Countdown minutes until power restoration. |
| ⏱ Sensor | Minutes to outage |
Countdown minutes until power cut. |
- yaroslav2901 — for developing the comprehensive parsers.
- vladmokryi — for the initiative and contribution regarding the Poltava region update.
- GitHub: @chaichuk
- Telegram: @serhii_chaichuk
MIT License © 2025
Open-source, with no API keys or personal data exposed.