diff --git a/family/how-to/htpc-emulators-setup.md b/family/how-to/htpc-emulators-setup.md index 394c3de3..739e0b20 100644 --- a/family/how-to/htpc-emulators-setup.md +++ b/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/" ``` -Скачивают: 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.