diff --git a/family/how-to/switch-emulation-rom-infra.md b/family/how-to/switch-emulation-rom-infra.md
index 955998fe..7857a680 100644
--- a/family/how-to/switch-emulation-rom-infra.md
+++ b/family/how-to/switch-emulation-rom-infra.md
@@ -285,6 +285,15 @@ ssh kraken "mkdir -p /srv/.../docker/jackett && cd /srv/.../docker/jackett"
 
 - EmuDeck Wiki Ryujinx: https://emudeck.github.io/emulators/steamos/ryujinx/
 - Ryujinx (GreemDev fork): https://github.com/GreemDev/Ryujinx
+- Ryujinx .app (macOS native): https://ryujinx.io/download/ (не путать с ryujinx.co — тот отдаёт Windows exe)
+- prod.keys: https://github.com/KLWorld/Ryujinx/blob/main/prod.keys
+- Firmware: https://github.com/THZoria/NX_Firmware/releases
 - Eden: https://eden-emu.dev
 - Jackett: https://github.com/Jackett/Jackett
 - qBittorrent API: https://github.com/qbittorrent/qBittorrent/wiki/Web-API-Documentation
+
+---
+
+## MacOS / Mac (личный компьютер)
+
+➡️ См. [[personal/tech/ryujinx-mac-setup]] — инструкция по установке на Mac (июль 2026).
diff --git a/personal/tech/ryujinx-mac-setup.md b/personal/tech/ryujinx-mac-setup.md
new file mode 100644
index 00000000..684a2b63
--- /dev/null
+++ b/personal/tech/ryujinx-mac-setup.md
@@ -0,0 +1,79 @@
+# Ryujinx на Mac (M4, macOS 26)
+
+> Актуально: июль 2026. Настроено на основном MacBook (M4).
+
+---
+
+## Установка (06.07.2026)
+
+### 1. Скачивание Ryujinx.app
+
+**Источник:** [ryujinx.io/download/](https://ryujinx.io/download/) → Stable v1.3.3
+**Прямая ссылка:** `https://git.ryujinx.app/projects/Ryubing/releases/download/1.3.3/ryujinx-1.3.3-macos_universal.app.tar.gz`
+**Размер:** ~69 MB
+
+**Путь установки:** `/Applications/Ryujinx.app`
+
+**⚠️ Осторожно:** `ryujinx.co` (не `ryujinx.io`) отдаёт Windows .exe файлы, выданные за macOS архив. Использовать только `ryujinx.io` или `git.ryujinx.app` для macOS.
+
+### 2. prod.keys
+
+**Источник:** `github.com/KLWorld/Ryujinx` → `prod.keys`
+**Прямая ссылка:** `https://raw.githubusercontent.com/KLWorld/Ryujinx/main/prod.keys`
+**Размер:** 12.6 KB
+**Путь на Mac:** `~/.config/Ryujinx/system/prod.keys`
+
+Тот же источник, что использовался на HTPC (июнь 2026).
+
+### 3. Firmware
+
+**Источник:** `github.com/THZoria/NX_Firmware/releases`
+**Версия:** 22.5.0
+**Прямая ссылка:** `https://github.com/THZoria/NX_Firmware/releases/download/22.5.0/Firmware.22.5.0.zip`
+**Размер:** 341 MB
+**Скачан в:** `~/Downloads/Firmware.22.5.0.zip`
+
+Установка firmware — через Ryujinx GUI: **Tools → Install Firmware → Install from ZIP** → выбрать ZIP.
+
+Альтернатива: THZoria старые версии (19.0.1) — листать Releases дальше.
+
+---
+
+## Пути на Mac
+
+| Компонент | Путь |
+|-----------|------|
+| Ryujinx.app | `/Applications/Ryujinx.app` |
+| prod.keys | `~/.config/Ryujinx/system/prod.keys` |
+| Firmware .zip | `~/Downloads/Firmware.22.5.0.zip` (временный, нужна установка через GUI) |
+| Firmware (установленный) | куда Ryujinx сам распакует при установке через GUI |
+
+Ryujinx для macOS (не Flatpak) использует `~/.config/Ryujinx/` как домашнюю директорию.
+
+---
+
+## Совместимость
+
+- **macOS:** нативная сборка Universal (Intel + Apple Silicon)
+- **Apple Silicon M4:** JIT-компиляция работает — производительность высокая
+- **GPU:** Metal-совместимый
+- **Требования:** macOS 11+, 8GB RAM min / 16GB рекомендовано
+
+---
+
+## Чем отличается от HTPC
+
+| | Mac (M4) | HTPC (x86, Bazzite) |
+|---|---|---|
+| Тип сборки | `.app` native | Flatpak `io.github.ryubing.Ryujinx` |
+| Путь данных | `~/.config/Ryujinx/` | `~/.var/app/io.github.ryubing.Ryujinx/data/Ryujinx/` |
+| GPU backend | Metal | Vulkan |
+| ROMs | на Mac SSD | `/run/media/system/Data/Switch Roms/` |
+
+---
+
+## TODO
+
+- [ ] Установить firmware через GUI (Tools → Install Firmware → From ZIP)
+- [ ] Найти и скачать ROMы (NSP/XCI) для игр
+- [ ] Настроить геймпад (если используется)