diff --git a/family/how-to/htpc.md b/family/how-to/htpc.md
index 2f95fc1e..0cb2cefd 100644
--- a/family/how-to/htpc.md
+++ b/family/how-to/htpc.md
@@ -48,3 +48,10 @@ WoL должен быть включён в BIOS/UEFI. Проверить нас
 sudo ethtool enp<X>  # смотреть Wake-on: g
 sudo ethtool -s enp<X> wol g  # включить
 ```
+
+
+## Виртуальная клавиатура
+
+Установлен **vboard** (fork mallexxx/vboard, ветка `htpc-bazzite-patches`).
+
+Полная дока с патчами и известными проблемами: [[virtual-keyboard-bazzite]]
diff --git a/family/how-to/virtual-keyboard-bazzite.md b/family/how-to/virtual-keyboard-bazzite.md
new file mode 100644
index 00000000..8d3f3f10
--- /dev/null
+++ b/family/how-to/virtual-keyboard-bazzite.md
@@ -0,0 +1,172 @@
+# Виртуальная клавиатура на HTPC (Bazzite KDE Wayland)
+
+Связано: [[htpc]] | [[magic4pc-webos]]
+
+## Контекст
+
+**HTPC:** [[htpc]] (192.168.1.86, Bazzite, KDE Plasma 6, Wayland)  
+Задача: экранная клавиатура для редкого ввода текста без физической клавиатуры.
+
+---
+
+## Изученные варианты
+
+### ❌ Maliit (официальная KDE клавиатура)
+- Единственный officially supported OSK для KDE Wayland
+- **Критический баг (upstream, не Bazzite):** появляется один раз, после скрытия повторно не открывается без `pkill maliit-keyboard && maliit-keyboard`
+- На Bazzite desktop: опция Virtual Keyboard вообще отсутствует в Accessibility Settings
+- Статус: **не пригоден для HTPC**
+
+### ❌ Onboard
+- Полнофункциональная клавиатура с modifier keys
+- Работает через XWayland + uinput (`GDK_BACKEND=x11 onboard`)
+- Не rpm-ostree пакет, требует `rpm-ostree install onboard` (layered package)
+- Нет трея, нет интеграции с KDE Virtual Keyboard API
+- Статус: **рабочий fallback, но хуже vboard**
+
+### ✅ vboard (выбранное решение)
+- Форк: [archisman-panigrahi/vboard](https://github.com/archisman-panigrahi/vboard) (оригинал mdev588/vboard заброшен/заархивирован)
+- Наш форк с патчами: [mallexxx/vboard](https://github.com/mallexxx/vboard) ветка `htpc-bazzite-patches`
+- Python + GTK3 + uinput backend
+- Нативный Wayland на KDE Plasma, трей, регистрируется как Virtual Keyboard
+
+---
+
+## Установка на Bazzite
+
+### Зависимости (pip, без rpm-ostree)
+```bash
+pip3 install python-uinput meson ninja
+```
+> `/dev/uinput` уже доступен через Steam ACL (`user:bazzite:rw-` через `steam-devices` udev rules) — sudo не нужен.
+
+### Сборка и установка (user scope)
+```bash
+git clone https://github.com/mallexxx/vboard.git
+cd vboard
+git checkout htpc-bazzite-patches
+
+meson setup builddir-user --prefix=$HOME/.local
+meson compile -C builddir-user
+meson install -C builddir-user
+# Создаёт KWin rule автоматически
+```
+
+### Регистрация как KDE Virtual Keyboard
+```bash
+kwriteconfig6 --file kwinrc --group Plugins --key kwin_wayland_vkbd_plugin 'io.github.archisman-panigrahi.vboard'
+kwriteconfig6 --file kwinrc --group Plugins --key VirtualKeyboardEnabled true
+```
+Проверить: System Settings → Input Devices → Virtual Keyboard → выбрать Vboard.
+
+---
+
+## Известные проблемы и решения
+
+### ⚠️ Ввод не работает (NullInputBackend)
+**Причина:** `python-uinput` из pip не имеет `KEY_LESS` (есть только в системном пакете).  
+UInputBackend падает при инициализации → fallback на NullInputBackend → нажатия игнорируются.
+
+**Патч** (`vboard/input_backends.py`):
+```python
+# было:
+"<": uinput.KEY_LESS,
+# стало:
+"<": uinput.KEY_102ND,
+```
+`KEY_102ND` — стандартный keycode для клавиши `<`/`>` на европейских раскладках, есть в pip-версии.
+
+### ⚠️ Автопоказ/скрытие по фокусу поля не работает
+**Причина:** vboard не реализует `zwp_input_method_v2` Wayland протокол.  
+KDE запускает его как процесс, но сигналы "show/hide" не передаются.  
+**Решение:** оставить как есть — клавиатура висит поверх, управление через трей.
+
+### ⚠️ Русская раскладка вводит латиницу
+**Причина:** vboard шлёт физические keycodes (KEY_Q и т.д.), система переводит по своей раскладке.  
+**Решение:** синхронизировать системную раскладку KDE через D-Bus при переключении (см. патчи ниже).
+
+### ⚠️ Таскбар исчез при попытке закрепить иконку через kwriteconfig
+**Причина:** неверный group path в `plasma-org.kde.plasma.desktop-appletsrc` → plasmashell упал.  
+**Решение:** `plasmashell --replace` через SSH.  
+**Правильный способ** закрепить иконку: правый клик на `^` → Configure System Tray → Entries → Virtual Keyboard → Always Shown.
+
+---
+
+## Кастомные патчи (ветка htpc-bazzite-patches)
+
+### 1. Скрыть кнопку закрытия
+`vboard/window.py`:
+```python
+# было:
+self.header.set_show_close_button(True)
+# стало:
+self.header.set_show_close_button(False)
+```
+
+### 2. Кнопка переключения EN/RU в хедере
+`vboard/window.py` — в `create_settings()` после ESC кнопки:
+```python
+self.lang_button = Gtk.Button(label=self.keyboard_layout.upper())
+self.lang_button.connect("clicked", self.cycle_keyboard_layout)
+self.lang_button.set_name("esc-button")
+self.header.pack_start(self.lang_button)
+```
+
+Новые методы:
+```python
+def cycle_keyboard_layout(self, widget=None):
+    keys = [k for k, _ in KEY_LAYOUT_CHOICES]
+    idx = keys.index(self.keyboard_layout) if self.keyboard_layout in keys else 0
+    next_key = keys[(idx + 1) % len(keys)]
+    self.set_keyboard_layout(next_key)
+    self.lang_button.set_label(next_key.upper())
+    self.sync_system_layout(next_key)
+
+def sync_system_layout(self, layout_key):
+    import subprocess
+    layout_map = {"en": "0", "ru": "1"}
+    index = layout_map.get(layout_key)
+    if index is None:
+        return
+    try:
+        subprocess.Popen([
+            "qdbus", "org.kde.keyboard", "/Layouts",
+            "org.kde.KeyboardLayouts.setLayout", index
+        ], env=dict(__import__("os").environ,
+                    DBUS_SESSION_BUS_ADDRESS="unix:path=/run/user/1000/bus"))
+    except Exception:
+        pass
+```
+> Индексы `en=0, ru=1` соответствуют порядку раскладок в KDE: проверить через  
+> `qdbus --literal org.kde.keyboard /Layouts org.kde.KeyboardLayouts.getLayoutsList`
+
+### 3. Только EN/RU раскладки
+`vboard/constants.py`:
+```python
+KEY_LAYOUT_CHOICES = (
+    ("en", "English (US)"),
+    ("ru", "Russian"),
+)
+```
+
+---
+
+## Управление
+
+```bash
+# Запустить вручную (обычно KDE делает сам)
+XDG_RUNTIME_DIR=/run/user/1000 WAYLAND_DISPLAY=wayland-0 \
+  DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/1000/bus \
+  python3 ~/.local/bin/vboard &
+
+# Перезапустить
+kill -9 $(pgrep -f vboard)
+# KDE перезапустит автоматически через ~3 сек
+
+# Проверить что backend работает
+python3 -c "
+import sys; sys.path.insert(0, '$HOME/.local/share/vboard')
+from vboard.input_backends import UInputBackend
+b = UInputBackend(); print('OK')
+"
+```