From 8c1cf5b4352233137494ff18d66fc9e2c8364bfc Mon Sep 17 00:00:00 2001
From: Taiga <taiga@hermes>
Date: Sun, 21 Jun 2026 15:47:39 +0000
Subject: [PATCH] [2026-06-21] taiga-vault:
 family/how-to/htpc-emulators-setup.md

---
 family/how-to/htpc-emulators-setup.md | 35 +++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 5 deletions(-)

diff --git a/family/how-to/htpc-emulators-setup.md b/family/how-to/htpc-emulators-setup.md
index c83d69d9..afcf31f8 100644
--- a/family/how-to/htpc-emulators-setup.md
+++ b/family/how-to/htpc-emulators-setup.md
@@ -419,14 +419,14 @@ CACHE="$HOME/.var/app/org.libretro.RetroArch/config/retroarch/system/Mupen64plus
 | The Legend of Zelda: Breath of the Wild | `zelda_botw.nsp` | ✅ работает |
 | Spyro Reignited Trilogy | `spyro_reignited_trilogy.nsp` | ✅ работает |
 | Majora's Mask (2Ship2Harkinian) | `majoras_mask.nsp` | ❌ PAL_SEHException (GPU crash) |
-| Donkey Kong Country Returns HD | `donkey_kong_country_returns_hd.nsp` | ✅ работает (конвертирован NSZ→NSP) |
+| Donkey Kong Country Returns HD | `donkey_kong_country_returns_hd.nsp` | ⏳ конвертация NSZ→NSP |
 | Hollow Knight | `hollow_knight.nsp` | ❌ Hash error (битый ROM) |
 | Hollow Knight: Silksong | `hollow_knight__silksong.nsp` | ✅ конвертирован NSZ→NSP |
 | It Takes Two | `it_takes_two.nsp` | ❓ |
 | Little Nightmares | `little_nightmares.nsp` | ❓ |
 | Little Nightmares III | `little_nightmares_iii.nsp` | ❓ |
 | Luigi Mansion 3 | `luigi_mansion_3.nsp` | ❓ |
-| Ori and the Will of the Wisps | `ori_and_the_will_of_the_wisps.nsp` | ✅ конвертирован NSZ→NSP |
+| Ori and the Will of the Wisps | `ori_and_the_will_of_the_wisps.nsp` | ⏳ конвертация NSZ→NSP |
 | Plants vs. Zombies: Replanted | `plants_vs__zombies__replanted.nsp` | ✅ конвертирован NSZ→NSP |
 | Super Mario 3D All-Stars | `super_mario_3d_all_stars.nsp` | ❓ |
 | Super Mario 3D World + Bowser Fury | `super_mario_3d_world___bowser_fury.nsp` | ✅ конвертирован NSZ→NSP |
@@ -459,13 +459,38 @@ CACHE="$HOME/.var/app/org.libretro.RetroArch/config/retroarch/system/Mupen64plus
 **Launcher:** `~/Emulation/tools/launchers/ryujinx.sh` — ищет `~/Applications/publish/Ryujinx.sh` → не находит (`.bak`) → запускает `flatpak run io.github.ryubing.Ryujinx`.
 **Логирование:** `~/ryujinx-launch.log` — PWD, ARGS, EXE, EXIT_CODE.
 
-**Ryujinx не поддерживает NSZ нативно** — только NSP и XCI. NSZ нужно конвертировать в NSP (SAK / Switch Army Knife) или скачивать NSP версии.
+**Ryujinx не поддерживает NSZ нативно** — только NSP и XCI. NSZ нужно конвертировать в NSP.
+
+**NSZ → NSP конвертация (21.06.2026):**
+Установлен `nsz` CLI (v4.6) на HTPC через `pip3 install nsz`. 
+Проблемы:
+- `nsz` создаёт файл с именем `nsp` (без расширения) в output-директории, а не `*.nsp`
+- Пришлось делать `mv /tmp/nsp /target/name.nsp` после каждой конвертации
+- `/tmp` — tmpfs 16GB, Smash Ultimate (14GB) с трудом влезает
+- Скрипты с `set -e` + `grep` в пайпе ломались (exit 1 из grep)
+- **Важно:** сначала создали NSP файлы с короткими именами, затем пересоздали симлинки на них
+
+**Статус конвертации (21.06.2026):**
+| Игра | NSZ→NSP | Симлинк | В Steam |
+|------|---------|---------|---------|
+| Disney Afternoon Collection | ✅ 333MB | ✅ | ✅ (был) |
+| Plants vs Zombies Replanted | ✅ 1281MB | ✅ | ✅ (был) |
+| Vasilisa and Baba Yaga | ✅ 629MB | ✅ | ✅ (был) |
+| Hollow Knight Silksong | ✅ 1813MB | ✅ | ✅ (был) |
+| Super Mario 3D World + Bowser Fury | ✅ 2119MB | ✅ | ✅ (был) |
+| Unravel Two | ✅ 1845MB | ✅ | ✅ (был) |
+| Hunting Simulator 2 | ✅ 4046MB | ✅ | ✅ (был) |
+| Carnivores Dinosaur Hunt | ✅ 417MB | ✅ | ✅ (был) |
+| Ori and the Will of the Wisps | ⏳ идёт | нужен | нужен |
+| Donkey Kong Country Returns HD | ⏳ идёт | нужен | нужен |
+| Super Smash Bros. Ultimate | ⏳ идёт | нужен | нужен |
 
 **TODO:**
-- [ ] Конвертировать NSZ → NSP или найти NSP версии ROMов (Hollow Knight, Василиса, Carnivores и др.)
+- [ ] Дождаться конвертации Ori, DKCR HD, Smash Ultimate
+- [ ] Сделать симлинки для них
+- [ ] Добавить в Steam (VDF) + artwork
 - [ ] Обновить firmware до 22.1.0 под свежие prod.keys
 - [ ] Найти title.keys (missing `key_area_key_application_14`)
-- [ ] Проверить все 35 игр после конвертации NSZ → NSP
 
 ---