[2026-05-16] htpc-emulators-setup: добавлен раздел Steam shortcuts + artwork

family/how-to/htpc-emulators-setup.md

@@ -188,6 +188,54 @@ gba_data   → /run/media/bazzite/Data/gba roms
 
 ---
 
+## Steam библиотека — shortcuts и artwork
+
+**Статус:** ✅ 61 игра добавлена в Steam (16.05.2026), запускаются из Gaming Mode.
+
+### Как добавлено
+
+Прямая запись в `~/.steam/steam/userdata/<uid>/config/shortcuts.vdf` через Python + `vdf` библиотека.  
+Скрипт: `/tmp/add_shortcuts.py` (можно восстановить при необходимости).
+
+**Формат записи:**
+```python
+sc['Exe'] = '/home/bazzite/Emulation/tools/launchers/retroarch.sh'  # или dolphin-emu.sh
+sc['LaunchOptions'] = '-L /home/bazzite/.var/.../core.so /path/to/rom'
+```
+
+⚠️ **Важно:** `~` в путях не разворачивается — только абсолютные пути `/home/bazzite/...`  
+⚠️ **Важно:** Steam перезаписывает shortcuts.vdf при запуске — писать только пока Steam закрыт.
+
+### Игры по эмуляторам
+
+| Эмулятор | Launcher | Игр |
+|----------|----------|-----|
+| Dolphin (Wii/GC) | `launchers/dolphin-emu.sh` | 10 |
+| RetroArch SNES | `launchers/retroarch.sh` + `snes9x_libretro.so` | 11 |
+| RetroArch N64 | `launchers/retroarch.sh` + `mupen64plus_next_libretro.so` | 11 |
+| RetroArch GBA | `launchers/retroarch.sh` + `mgba_libretro.so` | 2 |
+| RetroArch Genesis | `launchers/retroarch.sh` + `genesis_plus_gx_libretro.so` | 8 |
+| RetroArch MAME | `launchers/retroarch.sh` + `mame2003_plus_libretro.so` | 19 |
+
+### Artwork (SteamGridDB)
+
+API ключ: `~/Documents/steamgriddb_api_key.txt`  
+Скрипт: `/tmp/get_artwork.py`  
+Скачивает: cover (`{appid}p.png`), hero (`{appid}_hero.png`), logo (`{appid}_logo.png`)  
+Результат: 60/61 ok (Aladdin — нет арта на SteamGridDB)  
+Grid dir: `~/.steam/steam/userdata/<uid>/config/grid/`
+
+```bash
+# Перескачать / добавить новые игры:
+python3 /tmp/get_artwork.py
+```
+
+### Описания — недоступно
+
+Steam не поддерживает описания для non-Steam shortcuts — ни через vdf, ни через API. Ограничение самого Steam.
+
+---
+
 ## TODO: DOS / Windows Standalone
 
 - [ ] Discworld (DOS) — настроить через DOSBox в RetroArch или DOSBox Staging standalone