[2026-05-08] HTPC Bazzite docs: system, access, magic4pc, gaming plans

2026-05-08 00:47:38 +06:00
parent ec69b917e0
commit e083cd467c
4 changed files with 257 additions and 0 deletions
@@ -0,0 +1,67 @@
+# HTPC — Доступ и управление
+
+## SSH
+```bash
+ssh -i ~/.ssh/id_rsa bazzite@192.168.1.86
+```
+Пароль sudo: `bazzite`
+
+## Go (на HTPC)
+Go установлен в `/usr/local/go/bin/go` (не в PATH по умолчанию).  
+Сборка: `cd ~/magic4pc && /usr/local/go/bin/go build -o magic4pc_new .`
+
+## Git workflow (magic4pc)
+- Mac: `~/Developer/magic4pc_altclient`, бранч `bazzite-linux`
+- Remote `linux` → `ssh://bazzite@192.168.1.86/var/home/bazzite/magic4pc.git` (bare repo)
+- Worktree на HTPC: `/home/bazzite/magic4pc`
+- Remote `origin` → `https://github.com/mallexxx/magic4pc_altclient.git`
+
+Деплой:
+```bash
+# На Mac:
+git push linux bazzite-linux
+
+# На HTPC:
+cd ~/magic4pc && git pull && /usr/local/go/bin/go build -o magic4pc_new .
+sudo systemctl stop magic4pc
+sudo rm /usr/local/bin/magic4pc
+sudo cp magic4pc_new /usr/local/bin/magic4pc
+sudo systemctl start magic4pc
+```
+
+> ⚠️ Нельзя `cp` поверх работающего бинаря — "Text file busy". Всегда сначала `stop` → `rm` → `cp` → `start`.
+
+## systemd сервис
+Файл: `/etc/systemd/system/magic4pc.service`
+```ini
+[Unit]
+Description=Magic Remote client for LG TV
+After=network.target
+
+[Service]
+User=bazzite
+Group=bazzite
+ExecStart=/usr/local/bin/magic4pc-run.sh
+Restart=always
+RestartSec=5
+StartLimitIntervalSec=0
+
+[Install]
+WantedBy=multi-user.target
+```
+
+`StartLimitIntervalSec=0` — без лимита рестартов (иначе при crash-loop убивается).
+
+## Run script
+`/usr/local/bin/magic4pc-run.sh` — ждёт X display, делает `xhost +local:`, запускает бинарь.
+
+## ydotoold
+User-юнит: `~/.config/systemd/user/ydotoold.service`  
+Socket: `/run/user/1000/.ydotool_socket`  
+Управление: `systemctl --user status ydotoold`
+
+## Логи
+```bash
+journalctl -u magic4pc -n 50 --no-pager
+journalctl -u magic4pc -f  # live
+```
@@ -0,0 +1,65 @@
+# HTPC — Планы: Игры и Эмуляторы
+
+## Статус системы
+- [x] Bazzite установлен, автологин в Gaming Mode
+- [x] 1080p@60Hz, аудио LPCM работает
+- [x] LG Magic Remote работает (magic4pc)
+- [x] Без пароля при входе
+- [ ] EmuDeck
+- [ ] Proton-GE
+- [ ] MangoHud
+- [ ] Эмуляторы
+
+## Следующие шаги
+
+### 1. EmuDeck
+Установка через официальный скрипт:
+```bash
+# В KDE Desktop Mode (не gamescope):
+curl -L https://raw.githubusercontent.com/dragoonDorise/EmuDeck/main/install.sh | bash
+```
+Настроит RetroArch, PCSX2, Yuzu/Ryujinx и др. автоматически.  
+ROM-и класть в `~/Emulation/roms/<system>/`
+
+### 2. Proton-GE
+Через ProtonUp-Qt (устанавливается из Discover или Flatpak):
+```bash
+flatpak install flathub net.davidotek.pupgui2
+```
+Или через EmuDeck — он включает ProtonUp-Qt.
+
+### 3. MangoHud (FPS overlay)
+Уже есть в Bazzite. Включить для игры:
+- В Steam: Properties → Launch Options: `mangohud %command%`
+- Глобально: `MANGOHUD=1` в environment
+
+### 4. Эмуляторы (план)
+
+| Платформа | Эмулятор | Статус |
+|-----------|----------|--------|
+| NES | RetroArch (Nestopia) | Через EmuDeck |
+| SNES | RetroArch (bsnes/Snes9x) | Через EmuDeck |
+| Sega Mega Drive | RetroArch (Genesis Plus GX) | Через EmuDeck |
+| PS2 | PCSX2 | Через EmuDeck |
+| N64 | RetroArch (Mupen64Plus) | Через EmuDeck |
+| Switch | Ryujinx (или Suyu) | Через EmuDeck |
+
+### 5. ROM-и
+Скопировать в `~/Emulation/roms/` по папкам после установки EmuDeck.  
+EmuDeck сам создаст структуру директорий.
+
+### 6. Steam ROM Manager
+Входит в EmuDeck — добавляет эмуляторные игры в Steam библиотеку с обложками.  
+После добавления они появятся в Gaming Mode как обычные Steam игры.
+
+## Железо — ограничения
+- RX 570: Switch эмуляция может быть медленной (Vulkan поддерживается)
+- i7-6800K (Broadwell-E): PS2 и Switch — проверить производительность
+- 32GB RAM: достаточно для всего
+
+## Управление в эмуляторах
+Magic Remote (magic4pc) работает как мышь + клавиатура.  
+Для эмуляторов нужен геймпад — варианты:
+- Bluetooth геймпад (PS4/PS5/Xbox)
+- USB геймпад
+- Настроить маппинг Magic Remote кнопок на gamepad через Steam Input (если эмулятор в Steam)
@@ -0,0 +1,60 @@
+# magic4pc — LG Magic Remote для HTPC
+
+## Что это
+Go-клиент для LG Magic Remote (webOS приложение на TV).  
+Форк: https://github.com/mallexxx/magic4pc_altclient (бранч `bazzite-linux`)  
+Оригинал: https://github.com/netham45/magic4pc_altclient
+
+## Архитектура
+- **TV сервер**: webOS приложение на LG TV (192.168.1.75:42831), шлёт UDP
+- **HTPC клиент**: `/usr/local/bin/magic4pc`, UDP-клиент на фиксированном source port **9106**
+- **xdotool**: единый persistent процесс через stdin pipe — мышь и клавиши
+- **ydotool**: для gamescope-специфичных команд (Ctrl+1, Ctrl+2) через `/run/user/1000/.ydotool_socket`
+
+## Ключевые фиксы (история)
+| Проблема | Решение |
+|----------|---------|
+| TV "service error" / не реконнектится | Фиксированный source UDP port 9106 (`ListenUDP(":9106")`) |
+| TV зависает в "waiting for client" | Server keepalive timeout 10s → auto-reconnect |
+| KDE XTest диалог при каждом клике | Единый xdotool процесс (не новый на каждую кнопку) |
+| KDE XTest диалог при рестарте xdotool | `XwaylandEisNoPrompt=true` в kwinrc |
+| Кривые координаты мыши | Динамический scale через `xdotool getdisplaygeometry` |
+| Крестик слал Ctrl/a/s/d | TV keycodes 37-40 → `Left/Up/Right/Down` keysym |
+| Цифры слали мусор | ASCII keycodes → `string(rune(key))` |
+
+## Маппинг кнопок
+| Кнопка | Keycode | Gaming Mode (gamescope) | KDE Desktop |
+|--------|---------|------------------------|-------------|
+| Красная | 403 | Ctrl+1 (Steam меню) | Super (Win) |
+| Зелёная | 404 | Escape | Escape |
+| Жёлтая | 405 | Ctrl+2 (Steam QAM) | Средняя кнопка мыши |
+| Синяя | 406 | Правый клик | Правый клик |
+| Back | 461 | Mouse X1 (back) | Mouse X1 (back) |
+| Enter/OK | 13 | Return | Return |
+| Ch Up | 33 | PageUp | PageUp |
+| Ch Down | 34 | PageDown | PageDown |
+| D-pad Left | 37 | Left | Left |
+| D-pad Up | 38 | Up | Up |
+| D-pad Right | 39 | Right | Right |
+| D-pad Down | 40 | Down | Down |
+| Play | 415 | XF86AudioPlay | XF86AudioPlay |
+| Stop | 413 | XF86AudioStop | XF86AudioStop |
+| Pause | 19 | XF86AudioPause | XF86AudioPause |
+| Цифры 0-9 | 48-57 | 0-9 | 0-9 |
+| GUIDE | 458 | Правый клик | Правый клик |
+| Мышь (тач) | — | mousemove (scaled) | mousemove (scaled) |
+| Тап | mousedown/up | Left click | Left click |
+| Скролл | wheel | scroll 4/5 | scroll 4/5 |
+
+## Определение сессии
+`isGamescopeSession()` — читает `/proc/*/cmdline`, ищет `kwin_wayland`. Если нет → gamescope.
+
+## Koordinаты мыши
+TV шлёт координаты в пространстве 0–1920 × 0–1080.  
+При старте xdotool запрашивается `xdotool getdisplaygeometry` → вычисляется scale.  
+Работает корректно при любом разрешении экрана.
+
+## Проблемы которые могут вернуться
+- **xdotool умирает** (write error) → KDE показывает XTest диалог. Разрешить и включить `XwaylandEisNoPrompt=true`.
+- **TV "service error"** — если висит намертво, cold reboot TV (выдернуть из розетки).
+- **Бинарь слетает** после `rpm-ostree upgrade` → пересобрать и скопировать.
@@ -0,0 +1,65 @@
+# HTPC — Система (Bazzite Linux)
+
+## Железо
+- CPU: Intel Core i7-6800K
+- RAM: 32 GB
+- GPU: AMD Radeon RX 570
+- Подключение к TV: HDMI
+- TV: LG webOS (192.168.1.75)
+- HTPC IP: 192.168.1.86
+
+## ОС
+- **Bazzite 44** (Fedora-based, immutable OSTree)
+- Вариант: `bazzite-deck` (Steam Gaming Mode / gamescope)
+- Пользователь: `bazzite`
+- Hostname: `htpc`
+
+## Режимы запуска
+- **Gaming Mode (gamescope-session-steam)** — автологин по умолчанию, Steam Big Picture
+- **KDE Desktop** — переключение из меню Steam → "Switch to Desktop"
+
+## Автологин
+Файл: `/etc/gdm/custom.conf`
+```ini
+[daemon]
+AutomaticLoginEnable=True
+AutomaticLogin=bazzite
+Session=gamescope-session-steam
+```
+
+## Переменные окружения
+`/etc/environment`:
+```
+GAMESCOPE_DISABLE_HDR=1
+```
+
+`~/.config/environment.d/gamescope.conf`:
+```
+GAMESCOPE_WIDTH=1920
+GAMESCOPE_HEIGHT=1080
+GAMESCOPE_REFRESH=60
+```
+
+## Разрешение
+- **1080p @ 60Hz** — рабочий режим
+- 4K вызывает AMD HDA audio clock bug: пиксельный клок ~594 MHz → HDMI audio 880 Hz вместо 440 Hz
+
+## Аудио
+TV поддерживает только LPCM 2ch, 32000/44100/48000/96000/192000 Hz, 16/20/24 bit.
+
+`~/.config/wireplumber/wireplumber.conf.d/fix-hdmi.conf` — S16LE, 48000 Hz, no suspend  
+`~/.config/pipewire/pipewire.conf.d/99-hdmi-fix.conf` — allowed-rates [44100, 48000]
+
+## OSTree / Обновления
+- `/usr/local/bin` слетает при `rpm-ostree` upgrade (новый `/usr` overlay)
+- Бинари держать в `/home/bazzite/` или пересобирать после обновлений
+- Проверить после апдейта: `systemctl status magic4pc`
+
+## KDE Xwayland настройки
+`~/.config/kwinrc`:
+```ini
+[Xwayland]
+EavesdropMode=2
+XwaylandEisNoPrompt=true
+```
+`XwaylandEisNoPrompt=true` — отключает диалог разрешения XTest (нужен для magic4pc/xdotool).