Вітальня — домашній екран для Android TV

Лаунчер для Android TV-приставок (зроблений і перевірений на Xiaomi Mi Box S), який показує те, що важливо в Україні просто зараз: карту повітряних тривог з шахедами й ракетами в реальному часі, лінію фронту, графік відключень світла, погоду, курси, новини — і полицю з вашими програмами.

Завантажити APK: tvhome.pichkur.com або Releases (повна й Lite)

English: a home screen (launcher) for Android TV boxes made for Ukraine — a live air-raid alert map with Shahed/missile tracks, the DeepStateMAP front line, power-outage schedules, weather, NBU rates, news and an app shelf. The UI is in Ukrainian. MIT licensed.

Що вміє

• Карта тривог по областях, районах і громадах — ті самі офіційні дані, що й на map.ukrainealarm.com. Цілі в небі (шахеди, реактивні, ракети, КАБи) з напрямком руху від NEPTUN.
• Тривога у вашому місті: карта плавно наближається до міста, по краях екрана — м'яке червоне світіння, а поверх будь-якої програми (YouTube, фільм) з'являється «чубчик», як Dynamic Island.
• Лінія фронту DeepStateMAP замість карти тривог (перемикач у налаштуваннях): окуповане, сіра зона, зміни за добу кільцями на карті та відтворення змін за тиждень, день за днем.
• Погода на карті — третій шар карти: дощ, сніг і хмари над усією Україною та температура в обласних центрах.
• Порівняння фронту — пунктиром лінія фронту місяць тому поверх сьогоднішньої.
• Футбол — матч обраної команди (збірна або клуб УПЛ) у рядку новин: «сьогодні 14:00», рахунок наживо, фінал.
• Налаштування з розділами (Екран · Карта · Полиця · Дані · Система): значки й пояснення до кожного пункту, перемикачі, а екран поруч — зміни видно одразу. «Про приставку»: пам’ять, сховище, температура, IP. «Звільнити пам’ять» закриває фонові програми.
• Пульт і клавіатура з телефону (повна й Lite): лаунчер сам піднімає в домашній мережі сторінку http://<приставка>:8765 — QR-код і шестизначний код у Налаштуваннях → Телефон. Головне — клавіатура: «Вітальня: клавіатура з телефону» вписує текст із телефону в будь-яке поле на телевізорі (пошук YouTube, Lampa, пароль Wi‑Fi), кирилицею теж. Ще стрілки й ОК або тачпад із жестами, Назад/Додому, медіа, гучність повзунком, запуск програм і встановлення APK з телефону. З телефону на телевізор: фото й відео слайд-шоу, музика через колонки ТВ, посилання (YouTube — у YouTube, відео — у плеєрі), перемотка повзунком у тому, що грає. Стрілки в чужих програмах працюють через мережеве налагодження самої приставки (один раз «Дозволити» на екрані).
• Швидкі налаштування — кнопка на полиці: гучність, шар карти, макет, тема, яскравість фону, звуки, мережа.
• Єдина гучність приставки: телефон і швидкі налаштування використовують одну шкалу 0–100% за реальними кроками Android. Панель унизу по центру ТВ показує той самий відсоток, що й телефон; на телефоні — повзунок, −/+, вимкнення звуку. Обробка фізичних клавіш поверх інших програм потребує повної версії зі службою «Вітальня»; у 1.60 власник повідомив, що фізичний пульт досі показує системну шкалу, причину ще перевіряємо. У 1.61 панелі зменшено до одного рядка й додано перевірку служби для звичайного пульта; фізичну роботу цієї версії ще треба перевірити на приставці. На головному екрані панель підтримується й у Lite. Це гучність медіа приставки, без керування телевізором через HDMI-CEC. Можливості, обмеження й перевірки.
• Майстер першого запуску: місто визначається саме, вибір програм для полиці, черга світла й команда, головний екран із поясненням, усі дозволи на одному екрані, підказки. Пройти знову — Налаштування → Екран.
• Конструктор екрана (Налаштування → Конструктор екрана): будь-який блок можна сховати, перемістити й зробити меншим чи більшим; нові блоки — тиждень, футбол з емблемами, фронт за добу, відлік днів, нотатка, фото дня Вікіпедії, другий годинник. Права частина — карта, великий годинник, фото дня, календар або нічого. Полиця — розмір карток, підписи, один чи два ряди, які кнопки показувати. Колір акценту (12), годинник (тонкий, жирний, табло, стрілки, словами), шрифт, панелі, кути, рамки. «Скинути все» повертає як було.
• Меню програми: затисніть ОК на програмі (або кнопку меню) — відкрити, перемістити на полиці, прибрати з полиці, інформація, видалити.
• Стан інтернету: значок Wi‑Fi жовтіє, коли інтернет повільний, і червоніє, коли його немає; у налаштуваннях — вимір швидкості (Cloudflare).
• Атмосферні живі світи: Налаштування → Екран → Фон: «Вікно · Київ», «Будинок · Карпати», «Орбітальна станція». Статичні зображення з м’яким рухом світла; рух можна вимкнути окремо.
• Кіновечір удвох: значок кіноплівки на полиці → QR-код → два телефони в одній домашній мережі. Два «так» створюють спільний збіг. У 1.56 додано каталог TMDB з фільтрами жанру, років, рейтингу й порядку та кнопкою «Ще фільми»; 24 локальні фільми залишені як офлайн-резерв. Опис і обкладинка надходять із TMDB, із резервом англійських даних за тим самим ID. Натискання збігу відкриває картку в установленій Lampa. У 1.58 свіжий збіг додатково відкриває на ТВ екран із постером та діями «Відкрити в Lampa» / «Продовжити вибір». Браузерні перевірки й незалежний огляд знімків пройдено для 1920×1080 та 960×540. Інструкція, зберігання даних і стан перевірки.
• Нічне місто: уночі вулиці на фоні світяться теплим світлом.
• Святкове оформлення: гірлянда над полицею на Новий рік і синьо-жовті акценти в державні свята (вимикається в налаштуваннях).
• Свята й пам'ятні дні біля дати (Великдень і Трійця рахуються самі).
• Відключення світла для вашої черги: «Відключення 14:00–17:30 · через 2 год», смуга на наступні 24 години. 17 областей (дані обленерго, ДТЕК, YASNO).
• Погода з Open-Meteo, схід і захід сонця, а дощ, сніг чи туман — просто на фоні екрана.
• Міні-плеєр того, що грає (YouTube, YouTube Music…), і «Продовжити» для останнього фільму.
• Курси НБУ ($, €, zł) і головна новина з «Української правди».
• Теми й макети: 6 тем (Вечірній Львів, Північне сяйво, Захід над Карпатами, Сапфір і золото, Неон, Графіт і мідь), 6 макетів (Кіно, Класика, Плеєр, Дзеркало, Картки, Мінімал), фони — мапа вулиць вашого міста, силует міста з живим небом або градієнти за сонцем. Карта 3D або 2D.
• 22 міста на вибір: від міста залежать погода, тривоги «у моєму місті», мапа на фоні й відключення світла.
• Нічний режим (01:00–07:00): рідше оновлення, без анімацій.
• Самооновлення з сайту, без Google Play.

Живі світи й кіновечір увійшли до 1.52, успішно зібраної в Codemagic (збірка №52, коміт 73f9c65). Full і Lite опубліковані в каналах оновлень; підпис збігається з 1.50. Поточна опублікована версія — 1.61 з компактною гучністю й діагностикою звичайного пульта: Full і Lite успішно зібрані Codemagic №61, SHA-256 публічних завантажень збігаються з CI, обидва канали оновлень повертають код 61. Для екрана нового збігу з 1.58 отримано й незалежно схвалено браузерні знімки у двох розмірах. Для панелі гучності на телефоні пройдено браузерні перевірки на ширинах 320/390/480 px та незалежний огляд знімків. На Mi Box підтверджено стару 1.60; встановлення 1.61 та фізичні клавіші ще не перевірено. Нативний вигляд і швидкодію на пристрої не перевірено. Наявні знімки нижче показують попередні можливості.

Скриншоти

Тривога у вашому місті	Лінія фронту DeepStateMAP і зміни за добу
Погода над Україною, дощ на фоні	Екран із конструктора: стрілки, тиждень, відлік, календар
Налаштування з розділами — екран видно поруч	Швидкі налаштування з полиці
Пульт з телефону: QR-код і код	Перше налаштування
«Північне сяйво», макет «Картки»	«Захід над Карпатами»
«Сапфір і золото», макет «Дзеркало»	«Неон»
«Графіт і мідь»	Макет «Мінімал»

Пульт на телефоні: текст одразу з’являється в полі на телевізорі, тачпад із жестами, фото, музика й посилання — на телевізор, встановлення APK.

Дві версії

	Повна	Lite
Пакет	pl.pichkur.tvhome	pl.pichkur.tvhome.lite
Кнопка Home відкриває Вітальню на будь-якій приставці	так (служба спеціальних можливостей)	лише якщо система дозволяє вибрати лаунчер
«Чубчик» тривоги поверх інших програм	так	ні
Міні-плеєр з назвою треку	так (доступ до сповіщень)	ні
Google Play Protect	може попереджати	без попереджень

Як це влаштовано

android/   APK: повноекранний WebView + міст window.TV (програми, запуск, Wi-Fi, медіа),
           DataService (усі дані збирає сама приставка), HomeGuardService (кнопка Home, «чубчик»),
           самооновлення через PackageInstaller. Дві збірки: full і lite (Gradle flavors).
web/       сам екран: HTML/CSS/JS без фреймворків, вшивається в APK (assets/web).
           Карта — SVG з геометрії ukrainealarm, мапи вулиць — з OpenStreetMap.
server/    невеликий Node-сервер без залежностей: публічний API для того, чого немає у відкритому
           доступі (тривоги по громадах, лінія фронту, графіки світла), плюс сайт із завантаженням.
site/      сайт tvhome.pichkur.com.
tools/     збирання карти й мап вулиць, публікація APK.

Публічні ендпоінти (https://tvhome.pichkur.com):

/api/public/alerts	тривоги по областях, районах і громадах
/api/public/frontline	лінія фронту (SVG-шляхи в координатах карти) і зміни за тиждень
/api/public/power?region=lviv	графіки відключень для області
/api/public/wxmap	опади й хмари над Україною (PNG у координатах карти), температура в містах
/api/public/football?team=134426	наступний, останній і поточний матч команди
/api/public/version, /api/public/download/tvhome.apk	оновлення

Збирання

APK збирається в Codemagic (codemagic.yaml): ./gradlew :app:assembleFullRelease :app:assembleLiteRelease. Для підпису потрібна група змінних tvhome_signing з TVHOME_KEYSTORE_B64, CM_KEYSTORE_PASSWORD, CM_KEY_ALIAS, CM_KEY_PASSWORD. Без них Gradle підпише debug-ключем — для власної приставки цього досить.

Локально: cd android && ./gradlew :app:assembleFullDebug, потім

adb install -r app/build/outputs/apk/full/debug/app-full-debug.apk
adb shell cmd package set-home-activity pl.pichkur.tvhome/.MainActivity
adb shell settings put secure enabled_accessibility_services pl.pichkur.tvhome/.HomeGuardService

Сервер: docker compose up -d --build (порт 8098). Сторінку можна переглянути в браузері з ?demo — з'являться тестовий плеєр і полиця.

Джерела даних

• Тривоги — map.ukrainealarm.com; запасний варіант по областях — ubilling.
• Цілі в небі — NEPTUN (за умовами використання посилання на NEPTUN завжди видно на екрані).
• Лінія фронту — DeepStateMAP.
• Відключення світла — svitlo (дані обленерго, ДТЕК, YASNO).
• Футбол — TheSportsDB.
• Погода — Open-Meteo, курси — НБУ, новини — RSS «Української правди» та Укрінформу.
• Мапи вулиць — © учасники OpenStreetMap, ODbL.
• Шрифти — Fixel від MacPaw (site/fonts/OFL-Fixel.txt), JetBrains Mono, Lora, Nunito, DSEG7 — усі SIL Open Font License.
• Фото дня — Вікіпедія / Wikimedia Commons (автор і ліцензія показуються під фото).

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

Ліцензія

Код — MIT.