88 lines
4.5 KiB
Markdown
88 lines
4.5 KiB
Markdown
# Кьюарминатор
|
||
|
||
|
||
|
||
### ⚠️ Дисклеймер
|
||
|
||
Данное приложение создано исключительно в образовательных целях. Разработчик не поддерживает и не поощряет использование приложения для обхода учебных обязательств. Ответственность за использование программы полностью лежит на пользователе.
|
||
|
||
В коде приложения не содержатся никакие данные о сайтах ВУЗов, пользователю предоставляется возможность самостоятельно задать электронные адреса для проверки взаимодействия с гипотетической платформой.
|
||
|
||
|
||
|
||
## 💡 Идея
|
||
|
||
Дистант мог бы быть прекрасной возможностью отдохнуть, попить чаёк, поиграть, расслабиться, но необходимость отмечаться заставляет нас внимательно следить за ходом лекции в попытках выловить QR-код. Это приложение призвано автоматизировать данную задачу, чтобы Вы смогли хоть на полтора часа забыть о том, что сегодня ВУЗ проводит пару прямо у Вас дома.
|
||
|
||
## 🎩 Функции
|
||
|
||
- [x] Обнаружение QR-кодов
|
||
- [x] Вывод ссылки в консоль
|
||
- [x] Автоматический переход по ссылке
|
||
- [x] Звуковой сигнал
|
||
|
||
### ⏰ Запланированные
|
||
- [ ] Push-уведомления с ntfy
|
||
|
||
### 🤔 На рассмотрении
|
||
- [ ] Работа при свёрнутом окне
|
||
- [ ] Отметка через API журнала
|
||
|
||
## 📐 Реализация
|
||
|
||
Приложение делает скриншот окна браузера с заданным интервалом и анализирует снимки с помощью OpenCV, обнаруживая и декодируя QR-коды. Ссылки, ведущие на журнал посещаемости, автоматически открываются в браузере, либо используется другое альтернативное поведение, выбранное пользователем.
|
||
|
||
## 🧻 Начало работы
|
||
|
||
### 🖥 ОС
|
||
|
||
Вам потребуется поддерживаемая операционная система из списка ниже. Если галочки нет, то поддержка появится в будущем.
|
||
- [x] Linux (Wayland)
|
||
- [ ] Linux (XORG)
|
||
- [x] Windows 10/11
|
||
|
||
### ⬇️ Установка
|
||
|
||
Перейдите в список релизов и скачайте портативный исполняемый файл для Вашей платформы. Если хотите собрать приложение самостоятельно, читайте следующий раздел.
|
||
|
||
### ⚙️ Настройка
|
||
|
||
При первом запуске будет необходимо выполнить настройку приложения. Для этого нужно выбрать соответствующий пункт меню и следовать инструкциям на экране. Если Вы получили готовый файл настройки из другого источника, можно передать программе его URL.
|
||
|
||
## 🔨 Сборка
|
||
|
||
### 🧩 Зависимости
|
||
|
||
- git
|
||
- make
|
||
- curl
|
||
- opencv 4.12.0
|
||
- go 1.25.4
|
||
|
||
### Linux & MacOS & Windows
|
||
|
||
Склонируйте мой репозиторий:
|
||
```bash
|
||
git clone https://git.weirdcat.su/weirdcat/auto-attendance
|
||
```
|
||
|
||
Перейдите в него:
|
||
```bash
|
||
cd auto-attendance
|
||
```
|
||
|
||
Запустите сборку:
|
||
```bash
|
||
# для текущей платформы
|
||
make
|
||
|
||
# make build-linux
|
||
# make build-macos
|
||
# make build-windows
|
||
```
|
||
|
||
Далее для запуска можете использовать команду `make run`.
|
||
|
||
# Поддержать разработчиков
|
||
|