[2026-06-10] taiga-vault: family/how-to/htpc-emulators-setup.md

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

@@ -245,40 +245,41 @@ sc['LaunchOptions'] = '-L /home/bazzite/.var/.../core.so /path/to/rom'
 
 ### Artwork (SteamGridDB)
 
-API ключ: `~/Documents/steamgriddb_api_key.txt` + `~/.bashrc` (STEAMGRIDDB_API_KEY)  
-Значение: `5f0a7cb3366dede2c10860a95795ce60`  
+API ключ: `5f0a7cb3366dede2c10860a95795ce60`  
+Хранится: `~/Documents/steamgriddb_api_key.txt` и `~/.bashrc` (STEAMGRIDDB_API_KEY)
 
-**Скрипты (на HDD):**
+**API:**
 ```bash
-/run/media/system/Data/scripts/update-steam-artwork.py         # эмуляторы (все)
-/run/media/system/Data/scripts/update-steam-artwork-windows.py # Windows игры
-/run/media/system/Data/scripts/update-doom-artwork.py          # Doom 3 BFG
-/run/media/system/Data/scripts/update-vk-artwork.py            # VK GameCenter + Atomic Heart
+curl -s \
+  -H "Authorization: Bearer 5f0a7cb3366dede2c10860a95795ce60" \
+  -H "Accept: application/json" \
+  "https://www.steamgriddb.com/api/v2/search/autocomplete/<query>"
 ```
 
-Скачивают: cover (`{appid}p.png`), wide (`{appid}.png` 920×430), hero (`{appid}_hero.png`), logo (`{appid}_logo.png`)  
-Если wide (920×430) нет на SGDB — копирует portrait как fallback  
-Grid dir: `~/.steam/steam/userdata/147839491/config/grid/`
+**Скрипты на HDD** (`/run/media/system/Data/scripts/`):
+- `update-steam-artwork.py` — для эмуляторов (все shortcut'ы)
+- `update-steam-artwork-windows.py` — для Windows игр
+- `update-doom-artwork.py` — Doom 3 BFG
+- `update-vk-artwork.py` — VK GameCenter + Atomic Heart VK
 
+**Формат файлов в `~/.steam/steam/userdata/147839491/config/grid/`:**
+- `{appid}p.png` — cover (portrait, 600×900)
+- `{appid}.png` — wide (920×430)
+- `{appid}_hero.png` — hero
+- `{appid}_logo.png` — logo
+
+**Запуск:**
 ```bash
-# Перескачать / добавить новые игры:
 python3 /run/media/system/Data/scripts/update-steam-artwork.py
-python3 /run/media/system/Data/scripts/update-steam-artwork-windows.py
-
-# Принудительно перекачать конкретные AppID — добавь appid в FORCE в начале скрипта
 ```
 
-**Статус API (2026-06-10):** Cloudflare на SteamGridDB блокирует Python/curl запросы (Error 1010). Если постеры не скачиваются — обновить ключ или качать вручную.
-
-**Имена игр важны**: SteamGridDB ищет по имени из shortcuts.vdf.  
-Неправильное имя → неправильный арт (пример: "Disco Noir" → Disco Elysium).  
-После переименования shortcut — перезапустить скрипт с force для нужных AppID.  
-
-**Перезапуск Steam после смены арта:**
+Перезапуск Steam после смены арта:
 ```bash
 systemctl --user restart gamescope-session-plus@steam.service
 ```
 
+**Имена игр важны** — SteamGridDB ищет по `AppName` из shortcuts.vdf. Неправильное имя → неправильный арт.
+
 ### Описания — недоступно
 
 Steam не поддерживает описания для non-Steam shortcuts — ни через vdf, ни через API. Ограничение самого Steam.