diff --git a/MORE_STORES.md b/MORE_STORES.md
index ec7b3c4..651f4a0 100644
--- a/MORE_STORES.md
+++ b/MORE_STORES.md
@@ -92,6 +92,13 @@ A `shortcuts.vdf`-be írva a játékaink megjelennek a Steam könyvtárban borí
 ### 4. RetroArch playlistek
 `.lpl` JSON playlist platformonként. A cartridge-eket sokkal nagyobb közönségnek adja, mint a Batocera: Android, asztali gépek, konzolok. Kis formátum, kevés munka.
 
+**Kész (2026-08-17).** Terv és mérések: `RETROARCH_STORE.md`. Három repó:
+`engines/warpstore` (a kiemelt közös mag), `tools/warp-engine-retroarch-store`
+(motor), `tools/ttg-retroarch-store` (a mi store-unk). A Batocera-motor ugyanabban
+a körben átült a közös magra. **Hátra van:** valódi gépen kipróbálni, hogy a
+VICE-mag magától indítja-e a `.prg`-t, és hogy az Android `adb push` útvonalai
+állnak-e. Ott mérve: mind a két mag (`vice_x64`, `tic80`) elérhető minden célon, Androidon is; a playlist-könyvtár nem feltétlenül a RetroArch alapkönyvtárában van, tehát a `retroarch.cfg` kötelező olvasmány; a borító csak PNG lehet, amin az `impostor` GIF-je ma elhasal; leírást a `.lpl` nem tud. A motor egyetlen valódi új képessége az út-átírás (`stage_root` / `target_prefix`), ami az Androidot és a 2. pont asztali store-ját egyszerre szolgálja.
+
 ### 5. BBS store
 A `bbs/bbs-server`-be, a saját `rubbs`-unkra épülve. Bármelyik asset-fajtát tudja adni letöltésként, és ez az egyetlen a listán, amit **rajtunk kívül senki nem tudna lemásolni** — márkaérték, nem csak elérés.
 
@@ -117,12 +124,15 @@ Mind ugyanaz a forma: **olvasd a WarpEngine katalógust → írd a gazdaplatform
 
 Egy dolog viszont **nem** tartozik az adapterbe, hanem a közös részbe: az **architektúra-illesztés**. A gazdaplatform megmondja, milyen gépen fut (`uname -m`, Windows/macOS esetén a megfelelő megfelelője), és a motornak ehhez kell asset-fajtát választania. Ez a 0., 1. és 2. pontnak egyaránt kell, tehát egyszer, jó helyen érdemes megírni.
 
+**A közös rész 2026-08-17-én kiemelve:** `engines/warpstore`, egyetlen fájl, amit mindkét motor a telepítéskor letölt. Benne a katalógus és gyorsítótára, a kiadásválasztás, a `state.json`, a borító-letöltés, az atomikus írás és a törlés-őr — plusz az architektúra-illesztés, ami a második adapter miatt `resolve_for_host`-tá bővült: nem csak az `arch`, hanem az `os` is kulcs lehet, mert egy libretro mag fájlneve OS-enként más. Egy új store innentől valóban egy adapter plusz egy config.
+
 ## A javasolt sorrend
 
 1. ~~**`linux_arm64` a build-mátrixba**~~ — **kész** (2026-08-16). Az `ebitengine` és a `bevy` gyártja; a `godot`-hoz a játék repójában kell ARM export preset, a LÖVE-hoz nincs upstream ARM AppImage, a TIC-80 `export` parancsának meg nincs ARM célja. A `bevydemo` 1.0.0 már `linux_arm64`-et is ad.
 2. ~~**Architektúra-illesztés a motorba**~~ — **kész** (2026-08-17). A `kind` és az `ext` lehet architektúra-leképezés `*` tartalékkal; a felismert arch látszik a `list` és a `config` kimenetében. `aarch64`-en végigpróbálva: az ARM csomagot tölti le, és a benne lévő bináris valóban AArch64.
 3. ~~**`linux_*` → Batocera ports**~~ — **kész** (2026-08-17). `install: "port"`; `aarch64`-en végigpróbálva: telepítés, idempotens újraszinkron, eltávolítás a 106 MB-os payloaddal, és a névtér-védés is (idegen `.data` útra mutató bejegyzést elutasít). **Hátra van:** bekapcsolni a `ttg-batocera-store` configjában, és valódi gépen kipróbálni, hogy a natív játékok tényleg elindulnak-e.
-4. **ES-családú store-ok** (1.) — a motor itt már majdnem kész.
+4. ~~**RetroArch playlistek**~~ — **kész** (2026-08-17), a közös mag kiemelésével együtt. Lásd `RETROARCH_STORE.md`. **Hátra van:** a VICE `.prg`-autostart és az Android-út valódi gépen.
+5. **ES-családú store-ok** (1.) — a motor itt már majdnem kész, és a `warpstore` óta az adapter tényleg csak a gazdaplatform írása.
 
 ## Amit valódi gépen kell ellenőrizni
 
diff --git a/REPO_REFACT.md b/REPO_REFACT.md
index 78c99ba..d01f515 100644
--- a/REPO_REFACT.md
+++ b/REPO_REFACT.md
@@ -38,7 +38,8 @@ git.teletypegames.org/
 │   ├── warp_engine          Rails engine: katalógus + API   ← ma tools/
 │   ├── rubbs                Ruby gem: Telnet BBS keretrendszer   ← ma tools/
 │   ├── inkwell              Go: Point'n'Click DSL   ← ma games/
-│   └── gorpg                Go: Ebitengine RPG motor   ← ma games/
+│   ├── gorpg                Go: Ebitengine RPG motor   ← ma games/
+│   └── warpstore            Python: a store-motorok közös magja   ← új, 2026-08-17
 │
 ├── bbs/             BBS szerverek és showcase-ek. A keretrendszerük
 │   │                (rubbs) az engines/ alatt van.
@@ -69,6 +70,8 @@ git.teletypegames.org/
 │   │                A név marad, de kap definíciót és 19 helyett 5 repót.
 │   ├── warp-engine-batocera-store
 │   ├── ttg-batocera-store
+│   ├── warp-engine-retroarch-store   ← új, 2026-08-17
+│   ├── ttg-retroarch-store           ← új, 2026-08-17
 │   ├── ttg-marketplace      ← ma internal/
 │   ├── devarea
 │   └── tic80-draw-image     (vendorolt, GitHub)
@@ -90,6 +93,7 @@ git.teletypegames.org/
 - **Gem git-források rendezve** (2026-08-16): `bbs/bbs-server`, `bbs/sermo-bbs` és `bbs/impostor-bbs` — mindhárom a kanonikus hoszton az `engines/rubbs`-ra mutat, a rögzített revíziók változatlanul.
 - **Builder image-ek átköltöztetve** (2026-08-16): mind a 8 konténer-csomag a `build` org alá került, a `ci_platforms` és a dokumentáció (7 toolchain README + Dockerfile, 2 wiki-oldal) átírva. Az `internal` org ezzel kiüríthető — ez volt az egyetlen, ami visszatartotta.
 - **Wiki `engines/` névtér** (2026-08-16): a `warp-engine`, `rubbs` és `inkwell` oldal egy közös `/engines` szekcióba került, a régi URL-ek Grav-átirányítással élnek tovább.
+- **Három új repó a store-vonalon** (2026-08-17): `engines/warpstore` (a store-motorok kiemelt közös magja — az `engines/` definíciója szerint „könyvtár, amitől más repók függnek"), `tools/warp-engine-retroarch-store` és `tools/ttg-retroarch-store`. A `repos.list` és a `WIKI_CONNECTION.md` táblája követi; a `check-repos.sh` 49 repóval zölden fut. A `tools/` ezzel 5 helyett 7 repó.
 - **Workspace mappák igazítva** (2026-08-16): a mappa mostantól egy az egyben az org (`bbs/`, `build/`, `demos/`, `engines/`, `games/`, `infra/`, `services/`, `tools/`). Kivétel a `devarea`, ami a gyökérben marad, mert a `clone-repos.sh` a szülőjébe klónoz.
 
 ## Nyitott pontok
diff --git a/RETROARCH_STORE.md b/RETROARCH_STORE.md
new file mode 100644
index 0000000..9aa957f
--- /dev/null
+++ b/RETROARCH_STORE.md
@@ -0,0 +1,590 @@
+# RetroArch store — kidolgozott terv
+
+Készült 2026-08-17-én, a `MORE_STORES.md` 4. pontjának kifejtéseként. Minden
+alább szereplő formátum- és útvonal-állítás **egy valódi RetroArch-telepítésen
+mérve** (macOS, `~/Library/Application Support/RetroArch`), a mag-elérhetőség
+pedig a libretro buildbot indexéből.
+
+> **Megvalósítva ugyanaznap.** Három repó:
+> [`engines/warpstore`](https://git.teletypegames.org/engines/warpstore) (közös mag),
+> [`tools/warp-engine-retroarch-store`](https://git.teletypegames.org/tools/warp-engine-retroarch-store) (motor),
+> [`tools/ttg-retroarch-store`](https://git.teletypegames.org/tools/ttg-retroarch-store) (a mi store-unk).
+> A 11. pont javaslatával szemben a közös rész **azonnal** kiemelve — lásd az
+> „Amit a megvalósítás megváltoztatott" szakaszt a végén. Wiki:
+> [warpstore](https://wiki.teletypegames.org/engines/warpstore),
+> [motor](https://wiki.teletypegames.org/others/warp-engine-retroarch-store),
+> [store](https://wiki.teletypegames.org/others/ttg-retroarch-store).
+
+---
+
+## 1. Mit ad, és mit nem
+
+Új asset-fajtát **nem** fogyaszt: a RetroArch magok emulátorok, tehát pontosan
+azt eszik, amit a Batocera-store is — a `cartridge`-et. A nyereség nem a
+katalógus szélessége, hanem a **gazdagépek száma**: asztali Linux/Windows/macOS,
+Android, Steam Deck, konzolportok.
+
+A mai katalógusból (`released` + `archived`, 2026-08-17-i mérés) ez **6 cím,
+összesen 233 KB**:
+
+| Platform | Szoftver | Cím | Fájl | Méret | CRC32 |
+|---|---|---|---|---|---|
+| c64 | blessingofra | Blessing of Ra | `blessingofra-2.0.0.prg` | 10 561 | `4253CFC6` |
+| c64 | rabbitc64 | Rabbit Scooter | `rabbit-1.0.0.prg` | 8 072 | `31BF558B` |
+| c64 | c64demo | C64 Demo for Arok Party 2026 | `c64demo-1.0.prg` | 4 641 | `AF681FFC` |
+| tic80 | impostor | Definitely not an Impostor | `impostor-1.0.tic` | 163 497 | `8D9A45DA` |
+| tic80 | bombexpert | BombExpert | `bombexpert-0.2.tic` | 25 227 | `A67DDF4A` |
+| tic80 | mranderson | Mr Anderson's Adventure | `mranderson-0.1.tic` | 21 657 | `E98C7712` |
+
+Egy egész store negyed megabájt — ez az, ami miatt a szinkron gyakorlatilag
+ingyen van, és amiért az Android-célpont zip-ként is elküldhető.
+
+**A két mag mindenhol van.** A buildbot indexét végigkérdezve:
+
+| Cél | `vice_x64` | `tic80` | Fájlnév-alak |
+|---|---|---|---|
+| `apple/osx/arm64`, `apple/osx/x86_64` | ✔ | ✔ | `*_libretro.dylib` |
+| `linux/x86_64`, `linux/aarch64`, `linux/armhf`, `linux/armv7-neon-hf` | ✔ | ✔ | `*_libretro.so` |
+| `windows/x86_64` | ✔ | ✔ | `*_libretro.dll` |
+| `android/arm64-v8a`, `android/armeabi-v7a` | ✔ | ✔ | `*_libretro_android.so` |
+
+Tehát nincs olyan RetroArch-gazdagép, amin a katalógusunk ne futna — az Androidon
+viszont a mag fájlneve más (`_android.so`), és ez a tervben külön kezelendő.
+
+**Amire nem jó.** A `html` és a natív zipek maradnak kiszolgálatlanul: nincs
+böngésző-mag, és a LÖVE-hoz sincs valódi mag (a `lutro` nem LÖVE-kompatibilis).
+Batocerán és a többi ES-frontendes gépen szintén nem ez a helyes út — ott a
+RetroArch a háttérben fut, a könyvtár az ES-é, tehát a Batocera-store dolgozik.
+
+---
+
+## 2. A gazdaplatform, ahogy valóban kinéz
+
+Négy dolgot érdemes tudni, mert mind a négy megcáfol egy kézenfekvő feltevést.
+
+**(a) A `retroarch.cfg` az egyetlen igazságforrás, és a könyvtárak szét vannak
+szórva.** A mért gépen:
+
+```
+libretro_directory   = ~/Library/Application Support/RetroArch/cores
+thumbnails_directory = ~/Library/Application Support/RetroArch/thumbnails
+playlist_directory   = ~/Documents/RetroArch/playlists      ← más ág!
+system_directory     = ~/Documents/RetroArch/system
+```
+
+A playlist-könyvtár tehát nem a RetroArch alapkönyvtárában van. Aki a
+`<base>/playlists` mintát égeti bele, az ezen a gépen csendben a semmibe ír.
+**A motor kötelezően a `retroarch.cfg`-ből olvassa a négy útvonalat**, és csak
+akkor tippel, ha nincs cfg. A `~` feloldandó, ahogy a Windows-os portable
+telepítések `:` prefixe is (a RetroArch saját alapkönyvtárát jelenti).
+
+**(b) A `.lpl` sémája.** Egy valódi playlist a gépről (rövidítve) — ez a
+formátum, amit írunk, nem egy dokumentációból vett közelítés:
+
+```json
+{
+  "version": "1.5",
+  "default_core_path": "",
+  "default_core_name": "",
+  "label_display_mode": 0,
+  "right_thumbnail_mode": 0,
+  "left_thumbnail_mode": 0,
+  "thumbnail_match_mode": 0,
+  "sort_mode": 0,
+  "items": [
+    {
+      "path": "/…/Altered Beast (USA).md",
+      "entry_slot": -1,
+      "label": "Altered Beast (USA)",
+      "core_path": "/…/cores/genesis_plus_gx_libretro.dylib",
+      "core_name": "Sega - MS/GG/MD/CD (Genesis Plus GX)",
+      "crc32": "00000000|crc",
+      "db_name": "Sega - Mega Drive - Genesis.lpl"
+    }
+  ]
+}
+```
+
+Két tanulság: a `path` **absztolút út a célgépen** (ez a 7. pont egész
+problémája), a `crc32` pedig `"<8 hex>|crc"` alakú — a RetroArch maga gyakran
+csak nullákat ír bele, mi a valódit tudjuk beírni (`zlib.crc32`, ingyen).
+
+**(c) A borítókép útja a playlist nevéből jön.** A mért gépen:
+
+```
+thumbnails/Sega - Mega Drive - Genesis/Named_Boxarts/*.png
+                                       Named_Titles/*.png
+                                       Named_Snaps/*.png
+```
+
+Vagyis `thumbnails/<db_name a .lpl nélkül>/Named_*/<label>.png`, és **kizárólag
+PNG** — a RetroArch a fájlnevet `.png`-re képezi. Ez a 6. pont.
+
+**(d) A magok saját nevet és kiterjesztést hoznak.** A `.info` fájlokból:
+
+| Mag | `corename` | `supported_extensions` | `database` |
+|---|---|---|---|
+| `tic80_libretro` | `TIC-80` | `tic` | `TIC-80` |
+| `vice_x64_libretro` | `VICE x64` | `d64\|…\|prg\|p00\|crt\|…` | `Commodore - 64` |
+
+A `prg` valóban ott van a VICE listájában, tehát a nyers `.prg`-ket a mag
+közvetlenül indítja — nem kell `.d64`-be csomagolni.
+
+**Amit a formátum nem tud: leírást.** A `.lpl` bejegyzésnek nincs `desc` vagy
+`developer` mezője. A katalógus `desc`/`author` adata itt elveszik — a Batocera
+`gamelist.xml`-hez képest ez visszalépés, és nem konfigurálható. (Elvileg egy
+generált `.rdb` adná meg az Információ-panelt és az Explore nézetet, de az bináris
+libretrodb-formátum, külső eszközlánccal — ez a terven kívül, külön feladat.)
+
+---
+
+## 3. A megoldás felépítése
+
+A Batocera-store bevált kettéosztását követi, ugyanazokkal a nevekkel:
+
+```
+tools/warp-engine-retroarch-store      a motor: retroarch_store.py, install.sh
+        ▲
+        │ config.json
+tools/ttg-retroarch-store              a mi store-unk: config + wrapper installer
+```
+
+Amit telepít:
+
+```
+<content_root>/<subfolder>/<platform>/     blessingofra-2.0.0.prg, impostor-1.0.tic, …
+<playlists_dir>/Teletype Games - Commodore 64.lpl
+<playlists_dir>/Teletype Games - TIC-80.lpl
+<thumbnails_dir>/Teletype Games - Commodore 64/Named_Boxarts/Blessing of Ra.png
+                                              /Named_Titles/…  /Named_Snaps/…
+<store_home>/config.json, state.json, catalog.json, store.log
+```
+
+`content_root` alapértéke `<retroarch_dir>/content`, a `subfolder` a store
+azonosítója. A `retroarch.cfg`-hez **soha nem nyúlunk** — így a store nem tud
+elrontani semmit, amit a felhasználó beállított.
+
+**Playlist platformonként, nem egyben.** Nem esztétikai döntés: a
+`default_core_path`/`default_core_name` a playlist **fejlécében** van, tehát csak
+akkor tud minden bejegyzés magválasztás nélkül, egy kattintással indulni, ha egy
+playlisten egy mag van. Egy összevont „Teletype Games" listánál minden elemnek
+saját, gépspecifikus `core_path`-ot kellene adni — ami az exportnál (7. pont)
+azonnal elromlik.
+
+A név sablonból jön: `{store} - {label}` → `Teletype Games - Commodore 64`.
+Ez egyben a `db_name` és a borítókép-könyvtár neve is, tehát **a store nevével
+elszigetelt névtérben vagyunk**: nem írunk bele a hivatalos
+`Commodore - 64.lpl`-be, és a hivatalos thumbnail-pakkokkal sem ütközünk.
+
+Cserébe a saját playlist-nevünkhöz nincs ikon. A RetroArch a menü-ikont
+`assets/xmb/<téma>/png/<Playlist neve>.png` alapján keresi (a mért gépen ott
+vannak a `Commodore - 64.png` / `Commodore - 64-content.png` párok), tehát egy
+TTG-ikont le tudnánk tenni — de az `assets/` a RetroArch online updaterének
+tulajdona, ami a következő frissítéskor felülírja. **Opcionális, alapból ki**
+(`branding.icons: false`), és a README mondja ki, hogy nem tartós.
+
+CLI, a Batocera-store-ral azonos alakban:
+
+```sh
+retroarch-store list        # kompatibilis címek; * telepítve, ^ frissítés van
+retroarch-store sync        # letöltés + playlist + borító
+retroarch-store sync impostor
+retroarch-store -n sync     # dry run
+retroarch-store remove c64:blessingofra
+retroarch-store export <dir> --target-prefix <út>   # 7. pont
+retroarch-store config
+```
+
+---
+
+## 4. A playlist, amit írunk
+
+Konkrétan, valódi adatokkal (a fenti CRC-k mértek):
+
+```json
+{
+  "version": "1.5",
+  "default_core_path": "/Users/tasi/Library/Application Support/RetroArch/cores/vice_x64_libretro.dylib",
+  "default_core_name": "VICE x64",
+  "label_display_mode": 0,
+  "right_thumbnail_mode": 0,
+  "left_thumbnail_mode": 0,
+  "thumbnail_match_mode": 0,
+  "sort_mode": 0,
+  "items": [
+    {
+      "path": "/Users/tasi/Library/Application Support/RetroArch/content/teletypegames/c64/blessingofra-2.0.0.prg",
+      "entry_slot": -1,
+      "label": "Blessing of Ra",
+      "core_path": "DETECT",
+      "core_name": "DETECT",
+      "crc32": "4253CFC6|crc",
+      "db_name": "Teletype Games - Commodore 64.lpl"
+    }
+  ]
+}
+```
+
+- `label` = a katalógus `title`-je, mert ez a megjelenő név **és** a
+  borítókép-fájlnév egyszerre.
+- `core_path`/`core_name` a tételekben `DETECT`: a fejléc alapmagja dönt. Így egy
+  playlist-fájl akkor is használható marad, ha a magok máshol vannak — a
+  legrosszabb eset egy magválasztó kérdés, nem egy halott bejegyzés.
+- `db_name` a saját fájlnevünk, ezen keresztül találja meg a borítót.
+- A `*_thumbnail_mode` és `label_display_mode` marad `0` = a felhasználó globális
+  beállítása érvényes. Nem írjuk felül a preferenciáit (lásd 6. pont).
+
+---
+
+## 5. Mag-feloldás
+
+A configban a mag **fájlneve suffix nélkül** és a megjelenő neve áll:
+
+```json
+"core": { "file": "vice_x64_libretro", "name": "VICE x64" }
+```
+
+A motor a suffixet a célgépből teszi hozzá — `darwin` → `.dylib`, `linux` →
+`.so`, `windows` → `.dll`, `android` → `_android.so` —, majd megnézi, hogy a
+fájl létezik-e a `libretro_directory`-ban:
+
+- **létezik** → a playlist fejlécébe absztolút útként bekerül, a `name` mellé;
+- **nem létezik** → `default_core_path` üres marad, `default_core_name` a `name`,
+  a tételek `DETECT`-en. A playlist működik, a RetroArch az első indításnál kérdez.
+  A `list`/`sync` kiírja: `magot nem találtam: vice_x64_libretro (.dylib) — DETECT`,
+  és mellé az egy soros megoldást: *Online Updater ▸ Core Downloader ▸ VICE x64*.
+
+Ez a legfontosabb ergonómiai döntés: **a hiányzó mag nem hiba, hanem figyelmeztetés**.
+Egy store, ami magtelepítést követel meg, nem fog lefutni senkinek elsőre.
+
+---
+
+## 6. Borítókép
+
+Egy letöltés, három hely. A `thumbnail_kinds` alapból mindhárom `Named_*`
+könyvtár, mert a felhasználó globális beállítása dönti el, melyiket kéri
+(bal/jobb panel), és mi nem akarjuk átírni a beállítását. Három 100 KB-os fájl
+6 játéknál semmi; ahol a fájlrendszer engedi, hardlink, egyébként másolat.
+
+**A PNG-kényszer valódi problémát is jelent.** A katalógus képei ma:
+
+| Formátum | Címek |
+|---|---|
+| `image/png` | bombexpert, mranderson, rabbitc64, c64demo, blessingofra (+ nem-cartridge: rabbitroller, trickster-tiles) |
+| `image/gif` | **impostor** |
+
+A RetroArch PNG-t (és JPEG/TGA/BMP-t) tud, GIF-et nem, a fájlnevet pedig `.png`-re
+képezi. Az `impostor` borítója tehát ma nem jelenne meg. A `/api/image/:id`
+`send_file`-lal az eredetit adja vissza, átkódolás nélkül — a szerver nem segít.
+
+A motor sorrendje:
+1. magic bytes alapján PNG? → kiírjuk, kész.
+2. nem PNG, és van külső átkódoló? → `sips` (macOS gyári), `magick`/`convert`
+   (ImageMagick), `ffmpeg` — az első elérhető nyer.
+3. semmi? → figyelmeztetés, a bejegyzés borító nélkül is jó.
+
+Stdlib-only megkötéssel Pythonból nem kódolunk át (GIF-dekóder kellene) — és nem
+is kellene. **A helyes javítás felfelé van**: a `warp_engine` `imageUrl`-je
+adhatna PNG-változatot (vagy a feltöltés normalizálhatna). Egy sor a
+`MORE_STORES.md`-be: ez a store az első fogyasztó, aminek a kép **formátuma** is
+számít, nem csak a léte.
+
+---
+
+## 7. Út-átírás: a motor egyetlen valódi új képessége
+
+A `.lpl` absztolút utakat tartalmaz **a célgépen**. Amíg a store ott fut, ahol a
+RetroArch, ez nem kérdés. Csak épp a legérdekesebb célpont, az **Android, nem tud
+Pythont futtatni** — ott a store nem tud „ott" futni.
+
+A megoldás egy kettéválasztás, ami minden esetet lefed:
+
+| | hova írunk | mi kerül a playlistbe |
+|---|---|---|
+| `stage_root` | valódi fájlműveletek helye | — |
+| `target_prefix` | — | ezzel az előtaggal az útvonalak |
+
+Alapból a kettő ugyanaz (helyi telepítés). Ha eltér, egy „idegen gépre szánt"
+RetroArch-alakú fát írunk:
+
+```sh
+# 1. Android, adb-vel
+retroarch-store export /tmp/ra-ttg \
+  --target-prefix /storage/emulated/0/RetroArch \
+  --core-suffix _android.so
+adb push /tmp/ra-ttg/. /storage/emulated/0/RetroArch/
+
+# 2. SD-kártya: a Mac-en /Volumes/SDCARD, a kézikonzolon /mnt/sdcard
+retroarch-store export /Volumes/SDCARD/RetroArch --target-prefix /mnt/sdcard/RetroArch
+```
+
+Ugyanez a mechanizmus adja a Steam Deck flatpak-elrendezését
+(`~/.var/app/org.libretro.RetroArch/config/retroarch`) is, ott viszont
+`target_prefix` nélkül, mert helyben fut.
+
+Az Android útvonalait **nem égetjük be**: az `export --android` (2. fázis) az
+`adb shell cat /storage/emulated/0/RetroArch/retroarch.cfg`-ből olvassa ki a
+készülék saját könyvtárait, ugyanazzal a parserrel, amivel helyben. A fenti
+`/storage/emulated/0/RetroArch` csak a tartalék tipp — és ez az egyik pont, amit
+valódi készüléken meg kell mérni (12. pont).
+
+---
+
+## 8. Tulajdonlás, prune, állapot
+
+Ez a store a három közül a legtisztább: minden, amit ír, a nevét viseli.
+
+- **Tartalom**: csak `<content_root>/<subfolder>/` alatt törlünk, soha kívül.
+- **Playlist**: a fájl a miénk, de a merge mégis megőrző — újraírás előtt
+  kiválogatjuk azokat a tételeket, amiknek a `path`-ja **nem** a mi tartalmi
+  könyvtárunkban van, és visszaírjuk őket (ha a felhasználó kézzel vett fel
+  valamit a listánkba, nem tűnik el). Ha a végén nulla tétel marad, a fájlt
+  töröljük, nem hagyunk üres listát a menüben.
+- **Borító**: `<thumbnails_dir>/<playlist neve>/Named_*/<label>.png`, prune-nál
+  mind a három példány megy.
+- **Állapot**: `state.json`, `<platform>:<name>` kulccsal (itt nincs „system",
+  a platform az). Külön store, külön fájl — a Batocera v2 állapotával nincs
+  migrációs viszony.
+- A verzióváltás (`1.0` → `2.0.0`) a régi fájlt előbb törli, mint ahogy az újat
+  hozza, ahogy ma is.
+
+A `label` fájlnévvé alakításánál a RetroArch a `&*/:` `` ` `` `<>?\|`
+karaktereket `_`-ra cseréli; a sanitizert ugyanígy írjuk meg. A mai hat címben
+egyik sem szerepel (az `Mr Anderson's Adventure` aposztrófja nincs a listán),
+tehát ez ma elméleti — de egy jövőbeli `Foo: Bar` cím néma borítóhiba lenne.
+
+---
+
+## 9. Verseny a futó RetroArch-csal
+
+Ugyanaz a csapda, mint az EmulationStation gamelistjeivel: a RetroArch a
+playlisteket memóriában tartja, és **visszaírja őket**, ha módosultak (kedvencek,
+utolsó játék, rendezés). Ha futás közben írunk, a kilépése eltörölheti a
+munkánkat.
+
+Batocerán ezt a `sync-from-es` + `apply-gamelists --wait-pid` páros oldja meg, de
+ott van egy Ports-menü, ami elindít minket. Itt nincs: **a RetroArch nem tud
+szkriptet futtatni**, tehát a store gazdagépen belüli indítója nem létezik. Ezért
+a döntés egyszerűbb és szigorúbb:
+
+- `behavior.refuse_while_running: true` (alapérték) — ha fut RetroArch process,
+  a `sync` nem ír, hanem kiírja, hogy zárjuk be. `--force` felülbírálja.
+- A `sync` után az új playlistek **a RetroArch újraindítása után** látszanak; a
+  menü a listát indulásnál építi. Ezt a README első bekezdésében kell kimondani,
+  különben „nem működik" lesz a tapasztalat.
+- Indítás: shell, illetve ütemezve (`cron`, `systemd --user` timer, launchd,
+  Task Scheduler). Ez a store-nak nincs in-app belépője, és ezt nem érdemes
+  szépíteni.
+
+---
+
+## 10. A store configja
+
+`ttg-retroarch-store/config.json` teljes egészében:
+
+```json
+{
+  "store": {
+    "id": "ttg",
+    "name": "Teletype Games",
+    "base_url": "https://teletypegames.org",
+    "api": { "catalog": "/api/software", "download": "/api/download" }
+  },
+
+  "paths": {
+    "retroarch_dir": null,
+    "playlists_dir": null,
+    "thumbnails_dir": null,
+    "libretro_dir": null,
+    "content_root": null,
+    "subfolder": "teletypegames",
+    "target_prefix": null
+  },
+
+  "playlist": {
+    "name_template": "{store} - {label}",
+    "write_crc32": true,
+    "thumbnail_kinds": ["Named_Boxarts", "Named_Titles", "Named_Snaps"]
+  },
+
+  "catalog": {
+    "statuses": ["released", "archived"],
+    "owner_id": null,
+    "only": [],
+    "exclude": []
+  },
+
+  "platforms": {
+    "c64": {
+      "label": "Commodore 64",
+      "kind": "cartridge",
+      "ext": ".prg",
+      "core": { "file": "vice_x64_libretro", "name": "VICE x64" },
+      "enabled": true
+    },
+    "tic80": {
+      "label": "TIC-80",
+      "kind": "cartridge",
+      "ext": ".tic",
+      "core": { "file": "tic80_libretro", "name": "TIC-80" },
+      "enabled": true
+    }
+  },
+
+  "behavior": {
+    "prune": true,
+    "timeout": 30,
+    "insecure": false,
+    "refuse_while_running": true,
+    "convert_images": true
+  },
+
+  "branding": { "icons": false }
+}
+```
+
+A `null` útvonalak mindenütt azt jelentik: *derítsd ki* — env (`RETROARCH_DIR`),
+majd `retroarch.cfg`, majd OS-enkénti tipplista. A `config` alparancs kiírja,
+mire jutott, ahogy a Batocera-store a `detected_arch`-ot:
+
+```
+detected: os=darwin arch=aarch64 core_suffix=.dylib
+retroarch_dir  ~/Library/Application Support/RetroArch      (candidate)
+playlists_dir  ~/Documents/RetroArch/playlists              (retroarch.cfg)
+libretro_dir   ~/Library/Application Support/RetroArch/cores (retroarch.cfg)
+cores          vice_x64_libretro ✗   tic80_libretro ✗       → DETECT
+```
+
+---
+
+## 11. A közös rész: mit mikor emeljünk ki
+
+A `MORE_STORES.md` helyesen mondja, hogy a katalógus-lekérés, kiadásválasztás,
+`state.json`, borító és prune-védelem közös. A most kézenfekvő lépés mégis **nem**
+az azonnali kiemelés.
+
+**1. fázis — a RetroArch-motor önálló, egyfájlos, és igen, duplikál.**
+A `retroarch_store.py` átveszi a HTTP/katalógus/állapot réteget (~250 sor). Ok:
+egyetlen minta alapján kiemelt absztrakció rossz absztrakció, és a Batocera-store
+**élesben fut** — nem az a pillanat, hogy alatta cseréljünk réteget, amikor még
+azt sem tudjuk, mit tanul a második adapter. A telepítés is egyszerűbb marad:
+egy `curl` egy fájlra.
+
+**2. fázis — kiemelés, amikor két adapter már megmondja, mi közös.**
+Amit ma is látok jelöltnek: `http_get`/`http_download`, `fetch_catalog` +
+gyorsítótár, `pick_release`, a config-merge, a `state.json` séma és az
+atomikus írás. Ezek egy `warpstore_core.py`-ba mennek, mindkét installer két
+fájlt tölt le. Amit a RetroArch már most tanított, és a közös részbe tartozik:
+
+- a `resolve_for_arch` **általánosítása**: a Batocerán csak az architektúra volt
+  a változó, itt az operációs rendszer is (mag-suffix). Egy `resolve_for_host`,
+  ami `x86_64` / `aarch64` / `linux` / `darwin` / `windows` / `android` / `*`
+  kulcsokat is fogad, mindkettőt kiszolgálja;
+- a **`stage_root` / `target_prefix` kettősség** (7. pont). Ez nem RetroArch-specifikus:
+  az asztali store (`MORE_STORES.md` 2.) és a kézikonzolos ES-disztrók
+  ugyanígy „innen írok, ott fog futni" helyzetben vannak.
+
+---
+
+## 12. Munka és ellenőrzés
+
+Becslés, a Batocera-motor mérete alapján (`store.py` 1073 sor):
+
+| Rész | Új sor (kb.) |
+|---|---|
+| átvett réteg (HTTP, katalógus, állapot, config) | 250 |
+| `retroarch.cfg` parser + útvonal-felderítés | 90 |
+| playlist írás/merge (`.lpl`) | 120 |
+| mag-feloldás | 60 |
+| borító 3 könyvtárba + átkódolás | 80 |
+| export / út-átírás | 70 |
+| CLI, logolás | 90 |
+| **összesen** | **~760** |
+
+Plusz `install.sh` (a Batocera-inak asztali változata: `~/.local/share`-be, nem
+`/userdata`-ba) és két README.
+
+**Amit valódi gépen meg kell mérni** — ez a lista a terv gyenge pontjai, nem
+formalitás:
+
+1. **A két mag valóban elindítja-e a fájljainkat.** Ez a store létjogosultsága.
+   Nem drága ellenőrizni:
+   ```sh
+   # magok a scratchpadbe, nem a felhasználó RetroArch-jába
+   curl -fsSLO https://buildbot.libretro.com/nightly/apple/osx/arm64/latest/vice_x64_libretro.dylib.zip
+   curl -fsSLO https://buildbot.libretro.com/nightly/apple/osx/arm64/latest/tic80_libretro.dylib.zip
+   unzip -o '*.zip'
+   retroarch -L ./vice_x64_libretro.dylib ./blessingofra-2.0.0.prg
+   retroarch -L ./tic80_libretro.dylib ./impostor-1.0.tic
+   ```
+   Külön kérdés a `.prg` autostartja: a VICE-mag betölti, de futtatja-e magától,
+   vagy `RUN`-ra vár. Ha vár, kell egy magopció (`vice_autostart`) vagy `.d64`-be
+   csomagolás — ez a terv legvalószínűbb sérülési pontja.
+2. **A generált playlist megjelenik-e**, a saját nevével, és a borító előjön-e a
+   `Named_*` könyvtárakból, a felhasználó globális thumbnail-beállításával.
+3. **Az Android útvonalai** (`playlist_directory`, `libretro_directory` a
+   készülék cfg-jében) és hogy az `adb push`-olt tartalom olvasható-e a
+   RetroArch-nak scoped storage mellett.
+4. **A visszaírás-verseny** valódi mérete: mennyit ír vissza a RetroArch a
+   playlistünkből kilépéskor, elég-e a `refuse_while_running`.
+5. **A `label` → borító-fájlnév sanitizálás** pontos karakterkészlete (a fenti
+   lista következtetés, nem mérés) — egy `Foo: Bar` címmel kipróbálva kiderül.
+
+## Javasolt sorrend
+
+1. Az 1. ellenőrzési pont (magok + a két fájltípus indítása) — **mielőtt** kód
+   íródna. Egy órányi munka, és megválaszolja, hogy a store egyáltalán működhet-e.
+2. `warp-engine-retroarch-store`: cfg-parser + `list` + `sync` a helyi telepítéssel,
+   macOS-en és Linuxon.
+3. `ttg-retroarch-store` config, a fenti tartalommal.
+4. Export/út-átírás + Android próba valódi készüléken.
+5. Kiemelés `warpstore_core.py`-ba (11. pont, 2. fázis), és az `imageUrl`
+   PNG-normalizálása a `warp_engine`-ben (6. pont).
+
+---
+
+## Amit a megvalósítás megváltoztatott
+
+*(2026-08-17, a fenti terv leírása után.)*
+
+**A közös rész azonnal kiemelve.** A 11. pont fázisolását felülírtuk: a
+`warpstore.py` a saját repójában (`engines/warpstore`) született meg, és a
+Batocera-motor **ugyanabban a körben** átült rá — 1073 sorból 426 eltűnt, 115
+jött vissza. A `tools/` alá nem került, mert az org-definíció szerint az
+`engines/` a „saját motor és könyvtár, amitől más repók függnek", és ez pontosan
+az. Mindkét telepítő két fájlt tölt le, a `warpstore.py`-t a saját repójából;
+egyik sem pin-el verziót, tehát egy magbeli javítás a következő telepítéssel
+mindkét store-hoz megérkezik.
+
+Az élesben futó Batocera-store miatt az átültetés visszamérve: a cartridge-út, a
+Ports-út, a borító, a gamelist-merge, az idempotens újraszinkron, a prune és az
+eltávolítás ugyanazt adja, mint előtte. A régi `state.json` (rekordokban `system`,
+`scope` nélkül) **ugyanúgy kulcsolódik**, tehát a frissítés után az első szinkron
+nem tölt le és nem prune-ol semmit — ezt szándékosan a `record_scope()`
+tartaléka adja, nem migráció.
+
+**Két általánosítás, amit a második adapter kényszerített ki:**
+
+- `resolve_for_arch` → `resolve_for_host`. A Batocerán csak az architektúra volt
+  a változó; a RetroArch-nál az OS is (`.dll` / `.dylib` / `_android.so`). A
+  kulcssorrend `os-arch`, `arch`, `os`, `*`.
+- Az állapot `scope` szerint kulcsolódik, nem ES-`system` szerint. A RetroArch-nál
+  a scope a platform, nem a playlist neve — így a store átnevezése nem kulcsolja
+  újra a telepítést.
+
+**Amit a terven felül kapott a motor:** `paths` alparancs. A négy útvonal
+felderítése annyira nem magától értetődő (lásd az (a) pontot), hogy önmagában
+megérdemel egy kimenetet, ami azt is megmutatja, **melyik válasz honnan jött** —
+config, `retroarch.cfg`, vagy tartalék. Ezt írja ki a telepítő is.
+
+**Ami az 5. pontból pontosításra került:** a hiányzó mag nem csak „figyelmeztetés",
+hanem konkrét lépés is a kimenetben (*Online Updater ▸ Core Downloader ▸ VICE x64*).
+
+**Amit végigmértünk:** letöltés, playlist, borító (a GIF `sips`-szel PNG-vé
+konvertálva), idegen playlist-bejegyzés megőrzése, mag-felismerés, prune,
+eltávolítás, üres playlist törlése, Android-export `_android.so`-val és POSIX
+célútvonalakkal, végül teljes telepítés a forge-ról `curl | bash`-sal. A CRC32-k
+egyeznek a doksi 1. pontjában független módszerrel mért értékekkel.
+
+**Ami továbbra is nyitott, változatlanul:** a VICE `.prg`-autostart és az Android
+`adb push` scoped storage kérdése. Ezt kód nem tudja megválaszolni.
diff --git a/WIKI_CONNECTION.md b/WIKI_CONNECTION.md
index 2163b10..fff2409 100644
--- a/WIKI_CONNECTION.md
+++ b/WIKI_CONNECTION.md
@@ -25,6 +25,7 @@ This file lives in the `devarea` repo (`tools/devarea`). The repo's `scripts/` f
 | `engines/inkwell` | `engines` | inkwell | `infra/wiki-pages/pages/engines/inkwell/default.md` | https://wiki.teletypegames.org/engines/inkwell |
 | `engines/rubbs` | `engines` | rubbs | `infra/wiki-pages/pages/engines/rubbs/default.md` | https://wiki.teletypegames.org/engines/rubbs |
 | `engines/warp_engine` | `engines` | WarpEngine | `infra/wiki-pages/pages/engines/warp-engine/default.md` | https://wiki.teletypegames.org/engines/warp-engine |
+| `engines/warpstore` | `engines` | warpstore | `infra/wiki-pages/pages/engines/warpstore/default.md` | https://wiki.teletypegames.org/engines/warpstore |
 | `games/blessingofra` | `games` | Blessing of Ra | `infra/wiki-pages/pages/projects/blessingofra/default.md` | https://wiki.teletypegames.org/projects/blessingofra |
 | `games/c64-demo` | `games` | Teletype Games C64 Demo | `infra/wiki-pages/pages/projects/c64-demo/default.md` | https://wiki.teletypegames.org/projects/c64-demo |
 | `games/impostor` | `games` | Definitely Not an Impostor | `infra/wiki-pages/pages/projects/impostor/default.md` | https://wiki.teletypegames.org/projects/impostor |
@@ -38,7 +39,9 @@ This file lives in the `devarea` repo (`tools/devarea`). The repo's `scripts/` f
 | `services/teletypegames` | `services` | Public site | `infra/wiki-pages/pages/infrastructure/public-site/default.md` | https://wiki.teletypegames.org/infrastructure/public-site |
 | `services/updater` | `services` | Discord Updater Bot | `infra/wiki-pages/pages/others/updater/default.md` | https://wiki.teletypegames.org/others/updater |
 | `tools/ttg-batocera-store` | `tools` | TTG Batocera Store | `infra/wiki-pages/pages/others/ttg-batocera-store/default.md` | https://wiki.teletypegames.org/others/ttg-batocera-store |
+| `tools/ttg-retroarch-store` | `tools` | TTG RetroArch Store | `infra/wiki-pages/pages/others/ttg-retroarch-store/default.md` | https://wiki.teletypegames.org/others/ttg-retroarch-store |
 | `tools/warp-engine-batocera-store` | `tools` | WarpEngine Batocera Store | `infra/wiki-pages/pages/others/warp-engine-batocera-store/default.md` | https://wiki.teletypegames.org/others/warp-engine-batocera-store |
+| `tools/warp-engine-retroarch-store` | `tools` | WarpEngine RetroArch Store | `infra/wiki-pages/pages/others/warp-engine-retroarch-store/default.md` | https://wiki.teletypegames.org/others/warp-engine-retroarch-store |
 
 ## Notes
 
diff --git a/scripts/repos.list b/scripts/repos.list
index 2a6e505..cdaf9ab 100644
--- a/scripts/repos.list
+++ b/scripts/repos.list
@@ -33,6 +33,7 @@ engines/gorpg|ssh://git@git.teletypegames.org:2222/engines/gorpg
 engines/inkwell|ssh://git@git.teletypegames.org:2222/engines/inkwell
 engines/rubbs|ssh://git@git.teletypegames.org:2222/engines/rubbs
 engines/warp_engine|ssh://git@git.teletypegames.org:2222/engines/warp_engine
+engines/warpstore|ssh://git@git.teletypegames.org:2222/engines/warpstore
 games/blessingofra|ssh://git@git.teletypegames.org:2222/games/blessingofra
 games/bombexpert|ssh://git@git.teletypegames.org:2222/games/bombexpert
 games/c64-demo-cpp|ssh://git@git.teletypegames.org:2222/games/c64-demo-cpp
@@ -57,4 +58,6 @@ services/updater|ssh://git@git.teletypegames.org:2222/services/updater
 tools/tic80-draw-image|https://github.com/cxong/tic80-draw-image.git
 tools/ttg-batocera-store|ssh://git@git.teletypegames.org:2222/tools/ttg-batocera-store
 tools/ttg-marketplace|ssh://git@git.teletypegames.org:2222/tools/ttg-marketplace
+tools/ttg-retroarch-store|ssh://git@git.teletypegames.org:2222/tools/ttg-retroarch-store
 tools/warp-engine-batocera-store|ssh://git@git.teletypegames.org:2222/tools/warp-engine-batocera-store
+tools/warp-engine-retroarch-store|ssh://git@git.teletypegames.org:2222/tools/warp-engine-retroarch-store