Коротко: причина, следующее действие и ссылка на полный раздел, если одного шага мало.
Нужен Input Monitoring. Accessibility недостаточно. Закройте приложение, удалите старые записи Keyboard Layout или Keyboard Helper в System Settings > Privacy & Security > Input Monitoring, добавьте текущий app из /Applications, включите его и перезапустите.
Preview-сборки ad-hoc-signed и не notarized. Откройте app один раз, затем нажмите System Settings > Privacy & Security > Open Anyway. Полный порядок есть в первом запуске.
Закрытие прячет оверлей в system tray. Верните окно из tray menu, горячей клавишей show/hide или запуском executable с --toggle.
Откройте Settings, включите нужные built-in layouts и используйте Add layout file... для внешнего JSON. Примеры есть в конфигурации desktop.
Активной раскладке нужна корректная bleLayerSource metadata, а desktop app - доступ к Bluetooth. Разбудите клавиатуру, проверьте UUID и permission, затем нажмите Connection > Reconnect BLE.
Обычно причина - разные подписи у локального debug build и подписанного preview. Удалите debug app и установите verified release. Private imports и permission state могут сброситься.
Скорее всего не выдан Nearby devices, нет Android pairing или свободного ZMK Bluetooth profile. Выдайте permission, спарьте клавиатуру в system Settings, разбудите её и повторите connect.
Stock firmware не отдаёт Live telemetry. На compatible enhanced firmware нажмите клавишу или смените физический слой. Если waiting остаётся, reconnect. Live read-only и не меняет remote layer.
JSON или embedded image не прошли проверку, либо stored record стал недоступен. Проверьте version, asset references, bitmap type, base64, размеры, лимиты и duplicate name.
Функция только для macOS. Нужны inputSourceSync.macos, установленные input-source IDs и compatible writable BLE layer characteristic. Недоступный source отключается, а не угадывается.
Нажмите стрелку Restore full size в mini overlay. Режим временный: новый запуск открывает полное окно.
Self-test проверяет configured HID output для одного слоя в глобальном event stream. Он не определяет физическую клавиатуру, не активирует firmware layers и не диагностирует matrix wiring, combos, macros или hold-tap timing.
Игра использует focused window input и принимает простые английские буквы. Modifiers, repeats, composition input, releases и неподдерживаемые printable characters игнорируются.
Нет. Есть стандартные и эргономичные built-in layouts. Desktop читает внешний JSON. Android копирует валидный JSON в private app storage. Между desktop и Android нет cloud sync.