Skip to content

keedhost/stepan

Repository files navigation

Степан — твій друг в системі координат

Десктопний застосунок для швидкого перетворення між різними системами координат. Розроблений для людей, які щодня працюють з координатами: військових, топографів, геодезистів, операторів БПЛА та ентузіастів.


Підтримувані формати

Формат Приклад
MGRS (Military Grid Reference System) 37UDB 12345 67890
DD (Десяткові градуси) 50.450100, 30.523400
DMS (Градуси, хвилини, секунди) 50°27'00"N 30°31'24"E
UTM (Universal Transverse Mercator) 37U 345678 5590123
УСК-2000 (Українська система координат) 4123456.78 - 2345678.90

Введи координату в будь-якому з цих форматів — застосунок автоматично розпізнає формат і відразу покаже результат у всіх інших.


Функціонал

Графічний інтерфейс

  • Автовизначення формату — вставляєш координату, бачиш результат без зайвих кроків
  • Кнопка «Вставити» — вставляє координату з буфера обміну одним кліком
  • Копіювання одним кліком — поряд з кожним форматом є кнопка копіювання
  • Відкрити на карті — кнопки для швидкого переходу до Google Maps та OpenStreetMap
  • Вбудована карта з трьома шарами:
    • Вулиці (OpenStreetMap)
    • Ортофото (Esri World Imagery) — з накладеним шаром підписів населених пунктів
    • Топографічна (OpenTopoMap)

Командний рядок (CLI)

Застосунок підтримує повноцінний консольний режим для скриптів та автоматизації:

# Конвертувати координату (всі формати)
stepan --convert "37UDB1234567890"

# Отримати лише один формат
stepan --convert "50.4501, 30.5234" --format dd

# Вивести без форматування (для скриптів)
stepan --convert "37UDB1234567890" --format mgrs --raw

# Згенерувати посилання на карту
stepan --convert "37UDB1234567890" --url google
stepan --convert "37UDB1234567890" --url all

Веб-інтерфейс

Вбудований HTTP-сервер дозволяє використовувати конвертер з браузера або звертатись до нього як до API:

GET /                        → веб-інтерфейс
GET /api/convert?q=37UDB...  → JSON з усіма форматами

Сервер вмикається в Налаштуваннях, де можна обрати мережевий інтерфейс та порт.

Системний трей

  • Застосунок мінімізується у трей і не займає місце на панелі задач
  • Вводити координати можна прямо з трею — без відкриття головного вікна
  • Підтримується автозапуск при вході в систему

Налаштування

  • Автозапуск при вході в систему
  • Запуск мінімізованим
  • Приховування у трей при закритті вікна
  • Джерело карти за замовчуванням
  • Увімкнення веб-сервера з вибором інтерфейсу та порту
  • Мова інтерфейсу: Українська / English

Збірка

Вимоги

  • CMake ≥ 3.16
  • Qt 6 (Widgets, WebEngineWidgets, Network)
  • C++17

macOS

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Linux

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Windows

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

macOS: перший запуск

Оскільки файл .app не підписаний сертифікатом Apple Developer, macOS може заблокувати запуск:

"Stepan" не вдалось відкрити, оскільки Apple не може перевірити, що він не містить шкідливого програмного забезпечення.

Рішення — зняти карантинний атрибут перед першим запуском:

sudo xattr -r -c /Applications/Stepan.app

Після цього програма відкриється звичайним способом. Команду потрібно виконати лише один раз.

Детальніше — в INSTALL.md.


Ліцензія

GNU General Public License v3.0

About

Програма для роботи з координатами — миттєва конвертація, перегляд, масові позначки

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors