Varta Menu Bar

A separate native macOS menu bar app for monitoring alerts in a selected Ukrainian oblast, district, or community.

English

Features

• Select any region exposed by the UkraineAlarm hierarchy, including communities such as Pavlohrad.
• Distinguishes Kyiv city from Kyiv oblast.
• Shows Alert, Partial alert, No alert, or Unavailable in the menu bar.
• Checks automatically every 30 seconds and supports manual refresh.
• Sends local notifications when an alert starts or ends after an initial silent baseline.
• Persists the selected region and transition state across restarts.
• Uses English when macOS prefers English. All other languages, including Russian, use Ukrainian.

Install the release

1. Download the latest ZIP release.
2. Open the ZIP and move Varta Menu Bar.app to /Applications.
3. On first launch, macOS may say the app is from an unidentified developer because release builds are not currently notarized. Control-click the app, choose Open, and confirm. Only do this when you trust the downloaded file.

Build and run

Requires macOS 13 or later and Xcode Command Line Tools:

make run

The app is ad-hoc signed because no Apple Developer identity is available. Release builds are not notarized, so macOS may require Control-clicking the app and choosing Open.

Data and safety

Data comes from siren.pp.ua, an unofficial public wrapper around UkraineAlarm. The hierarchy supports oblasts, districts, and communities, but alerts may originate at a selected region or one of its parents or children.

This app is not an official warning system and must not be the only source used for safety decisions. Data and notifications can be delayed or unavailable. Follow official Ukrainian authorities and emergency services.

⚠️ AI slop disclaimer: This entire project — code, documentation, and design — was generated by an AI assistant with light human review. It is slop in the honest sense of the word: it may contain bugs, blind spots, and mistakes. Treat it accordingly. Do not rely on it for life-or-death decisions, and do not assume it does what its documentation claims without verifying.

Українська

Окремий нативний застосунок macOS у рядку меню для стеження за тривогами в обраній області, районі або громаді України.

Можливості

• Вибір будь-якого регіону з ієрархії UkraineAlarm, включно з громадами на кшталт Павлограда.
• Київ і Київська область є окремими регіонами.
• Стани Тривога, Часткова тривога, Немає тривоги та Недоступно в рядку меню.
• Автоматична перевірка кожні 30 секунд і ручне оновлення.
• Локальні сповіщення про початок і завершення тривоги після першого тихого встановлення стану.
• Збереження обраного регіону та стану між перезапусками.
• Англійська мова використовується лише тоді, коли macOS надає перевагу англійській. Для всіх інших мов, включно з російською, використовується українська.

Встановлення релізу

1. Завантажте останню версію ZIP.
2. Відкрийте ZIP та перемістіть Varta Menu Bar.app до /Applications.
3. Під час першого запуску macOS може повідомити, що розробника не ідентифіковано, оскільки релізи наразі не нотаризовані. Натисніть на застосунок правою кнопкою, оберіть Open і підтвердьте запуск. Робіть це лише для файлу, якому довіряєте.

Збирання та запуск

Потрібні macOS 13 або новіша версія та Xcode Command Line Tools:

make run

Застосунок має локальний ad-hoc підпис, оскільки Apple Developer identity недоступний. Майбутній публічний файл не буде нотаризований, тому macOS може вимагати натиснути на застосунок правою кнопкою та обрати Open.

Дані та безпека

Дані надходять із siren.pp.ua — неофіційного публічного сервісу на основі UkraineAlarm. Ієрархія підтримує області, райони та громади, але тривога може бути оголошена для обраного регіону, його батьківського або дочірнього регіону.

Застосунок не є офіційною системою оповіщення і не повинен бути єдиним джерелом для рішень щодо безпеки. Дані та сповіщення можуть надходити із затримкою або бути недоступними. Дотримуйтеся вказівок офіційних українських органів влади та екстрених служб.

⚠️ Дисклеймер про ШІ: весь цей проєкт — код, документацію та дизайн — створено асистентом на основі штучного інтелекту з незначним людським рев'ю. Він може містити помилки, прогалини та недоліки. Не покладайтеся на нього для рішень, що стосуються життя та смерті, і не вважайте, що він працює саме так, як заявлено в документації, без перевірки.

License / Ліцензія

Public domain under The Unlicense. / Суспільне надбання за умовами The Unlicense.