# StayHere

Маленька портативна утиліта для Windows, без .NET та інсталяції.

У KSwitcher v0.6.46 і новіших виберіть **Utilities → StayHere** у меню трея
або запустіть `tools/StayHere.exe` поруч із KSwitcher.exe.
Зелена крапка в треї означає, що підтримка активності ввімкнена.
Клацання лівою кнопкою перемикає режим; правою — відкриває меню з перемикачем і виходом.
Після кожного запуску режим увімкнений. Автозапуск не додається.

Раз на 15 секунд перевіряється час бездіяльності. Після 3 хвилин без вводу
надсилається натискання й відпускання F15. Поки ви працюєте, клавіші не надсилаються.
Курсор миші не рухається. Увімкнений режим також утримує екран і систему від
автоматичного сну. На заблокованому екрані та у відключеному сеансі активність
не імітується. Ручне блокування Windows не обходиться.

Механізм перенесено за поведінкою з Typlo. Він підтримує системну активність,
але не керує статусом Teams через API: статус залежить також від Teams,
календаря, інших пристроїв та політик організації. F15 може мати власне
призначення в окремих програмах. На підвищених вікнах Windows може блокувати ввід;
тоді підказка іконки показує помилку. Утиліта не запитує права адміністратора.

## Збірка

У репозиторії KSwitcher виконайте `./build.ps1 -Stage` з кореня проєкту.
Утиліта збирається з `utilities/StayHere/main.cpp` у `build/staged/tools/StayHere.exe`
і включається пакувальником у реліз. CMake також має ціль `StayHere`.
Для запуску достатньо одного `StayHere.exe`; .NET не потрібний.

CLI: `--pause`, `--resume`, `--exit` керують запущеним екземпляром.
`--status` повертає код 1 для активного режиму, 2 для паузи, 3 якщо утиліта не запущена.