СвітлоБот перетворює iPhone або iPad на простий монітор наявності електроенергії. Застосунок стежить за заряджанням пристрою та надсилає вибраній системі сповіщень сигнал про його стан.
За звичайного використання застосунок звертається до сервера Світлобота. Сервер визначає зміну статусу та публікує повідомлення в Telegram-каналі. Застосунок не публікує такі повідомлення в канал самостійно, доки ви окремо не ввімкнете Telegram-fallback.
Інструкція до застосунку · Політика приватності · Умови використання · Повідомити про вразливість
- Відстеження стану заряджання та автоматичні сигнали серверу Світлобота.
- Необов’язковий миттєвий сигнал після від’єднання зарядного пристрою.
- Окремий Telegram-fallback, який надсилає повідомлення безпосередньо через вашого Telegram-бота.
- Черга Telegram-повідомлень, які не вдалося надіслати через відсутність інтернету.
- Журнал подій, статус каналу та команди для застосунку «Швидкі команди».
- Підтримка iPhone та iPad; мінімальна версія iOS/iPadOS — 14.0.
Застосунок використовує факт заряджання пристрою як непрямий сигнал про наявність електроенергії. Щоб регулярно надсилати сигнали з інтервалом близько хвилини, залишайте його відкритим на екрані. iOS обмежує фонову роботу, а показник заряджання не є вимірюванням електромережі.
- Введіть ключ каналу в застосунку — під час першого запуску або в налаштуваннях.
- Увімкніть автоматичний моніторинг і під’єднайте пристрій до зарядного пристрою.
- За потреби увімкніть миттєвий сигнал про припинення заряджання.
- Переглядайте відповіді серверу та журнал подій у застосунку.
За наявності інтернету перший сигнал надсилається одразу, наступні — приблизно раз на 60 секунд. Сервер Світлобота відповідає за визначення статусу та публікацію в Telegram.
Цей режим працює замість режиму Світлобота. Застосунок надсилає Telegram Bot API повідомлення під час від’єднання й поновлення заряджання.
- Створіть бота через @BotFather.
- Додайте його до потрібного каналу з правом публікувати повідомлення.
- Увімкніть Telegram-fallback у налаштуваннях і введіть токен бота та ідентифікатор каналу або його
@username. - Перевірте налаштування й підтвердьте ввімкнення режиму.
Токен Telegram зберігається у Keychain на пристрої. Не публікуйте його, ключ каналу чи приватний ідентифікатор каналу у звітах, скриншотах або комітах. Докладніше про обробку даних — у політиці приватності.
| Огляд моніторингу | Журнал подій | Telegram-fallback |
|---|---|---|
 |
 |
 |
- Xcode із підтримкою iOS 14 SDK або новішої версії.
- iOS/iPadOS 14.0 або новіша версія на пристрої.
- Для режиму Світлобота: ключ каналу, інтернет і під’єднаний зарядний пристрій.
- Для Telegram-fallback: Telegram-бот і канал, де він може публікувати повідомлення.
git clone https://github.com/Baskerville42/SvitloBotIOS.git
cd SvitloBotIOS
open SvitloBot.xcodeprojВиберіть схему SvitloBot та симулятор або під’єднаний пристрій. Підписання й поширення застосунку залишаються в Xcode Cloud. GitHub Actions використовуються для аналізу коду, оновлення workflow-залежностей і публікації сайту документації.
Для перевірок без Xcode Cloud дивіться CONTRIBUTING.md, опис моделі загроз та план захисту налаштувань репозиторію.
Застосунок зберігає Telegram-токен у Keychain і не має облікових записів користувачів. Увімкнені мережеві режими передають дані серверам Світлобота або Telegram відповідно до вибраного режиму. Повний перелік даних і одержувачів наведений у політиці приватності.
Повідомляйте про вразливості приватно згідно з SECURITY.md. Не створюйте публічне issue з токенами, ключами каналів або даними користувачів.
Код поширюється за ліцензією MIT. Назви й торговельні марки Apple та Telegram належать відповідним правовласникам; цей проєкт не афілійований з Apple Inc. або Telegram.