Disclaimer. The aggressor state's full-scale war against Ukraine has been ongoing since February 2014 and escalated into a full invasion on February 24, 2022. The entire territory of Ukraine remains a zone of active hostilities and potential missile threat. Stay vigilant, never ignore air raid alerts, and follow safety guidelines.
A Windows tray application built with Electron that receives alert data from alerts.in.ua at a specified frequency and displays it through the Windows Notification Center for the regions of Ukraine you choose to monitor.
Download the latest installer (Alert Server Setup x.x.x.exe) from Releases and run it. It's a standard NSIS installer: no administrator rights required, per-user install, with a Start Menu shortcut and uninstaller created automatically.
Future updates are detected and installed automatically from GitHub Releases; you'll only need to run the installer manually once.
On first launch the app appears as a tray icon only, no window. The icon itself (color or monochrome, per Settings) automatically matches the Windows light/dark taskbar theme, and shows an exclamation mark while an alert is active. Everything is controlled from the tray icon's context menu:
- Alert map / Front line map open alerts.in.ua and DeepState in a dedicated app window.
- Forecast opens a window showing, for each monitored region, either a notice that an alert is currently active or historical statistics from the past month (alert count, average interval, most common time and day of week, time since the last alert ended) plus, for each alert type, a probability and an ETA. See forecast methodology for how this is calculated, what the numbers mean, and known limitations of the approach - still clearly labeled as statistics, not a guaranteed prediction. Cards are sorted by how soon an alert is expected, with active regions first; if a whole region and one of its districts are both tracked, only the region's (already-aggregated) card is shown. Each region's summary can be copied to the clipboard. Below the list, a small block shows how much alert history has accumulated locally beyond the API's 30-day window, with a button to clear it if needed.
- Settings opens a two-column settings window: regions to monitor on the left (searchable tree, from region down to individual community - checking a higher-level region selects everything nested inside it, and a button clears the whole selection at once), and everything else on the right - interface language, monochrome tray icon, visual notifications (with a separate toggle just for active-alert notifications), forecast-approach notifications and how many minutes ahead to warn, sound notification mode (none, siren, or voice) and its repeat count, and launching at Windows startup. Dependent options grey out automatically (e.g. the sound repeat count when sound is off). Follows the Windows light/dark theme automatically.
- Event log opens an in-app, terminal-styled log viewer with buttons to clear it or open the underlying file directly in Notepad.
Clicking the Alert Server entry at the top of the menu opens the About window, showing the current version, license, and a link to the project's GitHub page.
Notifications for an alert starting or ending appear through the Windows Notification Center with a small map showing the affected region (red for a new alert, green for a cancellation); clicking one shows the alert's location and start time. If more than 5 alerts start or clear at once, you get a single notification with the total count and all affected regions highlighted instead of a flood of individual ones.
Left-clicking the tray icon opens a small popup with any active alerts and, below them, the nearest upcoming forecast for your monitored regions - handy when you just want a quick glance without opening the Forecast window. Hovering the tray icon shows the same nearest forecast as a tooltip when there's no active alert. If enabled in Settings (on by default), the app also sends a notification - with a blue region map, no alert sound - when a forecasted alert time is approaching, separate from the alert/cancellation notifications above; at most 3 fire per check, soonest first, to avoid a flood if many regions qualify at once.
The event log records app activity (start/exit, settings and region changes, alerts, update checks) as CSV, and is capped at 256 KB, automatically trimmed once it grows past that.
Use the Alert Server entry in Windows Settings → Apps, or the uninstaller shortcut created alongside the Start Menu shortcut.
If you have suggestions or want to propose improvements to the project, please open a pull request.
Copyright (c) 2024-2026 Serhii I. Myshko - MIT License