Оверлей для обучения слоям

SplitOverlay (приложение KeyOverlay): полупрозрачная подсказка с раскладкой вашей клавиатуры поверх любых окон. Смотрите на экран, а не на клавиши, пока слои не запомнились. Только для Windows.

Скачать Репозиторий

Что это

Оверлей рисует вашу плату по файлу раскладки Vial (.vil) и держит её поверх всех окон. Он прозрачен для мыши и не забирает фокус, поэтому не мешает работать. Сделан для программируемых (Vial / QMK) split-клавиатур, сейчас рассчитан на Silakka54.

Все слои: переключатели MO, TG, LT, mod-tap, Shift+цифра. Прозрачные клавиши слоя показываются приглушённо с нижнего слоя, как в QMK.
Слой определяется с платы автоматически (нужна альтернативная прошивка ниже). Без неё слой переключается вручную.
Символы по языку ввода: буквы на клавишах меняются вместе с раскладкой Windows (русская, английская и любая другая).
Две половины отдельными окнами, которые можно двигать независимо.
Подсветка нажатых клавиш, регулировка прозрачности и размера, значок в трее.

Как это выглядит

Оверлей, слой 0: буквы и цифры, нажатые клавиши Shift и 1 подсвечены синим, клавиши переключения слоёв TG 1 и MO 2 выделены янтарным — **Слой 0.** Нажатые клавиши подсвечены (здесь `Shift`+`1`), клавиши переключения слоёв выделены янтарным (`TG 1`, `MO 2`).

Оверлей, слой 1: символы и скобки слева, цифровой блок справа — **Слой 1.** Символы и скобки слева, цифровой блок справа. Приглушённые клавиши прозрачны: они работают как на слое ниже.

Режим разделения: левая половина отдельным окном, подпись «Слой 0 с платы» — **Левая половина** отдельным окном. Подпись «с платы» значит, что слой определяется клавиатурой.

Режим разделения: правая половина отдельным окном — **Правая половина**: окна двигаются независимо.

Оверлей при русской раскладке Windows: на клавишах русские буквы — **Язык RU.** Буквы на клавишах русские…

Оверлей при английской раскладке Windows: на клавишах латинские буквы — **Язык EN.** …и латинские после смены раскладки.

Скачать

Установщик KeyOverlay-1.0.0-setup.exe · 58 МБ

Ставится без прав администратора, создаёт ярлык; автозапуск по желанию, прошивки идут отдельным компонентом.

Скачать установщик

Портативная версия KeyOverlay-1.0.0-portable.zip · 58 МБ

Архив без установки: распакуйте в любую папку и запустите KeyOverlay.exe.

Скачать портативную версию

Windows, x64. Файл не подписан, поэтому SmartScreen может предупредить: нажмите «Подробнее» → «Выполнить в любом случае». Исходники открыты, собрать приложение можно самому. Все версии: страница релизов.

Альтернативная прошивка

Обычная клавиатура не сообщает компьютеру, какой слой сейчас активен, а в протоколе Vial такой команды нет. Поэтому для оверлея сделана прошивка с дополнительной командой: плата отвечает номером активного слоя, и оверлей переключается сам. Раскладку и подсветку команда не затрагивает, прошивка только читает состояние.

Для левой половины silakka54_vial_led_keyoverlay_LEFT.uf2 · 0,12 МБ Скачать LEFT.uf2

Для правой половины silakka54_vial_led_keyoverlay_RIGHT.uf2 · 0,12 МБ Скачать RIGHT.uf2

Собрана на основе прошивки Silakka54 v1.4led (Vial, подсветка слоёв). Исходники и сборка: папка firmware. Откат на оригинальную прошивку: релиз v1.4led проекта Silakka54.

Как прошить (RP2040)

В Vial сохраните раскладку: File → Save current layout. После обновления прошивки раскладка может сброситься.
Закройте Vial и оверлей, на время прошивки отключите кабель между половинами (TRRS).
Зажмите BOOT на плате и подключите USB (или дважды быстро нажмите reset): появится диск RPI-RP2.
Скопируйте на него файл своей половины (LEFT в левую, RIGHT в правую). Плата перезагрузится сама. Повторите для второй половины.
Соедините половины обратно, при необходимости загрузите сохранённую раскладку в Vial (File → Load saved layout). Кабель к компьютеру подключайте к главной половине (для файла LEFT это левая).

Прошивка меняет программу клавиатуры: сохраните раскладку заранее. Файлы сделаны именно для Silakka54 (LED, v1.4led), на других платах их использовать нельзя.

Быстрый старт

Сохраните раскладку в Vial: File → Save current layout (файл .vil). Тот же файл можно загрузить в разделе «Клавиатура» этого тренера.
Установите оверлей (права администратора не нужны) или распакуйте портативную версию.
При первом запуске выберите файл .vil. Можно передать путь и аргументом: KeyOverlay.exe "путь\к\раскладке.vil".
По желанию прошейте клавиатуру альтернативной прошивкой (выше): тогда слой определяется автоматически.

Действие	Как
Следующий / предыдущий слой	`Ctrl`+`Alt`+`PgDn` / `PgUp` (отключает автоопределение)
Показать / скрыть	`Ctrl`+`Alt`+`K` или двойной щелчок по значку в трее
Прозрачность, размер, слой, язык, разделение половинок, перечитать файл	меню значка в трее
Переместить оверлей	трей → «Режим перемещения», тащить мышью; колесо меняет размер

Что важно знать

Приватность. Перехват клавиш нужен только для подсветки нажатых клавиш и горячих клавиш. Нажатия нигде не сохраняются и не отправляются, приложение ничего не передаёт в сеть.
Ограничения. Только Windows x64. Раскладка рассчитана на Silakka54 (54 клавиши). Не держите Vial и оверлей открытыми одновременно: оба обращаются к одному HID-интерфейсу. Поверх игр в эксклюзивном полноэкранном режиме оверлея не будет.
Если слой не определяется («плата не отвечает»): проверьте, что прошиты обе половины, кабель подключён к главной, а Vial закрыт. Пока слой можно переключать вручную.
Лицензия. Приложение: MIT. Дополнение для прошивки: GPL-2.0-or-later, как QMK/Vial, в который оно собирается. Подробности и английское описание: README проекта.