Repository navigation
Releases: alllexey-dev/itmo-widgets-agent
Release list
v0.2.0
What's Changed
- install.sh: exit 0 after uninstall when no state folder is left by @alllexey-dev in #11
- Send X-Client with the build identity by @alllexey-dev in #12
- Connected clients: own ITMO session by pairing v2, renew, logout on unpair and 401 by @alllexey-dev in #13
- Release 0.2.0 by @alllexey-dev in #14
Full Changelog: v0.1.1...v0.2.0
v0.1.1
Второй бета-релиз своего клиента ITMO.Widgets. Что изменилось с v0.1.0:
Новое
- FreeBSD: бинарники
freebsd-amd64иfreebsd-arm64и служба rc.d (daemon(8)от вашего пользователя). Для службы нужен root: установщик предложит выполнить команды через sudo или doas, или напечатает их, чтобы вы выполнили их сами. itmo-widgets-agent attach(илиwatch) открывает экран работающей службы: связь с сервером, сессия ИТМО, события, запись на физкультуру. Клавиши те же (s- новая сессия ИТМО,u- отключить), аqтолько закрывает экран, служба продолжает работать. В Docker:docker compose exec agent /itmo-widgets-agent attach.statusпри запущенном агенте берёт данные у него и начинается со строкиЗапущен: ....- Установщик спрашивает, запускать ли агента в фоне как службу, а не создаёт её молча. Если служба уже есть, обновление её просто перезапускает. Без терминала новая установка создаёт службу,
--no-service(-NoServiceна Windows) - нет. - В меню установщика: пункт "Открыть экран службы (attach)", когда служба работает, и подсказка про
attachв "Статус и логи". Номера пунктов "Отключить агента" и "Удалить полностью" стали 8 и 9. unpairотзывает токен агента на сервере: агент пропадает из "Подключённых устройств" сам. Если сервер не ответил,unpairвсё равно удалит файлы и попросит удалить агента в приложении.
Установка
Linux и macOS:
curl -fsSL https://raw.githubusercontent.com/alllexey-dev/itmo-widgets-agent/main/install.sh | shFreeBSD:
fetch -qo - https://raw.githubusercontent.com/alllexey-dev/itmo-widgets-agent/main/install.sh | shWindows (PowerShell):
irm https://raw.githubusercontent.com/alllexey-dev/itmo-widgets-agent/main/install.ps1 | iexУстановщик берёт последний релиз, сверяет SHA-256 с SHA256SUMS, подключает агента к телефону; запуск в терминале без флагов показывает меню (статус, служба, обновление, удаление). Бинарник вручную: файл для своей системы ниже (linux-amd64, linux-arm64, darwin-amd64, darwin-arm64, freebsd-amd64, freebsd-arm64, windows-amd64.exe) и SHA256SUMS.
Docker (linux/amd64 и linux/arm64): ghcr.io/alllexey-dev/itmo-widgets-agent:0.1.1, тег :0 следует за последней версией 0.x. Обновление: docker compose pull && docker compose up -d.
Что нужно
- Доступ к бете: сервер включает агента только пользователям из списка, его включает администратор.
- Сборка ITMO.Widgets с подключением устройств ("Подключить устройство" в профиле).
Известные ограничения
- Сессия ITMO.ID общая с телефоном: выход из ITMO.ID отключит и агент, а когда истечёт её максимальный срок, войдите в приложение заново и выполните
pair --session. - Бинарники не подписаны: на macOS после скачивания браузером снимите карантин (
xattr -d com.apple.quarantine). Установщик делает это сам. attachна Windows нужен Windows 10 1803 или новее.
v0.1.0
Первый бета-релиз своего клиента ITMO.Widgets.
Что это
Маленькая фоновая программа для вашего ноутбука, NAS или сервера. Она получает события от сервера ITMO.Widgets и действует от вашего имени в вашей сессии My ITMO: главное - записывает на физкультуру из очереди, когда телефон этого сделать не может (например, на iPhone без пушей). Может присылать уведомления через ntfy. Один статический бинарник без зависимостей.
Установка
Бинарник: скачайте файл для своей системы ниже (linux-amd64, linux-arm64, darwin-amd64, darwin-arm64, windows-amd64.exe), сверьте с SHA256SUMS, переименуйте в itmo-widgets-agent и положите в PATH. Примеры служб для автозапуска (launchd и systemd --user) - в папке deploy/.
Docker (linux/amd64 и linux/arm64):
curl -O https://raw.githubusercontent.com/alllexey-dev/itmo-widgets-agent/main/compose.yaml
docker compose run --rm agent pair
docker compose up -dОбраз: ghcr.io/alllexey-dev/itmo-widgets-agent:0.1.0, тег :0 следует за последней версией 0.x.
Подключение
itmo-widgets-agent pair показывает QR-код и ссылку (действует 2 минуты, не пересылайте её). На телефоне: ITMO.Widgets -> Профиль -> "Подключить устройство" -> отсканируйте QR, сверьте код проверки и нажмите "Подключить". Потом itmo-widgets-agent run или служба. Подробности - в README.
Что нужно
- Доступ к бете: сервер включает агента только пользователям из списка, его включает администратор.
- Сборка ITMO.Widgets с подключением устройств ("Подключить устройство" в профиле).
Известные ограничения
unpairпока не может отозвать токен на сервере: сервер ещё не поддерживаетDELETE /api/agent/self. Агент удалит токен и сессию у себя и попросит удалить его в приложении: Профиль -> "Подключённые устройства". Сделайте это, чтобы агент пропал из списка.- Сессия ITMO.ID общая с телефоном: выход из ITMO.ID отключит и агент, а когда истечёт её максимальный срок, войдите в приложение заново и выполните
pair --session. - Бинарники не подписаны: на macOS после скачивания браузером снимите карантин (
xattr -d com.apple.quarantine).