From 7e14bcf535d3ad39ee538c6d66e8882fc75d466b Mon Sep 17 00:00:00 2001
From: Alexey Martemyanov <mallexxx@gmail.com>
Date: Sat, 30 May 2026 15:05:50 +0600
Subject: [PATCH] [2026-05-30] add wide grid poster procedure to
 steam-nonsteam-shortcuts doc

---
 .../how-to/htpc-steam-nonsteam-shortcuts.md   | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/family/how-to/htpc-steam-nonsteam-shortcuts.md b/family/how-to/htpc-steam-nonsteam-shortcuts.md
index b2b6c42c..ef9d1983 100755
--- a/family/how-to/htpc-steam-nonsteam-shortcuts.md
+++ b/family/how-to/htpc-steam-nonsteam-shortcuts.md
@@ -88,3 +88,55 @@ with open(CONFIG_PATH, 'w') as f:
 ## Перезагрузка Steam
 
 После записи VDF — перезапустить Steam, чтобы он подхватил изменения.
+
+## Wide Steam Grid Posters
+
+При добавлении новой не-Steam игры — сразу скачивай и **wide** (920×430, `{appid}.png`), а не только poster (600×900, `{appid}p.png`).
+Без wide постером игра выглядит как пустая белая заглушка в основном режиме библиотеки.
+
+### Naming convention
+
+Файлы кладутся в `~/.steam/steam/userdata/147839491/config/grid/`:
+
+| Размер | Формат файла | Назначение |
+|--------|-------------|------------|
+| 920×430 | `{unsigned_appid}.png` | Wide — основная карточка в библиотеке |
+| 600×900 | `{unsigned_appid}p.png` | Poster — вертикальный, при наведении |
+| 1920×620 | `{unsigned_appid}_hero.png` | Hero — фон на странице игры |
+| 1200×351 | `{unsigned_appid}_logo.png` | Логотип на hero |
+
+**Unsigned appid** = `signed_appid & 0xFFFFFFFF`. Пример: `-1321720074` → `2973247222`.
+
+### Процедура (как делал Whale)
+
+1. **Найти постеры на SteamGridDB** — зайти на `https://www.steamgriddb.com/game/<ID>`, отфильтровать по 920×430.
+   - Для новых игр: поискать `<игра> site:steamgriddb.com`
+   - Wide grids часто меньше по количеству чем posters (600×900), их ищем в секции Grids → фильтр `Dimensions: 920×430`
+
+2. **Получить прямую ссылку CDN** — thumbnails на странице grid'a ведут на `cdn2.steamgriddb.com/thumb/<hash>.jpg`, а полный файл лежит по `cdn2.steamgriddb.com/grid/<hash>.png`.
+
+3. **Скачать локально:**
+   ```bash
+   curl -s -o /tmp/<appid>.png "https://cdn2.steamgriddb.com/grid/<hash>.png"
+   ```
+
+4. **Закинуть на HTPC** через scp в `/tmp/`:
+   ```bash
+   scp /tmp/<appid>.png bazzite@192.168.1.86:/tmp/<appid>.png
+   ```
+
+5. **Скопировать в grid-директорию Steam:**
+   ```bash
+   ssh bazzite@192.168.1.86
+   cp /tmp/<appid>.png ~/.steam/steam/userdata/147839491/config/grid/<appid>.png
+   ```
+
+6. **Перезапустить Steam** (Steam перечитывает grid-файлы свежими при старте, но часто подхватывает и без перезапуска):
+   ```bash
+   systemctl --user stop gamescope-session-plus@steam.service
+   systemctl --user start gamescope-session-plus@steam.service
+   ```
+
+### SteamGridDB ключ API
+
+`5f0a7cb3366dede2c10860a95795ce60` — для программного доступа.