Skip to content

About

Автоматически ставит будильники в стоковые часы по расписанию пар КГЭУ. Android · Kotlin · Jetpack Compose · без аналитики и серверов

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Student-AutoAlarm

Автобудильник КГЭУ — Student-AutoAlarm: ночная сверка расписания, утренний звонок

Student-AutoAlarm: Android-приложение (Kotlin, Jetpack Compose), которое по расписанию КГЭУ автоматически ставит будильник перед первой парой — в стоковое приложение часов или, по выбору, собственным будильником приложения (полноэкранный звонок с кнопкой «Отключить»). Сейчас расписание берётся из официального публичного API личного кабинета kabinet.kgeu.ru (архитектура допускает добавление других вузов — слой провайдера расписания изолирован).

Приложение работает по единой логике «одна ночь вперёд» (0.8.0): включение тумблера проверяет сегодня/завтра и сразу ставит будильник на ближайшее пробуждение (со свежим расписанием — замены!), а каждую ночь в 00:05 (и страховками в 01:00, 02:00 и 03:00) проверщик смотрит, есть ли пары в наступивший день, и ставит будильник на ближайшее время — или не ставит, если пар нет. Никаких будильников «на день недели», которые потом приходится выключать руками; замены и отмены пар переставляют/снимают будильник сами. Вычитание выбранного вами времени на подъём и сборы, «под каждую пару» — у каждой пары может быть своё время подъёма. Числитель/знаменатель разворачивает в конкретные даты сам сервер КГЭУ, приложение работает только с фактическими датами.

Интерфейс переведён на 19 языков: русский, татарский, английский, арабский (с RTL), узбекский, казахский, кыргызский, таджикский, туркменский, чувашский, французский, испанский, турецкий, китайский, башкирский. Язык выбирается на первом шаге мастера настройки и меняется в «Настройки → Оформление → Язык».

Как это работает

Этап Что происходит
Первая настройка Язык интерфейса (19 языков, включая «язык системы») → вуз → роль (студент/преподаватель) → поиск группы или ФИО по API → «за сколько обычно встаёшь до первой пары»
Включение тумблера / мастер настройки / смена цели будильника Будильник ставится сразу на ближайшее предстоящее пробуждение в пределах сегодня и завтра (логика 0.8.0): сначала тихо подтягивается свежее расписание (неделя сейчас + через 7 дней — замены нередко публикуют ПОСЛЕ последней синхронизации), затем — сегодня, если время подъёма ещё не прошло, иначе завтра. Дальше завтра не ставится ничего — за следующие дни отвечает ночная сверка. Выключение тумблера снимает будильники приложения (гарантированно отменяет собственный будильник движка «В приложении»; в часах снимает последний разовый и, для очистки наследия старых версий, «Авто: Пн…Вс» по точным меткам) и сбрасывает внутренние маркеры — включённый заново тумблер ставит будильник заново, даже если старый вы уже удалили в часах вручную
Ночь (00:05, 01:00, 02:00, 03:00) Точная сверка приложения: запрос свежего расписания (сегодня + следующая неделя, ~15 КБ), затем ночная сверка с ближайшим ПРЕДСТОЯЩИМ пробуждением в пределах сегодня+завтра: есть пара сегодня — будильник ставится на ближайшее время; пар нет — фантомный снимается; замена сдвинула время — старый снимается, ставится новый; совпал — не дублируется. Тики 01:00–03:00 — страховки (0.12.0, раньше один тик в 06:00): если 00:05 пропущено (телефон был выключен, оболочка придавила точный будильник), ночные страховки ставят будильник на первую пару дня ещё ДО пробуждения — в том числе при ранних подъёмах 05:00–06:00. В движке «В приложении» слот перезаписывается свежим планом — самолечение по построению; в движке «в часах» ставятся только РАЗОВЫЕ будильники — повторов «на день недели» больше нет
После перезагрузки BootReceiver восстанавливает все ночные сверки (00:05 + 01:00/02:00/03:00) и немедленно восстанавливает ближайший будильник: в движке «В приложении» — перепоставляет безусловно (системный AlarmManager перезагрузку не переживает, а старый маркер дедупликации больше не «подтверждает» мёртвый слот — фикс 0.9.0); в движке «в часах» — сверка ставит разовый будильник на сегодняшнюю первую пару, если телефон был выключен всю ночь и все тики пропущены (фикс 0.9.0). Резервный WorkManager синкает расписание каждые 12 часов и тоже сверяет будильник
В течение дня Расписание можно перепроверить в любой момент (кнопка обновления); карточка «Мои будильники» (0.10.0) показывает то, что уже стоит: время, дату, метку, движок и живой ли слот, а с 0.13.0 — и тестовый будильник (в движке «В приложении» — с кнопкой снятия до звона); кнопки «Снять будильники» и — в движке «В часах» — явная «Список будильников» (приложение само часы не открывает никогда)

Важно: с 0.7.1 будильник по умолчанию звонит в приложении (полный контроль тумблера, точная дата, гарантированное снятие) — SET_ALARM стоковых часов не умеет «на дату», а DISMISS_ALARM на части оболочек (ColorOS/Realme UI) молча игнорируется. Если хотите сигнал в привычных часах — переключите «Где звонит будильник → В часах»: с 0.8.0 там ставятся только разовые будильники в пределах сегодня/завтра (дата соблюдается по построению: ночной тик 00:05 ставит будильник в сам день пары), но снятие по-прежнему зависит от оболочки.

Ключевые возможности

  • Единая логика «одна ночь вперёд» (0.8.0) — будильник ставится максимум на завтра: включение тумблера проверяет сегодня/завтра, ночная сверка 00:05 (+страховки 01:00–03:00 ночи) каждый день ставит будильник на ближайшую пару наступившего дня или снимает фантом, если пар нет. Режим «на несколько дней вперёд» (партия недельных будильников «Авто: Пн…Вс») удалён — при смене расписания такие будильники приходилось выключать руками; наследие старых установок снимается одноразовой миграцией при первом запуске 0.8.0. Под каждую пару — своё время подъёма (настраивается отдельно в диалоге с пресетами), у пар без своего значения — общий подъём.
  • Будильник в приложении (0.7.0; с 0.7.1 — по умолчанию) — настройка «Где звонит будильник»: «В приложении» — собственный точный будильник (AlarmManager.setAlarmClock): полноэкранный звонок поверх экрана блокировки с кнопками «Отключить» и «Отложить» (0.22.0: тишина на 5 минут, потом полный звонок), системный значок будильника, автоглушение через 10 минут с пометкой «пропущен» — либо «В часах» (через ACTION_SET_ALARM, только разовые будильники сегодня/завтра). Тумблер, исключения и снятие работают гарантированно в движке приложения — оболочка не может молча блокировать собственный будильник приложения.
  • Занятия-исключения (0.7.0: точные) — перед парами, чьё полное название совпало точно, будильник не ставится: тип уже написан в названии пары приставкой, и правило учитывает его: «л. материаловедение» гасит только лекцию, «пр. материаловедение» — только практику, «лаб. …» — только лабораторную. Никаких отдельных «тумблеров типов» — они не нужны. Переключаются прямо из расписания иконкой (иконка больше не «красит» все типы дисциплины разом); при добавлении — автодополнение по полным названиям из вашего реального расписания («мате» → «л. материаловедение», «пр. материаловедение»…).
  • Свои занятия — например, физкультура или секция, которых нет в расписании: свой день недели (или дата), время и отдельное смещение будильника.
  • Большой тумблер авто-будильника на главном экране — отключение в одно касание. Выключение снимает будильники приложения (гарантированно — в движке «В приложении»; по меткам с честным фолбэком — в часах) и отчитывается снекбаром. Включение подтягивает свежее расписание и ставит будильник заново: «удалил будильник в часах → включил-выключил тумблер → будильник вернулся», ждать полуночи не нужно.
  • Карточка «Мои будильники» (0.10.0) на главном экране: крупное время звонка, локализованная дата, метка, движок и честный статус слота («стоит» / «не найден — перепоставится автоматически» после перезагрузки); кнопка «Снять будильники» гасит оба движка. Управление будильниками в часах — явная кнопка «Список будильников» (движок «В часах») открывает будильники телефона; «Отключить будильники приложения» через официальный канал DISMISS_ALARM отключает и партию «Авто: Пн…Вс», и последний разовый будильник (по точным меткам «Авто: …»); если оболочка команду не принимает (часть Realme UI/ColorOS) — приложение сообщает об ограничении снекбаром, а список часов открывается только явной кнопкой «Список будильников» (0.10.0: авто-переходы в чужое приложение удалены).
  • Уведомления «Будильник поставлен на 07:00 (пр Атомные электрические станции, ауд. А413)».
  • Кастомизация: тема (системная/светлая/тёмная), Material You (динамический цвет Android 12+), 6 палитр акцента + палитра «своего цвета» (квадрат насыщенность/яркость + ползунок тона) — кружки выбора показывают реальный цвет темы; стиль расписания на выбор: Стандарт, Бумажный календарь, Мел и доска, Неон, Терминал, Акварель, Ретро-печать; своя картинка на фон с регулировкой прозрачности; светлая и тёмная темы всегда следуют теме приложения — окно и поверхности окрашиваются согласованно, без «серой каши» при тёмной системе.
  • 19 языков интерфейса (ru, tt, en, ar, uz, kk, ky, tg, tk, cv, fr, es, tr, zh, ba, az, hy, ka, mn): переводятся все экраны, уведомления, дни недели и даты; названия языков в списке — родным именем и на текущем языке («English / Английский»); сверху — русский, татарский и английский.
  • Перепроверка расписания: данные не считаются «вечными» — кэш старше трёх суток помечается предупреждением, замены пар помечаются бейджем «замена», а каждое обновление подтверждается снекбаром: успех с числом пар или причина ошибки (нет связи / сеть недоступна / сбой сервера).
  • Напоминание о будильнике — фолбэк для оболочек, блокирующих установку будильников (Realme UI китайского рынка, Huawei и др.): каждый день в выбранное время приходит своё уведомление «завтра пара во столько — не забудьте поставить будильник».
  • Совместимость с ColorOS/Realme UI — приложение само находит установленный пакет часов (Oppo/OnePlus/Realme, Samsung, Xiaomi/Huawei, Pixel, Tecno/Infinix) и адресует команду напрямую; для самых агрессивных оболочек есть тумблер «Показывать часы при постановке» — часы открываются с готовым будильником, подтверждение одним тапом.
  • Ориентация в календаре: текущая неделя выделена цветом акцента с бейджем «эта неделя», сегодняшний день — жирным со скруглённой полоской НАД названием дня (у выбранного — цвета «на акцента»), в шапке кнопка возврата к сегодняшней неделе (подсвечена, пока вы «уехали»). Расписание перелистывается свайпом — влево день вперёд, вправо назад, с плавным перетеканием выделения между чипами дней; шапка с неделей и месяцем стоит на месте и плавно сменяется при переходе через границу недели (0.25.0, статичная с 0.25.3 — без разрывов при свайпе), а сама неделя тихо подтягивается из сети; навигация никогда не ждёт сеть — неделя меняется мгновенно даже на медленном интернете (0.25.3).
  • Своя фоновая картинка — своё изображение под интерфейсом с настраиваемой прозрачностью (нижний порог гарантирует читаемость текста); удалённый вручную файл не оставляет «прозрачного» экрана — нет файла, работает плотный фон. Карточки на всех экранах — плотные и контрастные.
  • Маркеры дней в расписании — под числом дня: серая точка «есть пары», цветная точка с числом «столько обозначенных (исключённых) секций»; «сегодня» отмечается полоской над названием дня — путаться не с чем.
  • Отключение будильника с заблокированного экрана — при звонке экран сам загорается (страховочный wake-lock даже при капризах оболочки), уведомление полностью видно на локскрине с кнопками «Отключить» и «Отложить» (0.22.0), полноэкранный звонок — с большой кнопкой; если Android 14+ не выдал full-screen intent — в настройках появится подсказка с переходом к разрешению. Если оболочка не поднимает звонок над локскрином (MIUI/HyperOS, ColorOS/Realme UI) — в инструкциях по автозапуску есть блок «Звонок поверх экрана блокировки» с путём включения «показа на экране блокировки»/«всплывающих окон» (0.22.0) и разрешением «Поверх других окон» (0.23.0: системное исключение, позволяющее звонку подняться из фона даже при закрытом приложении; на главной — карточка-подсказка с переходом в настройки разрешения).
  • Настенный календарь — стиль «Бумажный календарь»: нарисованный лист с кольцами и шапкой месяца, расписание внутри, ваш фон вокруг; рядом — 5 ещё более смелых тем, у каждой своё оформление листа (0.15.0): Мел и доска — деревянная рама и рукописный шрифт, Неон — светящаяся кайма, Терминал — корпус лампового монитора, Акварель — пастельная рамка, Ретро-печать — газетные линейки.

Установка и запуск

Android (ARM64 / ARM32 / x86_64)

  1. Скачайте APK из раздела Releases.
  2. Откройте файл и разрешите установку из неизвестных источников для вашего проводника/браузера.
  3. Запустите «Автобудильник КГЭУ» и пройдите мастер настройки (5 шагов, ~1 минута: язык → роль → группа → подъём → финиш).

Требования: Android 8.0+ (API 26); интернет для загрузки расписания. Стоковые часы нужны ТОЛЬКО для движка «В часах» (опционально: по умолчанию будильник звонит в приложении — часы не требуются).

Обновление

  • Установите новый APK поверх старого — настройки, исключения и кэш расписания сохраняются (DataStore/Room).
  • Обновления поверх работают потому, что все релизы подписываются одним и тем же стабильным ключом (хранится в Secrets CI, в git не попадает; SHA-256 ключа зафиксирован пином в workflow — подмена секрета ломает сборку, а не молча подписывает APK чужим ключом).
  • SHA-256 сертификата подписи (сверяйте после обновлений): FD:29:47:48:43:08:64:89:7F:87:30:57:A7:2F:19:C1:E7:B2:D3:CB:B7:F4:CB:CF:2D:D4:95:F5:C5:95:F5:A0
  • С 0.11.0 отпечаток сверяется автоматически на каждом релизе в CI (SEC-10): несовпадение ломает сборку, а не подписывает APK чужим ключом.
  • Релизы публикуются как prerelease; после проверок на устройствах тег можно дожать до стабильного: Actions → release → Run workflow → тег + promote = true (ставит галку latest и снимает признак prerelease).
  • После обновления в 00:05 приложение само продолжит работу; перенастройка не требуется.

Первый запуск — чек-лист выживания

  1. Мастер настройки: язык интерфейса → группа/преподаватель → время на подъём → «Готово».
  2. Разрешите уведомления (Android 13+ запросит сам).
  3. Настройки → «Система»: отключите оптимизацию батареи и добавьте приложение в автозапуск (инструкция под вашего производителя — Xiaomi/Huawei/Oppo/Samsung и т. д.).
  4. Нажмите «Проверить будильник» — в часах появится тестовый будильник через 2 минуты.
  5. Будильники не ставятся вообще (бывает на Realme/Huawei/Xiaomi, особенно китайских прошивках)? Включите Настройки → «Напоминание о будильнике» и выберите время — приложение будет присылать своё уведомление с первой парой на завтра.
  6. Сам удалил будильник в часах / выключил тумблер — как вернуть будильник? Просто включите тумблер авто-будильника заново — будильник встанет на ближайшее пробуждение (сегодня/завтра) немедленно.
  7. Часы игнорируют команды приложения (постановка только вручную, снятие не работает — часть Realme UI/ColorOS/MIUI)? С 0.7.1 движок «В приложении» включён по умолчанию — приложение звонит само, полный контроль тумблера без ограничений оболочки (вернуть часы можно в Настройки → «Где звонит будильник» → «В часах»).

Приватность и разрешения

Приложение не имеет аналитики, рекламы и серверов: всё хранится только в приватной папке приложения. Минимум разрешений:

Разрешение Зачем
INTERNET Загрузка расписания с kabinet.kgeu.ru
SET_ALARM Постановка разового будильника в стоковые часы (движок «В часах»): ACTION_SET_ALARM/DISMISS_ALARM/SHOW_ALARMS
RECEIVE_BOOT_COMPLETED Восстановить ночной планировщик и ближайший будильник после перезагрузки
POST_NOTIFICATIONS Уведомления «будильник поставлен» (Android 13+)
SCHEDULE_EXACT_ALARM (Android 12–12L) + USE_EXACT_ALARM (Android 13+) Ночная сверка срабатывает в 00:05, 01:00, 02:00 и 03:00, а не «примерно»; собственному звонку (setAlarmClock) разрешение не требуется
REQUEST_IGNORE_BATTERY_OPTIMIZATIONS Кнопка «Исправить» в настройках (не отправляет ничего)
FOREGROUND_SERVICE + FOREGROUND_SERVICE_DATA_SYNC Фоновая синхронизация расписания (WorkManager, expedited-fallback на Android < 12)
VIBRATE + USE_FULL_SCREEN_INTENT + FOREGROUND_SERVICE_MEDIA_PLAYBACK Звонок движка «В приложении»: вибрация, полноэкранное уведомление поверх экрана блокировки, фоновый сервис звонка

Резервные копии Google отключены (allowBackup=false, правила dataExtractionRules): данные расписания, исключений и своих занятий не покидают устройство — включая облачные бэкапы и перенос через Google. Релизный APK собран с R8 + shrinkResources (с 0.10.0): ~2,6 МБ вместо 13 МБ.

Структура репозитория

Путь Назначение
app/src/main/java/ru/uniautoalarm/kgeu/data/model/ Доменные модели (Lesson, Settings, AlarmPlan…)
…/data/remote/ API КГЭУ: OkHttp + kotlinx.serialization (DTO с русскими полями сервера)
…/data/db/ Room: кэш расписания, исключения, свои занятия
…/data/repository/ SettingsRepository (DataStore), ScheduleRepository (сеть+кэш)
…/domain/ AlarmPlanner — расчёт времени пробуждения
…/alarm/ Движки будильника: StockAlarmSetter (ACTION_SET_ALARM в часы), InAppAlarmScheduler + AlarmFireReceiver + AlarmRingingService + SnoozePolicy (собственный звонок и «Отложить»), AlarmGateway (маршрутизация по цели), ночная сверка, BootReceiver, уведомления
…/work/ WorkManager: периодический синк расписания
…/ui/ Compose: мастер настройки, главный экран, расписание, настройки, темы
gradle/libs.versions.toml Version catalog (AGP 9.4.1, Kotlin 2.3.21, Compose BOM 2026.09.00)

Сборка из исходников

# 1. JDK 17+, Android SDK (platform 37, build-tools 36.0.0)
git clone https://github.com/rvmxl/Student-AutoAlarm.git
cd Student-AutoAlarm

# 2. local.properties с путём к SDK (или переменная ANDROID_HOME)
echo "sdk.dir=/path/to/Android/Sdk" > local.properties

# 2b. Лицензии SDK (один раз на машину; без них сборка падает на проверке лицензий)
yes | "$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager" --licenses > /dev/null

# 3. Отладочная сборка APK
./gradlew :app:assembleDebug
# результат: app/build/outputs/apk/debug/app-debug.apk

# 4. Юнит-тесты (78: AlarmPlanner, правила доставки, парсер API, паритет 19 локалей, порядок языков, ночные тики, DISMISS-канал, маркеры дней/слоты пар, скины/«свой цвет», отложенный звонок, видимость строки будильника)
./gradlew :app:testDebugUnitTest

# 5. Релизная сборка — ТОЛЬКО со стабильным ключом подписи (обновления поверх):
#    env-переменные KEYSTORE_FILE, KEYSTORE_PASSWORD, KEY_ALIAS, KEY_PASSWORD.
#    Ключа нет → сборка упадёт ЯВНО (автогенерация нового ключа запрещена:
#    чужой/новый ключ ломает установку обновлений поверх старых версий).
#    В CI ключ берётся из Secrets (см. .github/workflows/release.yml).
./gradlew :app:assembleRelease

Авторство и лицензии

© 2026 RVMXL, лицензия Apache License 2.0 (текст — LICENSE, атрибуция — NOTICE).

  • Данные расписания принадлежат КГЭУ и получаются из официального публичного API личного кабинета университета; это приложение не аффилировано с КГЭУ.
  • Kotlin/AndroidX/Compose/OkHttp/Coil — Apache License 2.0 их правообладателей (список — NOTICE).
  • Товарные знаки Android и Google принадлежат Google LLC.

Этот репозиторий — не форк; исходный код написан с нуля для авто-будильника по расписанию.

About

Автоматически ставит будильники в стоковые часы по расписанию пар КГЭУ. Android · Kotlin · Jetpack Compose · без аналитики и серверов

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages