Refresh bilingual README screenshots and prepare public documentation

This commit is contained in:
Erick Sanchez committed 2026-10-26 11:59:26 -06:00
1 parent ecfc0698e9
commit 25db760cd3
6 files changed
+21 -12

No files matched your search

+8 -6
View File
@@ -25,19 +25,19 @@ La app inicia en **English**. Cambia a **Español** con el selector de la esquin
## Abre la app y elige tu juego
1. Abre **nxnative.app**.
2. Elige la **Carpeta del juego**, selecciona tu **Carpeta de llaves** una vez y pulsa **Preparar juego**.
2. Elige la **Carpeta de tu juego**, selecciona tu **Carpeta de llaves** una vez y pulsa **Preparar juego**.
La app prepara las herramientas, compila y deja lista la **IPA ligera**. Verás el avance en la ventana. Al terminar aparecen los dos pasos para instalar. **Enviar a Sideloadly** abre allí la IPA preparada; si Sideloadly no está instalado, el botón ofrece descargarlo.
**En nuestro Mac:** la app está disponible como `nxnative.app` en Descargas. Recuerda tu última carpeta y permite volver a mostrar la IPA ya preparada.
**Una vez creada:** abre `nxnative.app`. Recuerda tu última carpeta y permite volver a mostrar la IPA ya preparada.
**En otro Mac:** después de descargar este repositorio privado, abre [`scripts/Abrir-interfaz.command`](scripts/Abrir-interfaz.command) con doble clic. Crea y abre la app local. La primera vez necesitas Xcode completo y Homebrew instalados; si hacen falta tus llaves, te pedirá elegir la carpeta donde guardas tu propio `prod.keys`. Mantén cada juego fuera del repositorio, en una carpeta con su base y actualizaciones.
**En otro Mac:** después de descargar este repositorio, abre [`scripts/Abrir-interfaz.command`](scripts/Abrir-interfaz.command) con doble clic. Crea y abre la app local. La primera vez necesitas Xcode completo y Homebrew instalados; si hacen falta tus llaves, te pedirá elegir la carpeta donde guardas tu propio `prod.keys`. Mantén cada juego fuera del repositorio, en una carpeta con su base y actualizaciones.
## Cómo se compila la app de Mac
El acceso de apertura usa el compilador Swift de tu Xcode. La firma de la app es **ad hoc**, local y sin cuenta, certificado ni equipo Apple (`TeamIdentifier` no asignado). No usa cuentas de empresa. Sólo al instalar la **IPA de iPhone con Sideloadly** introduces tu cuenta personal, dentro de Sideloadly.
Los símbolos de la interfaz son genéricos del sistema; no se usan imágenes ni logotipos de los juegos en la app. La galería de documentación de abajo procede de upstream y está separada de la interfaz.
El icono del teléfono con controles es original. Los símbolos de los perfiles son genéricos del sistema; no se usan imágenes ni logotipos de los juegos en la app. La galería de documentación de abajo procede de upstream y está separada de la interfaz.
## Instalar: Sideloadly + Finder
@@ -47,9 +47,11 @@ Los símbolos de la interfaz son genéricos del sistema; no se usan imágenes ni
Para actualizar, usa la misma cuenta y el mismo bundle ID efectivo de Sideloadly. **Instala encima; no desinstales la app**, para conservar tus partidas. Si los datos del juego no cambiaron, puedes reutilizar el `romfs` existente. La app instala las herramientas de compilación que falten después de tener Xcode y Homebrew, pero **no firma ni instala el juego en el iPhone**. Esos pasos los hace Sideloadly. La app los explica cuando la IPA está lista.
## Juegos incluidos
## Perfiles de juegos con soporte
El carrusel muestra los perfiles de esta copia; no proporciona ni descarga juegos. Debes añadir tus propios archivos del juego. Pulsa **Ver todos** arriba a la derecha para consultar la lista completa de soporte. Busca por nombre, versión o Title ID; cada resultado enlaza a su ficha. El catálogo vuelve a leer los perfiles locales cada vez que lo abres.
El carrusel muestra los perfiles de esta copia; no proporciona ni descarga juegos. Debes añadir tus propios archivos del juego. Pulsa **Ver todos** arriba a la derecha para consultar la lista completa de soporte. Busca por nombre, versión o Title ID; cada resultado enlaza a su ficha. El catálogo vuelve a leer los perfiles locales cada vez que lo abres. El carrusel rota automáticamente y se pausa al colocar el cursor encima.
![Buscador de perfiles de juegos](docs/images/nxnative-catalog-es.png)
**Las pruebas propias cubren compilación y empaquetado en Mac, no una verificación automática de juego en iPhone.** Los perfiles y reportes de juego proceden de upstream; revisa [la ficha de tu juego](dm/games/README.md#games) antes de prepararlo. Un perfil no garantiza que cualquier versión funcione en cualquier iPhone.
+4 -4
View File
@@ -25,19 +25,19 @@ The app starts in **English**. Choose **Español** using the selector at the top
## Open the app and choose your game
1. Open **nxnative.app**.
2. Choose the **Game folder**, select your **Keys folder** once, then click **Prepare game**.
2. Choose **Your game folder**, select your **Keys folder** once, then click **Prepare game**.
The app prepares the tools, builds the game app and creates a **lightweight IPA**. Progress stays in the window. When finished, the app shows the two installation steps. **Send to Sideloadly** opens the prepared IPA in Sideloadly; if it is not installed, the button offers its download.
**First-time setup:** download or clone this repository, then double-click the local [`scripts/Abrir-interfaz.command`](scripts/Abrir-interfaz.command) file in Finder. It creates and opens the Mac app. Full Xcode and Homebrew must already be installed. Select the folder containing your own `prod.keys` when asked. Keep one game per folder, with the base game and its updates, outside this source checkout.
**Already set up:** open the existing `nxnative.app`. It remembers your last game folder and can reveal a previously prepared IPA. On the owner's Mac, the app shortcut is in Downloads.
**Already set up:** open the existing `nxnative.app`. It remembers your last game folder and can reveal a previously prepared IPA.
## How the Mac app is built
The launcher uses Xcode's Swift compiler. The desktop app is explicitly **ad-hoc signed**, locally, with no Apple account, certificate or team (`TeamIdentifier` is unset). No company account is used. You enter your personal Apple account separately in Sideloadly when signing the **iPhone IPA**.
The interface uses generic system symbols, not game artwork or logos. The documentation gallery below comes from upstream and is separate from the app.
The app has an original phone-and-controller icon and uses generic system symbols for game profiles, without game artwork or logos. The documentation gallery below comes from upstream and is separate from the app.
## Install with Sideloadly and Finder
@@ -49,7 +49,7 @@ For updates, keep the same Apple account and effective bundle ID used in Sideloa
## Included game profiles
The home carousel shows the game profiles in your checkout; it does not provide or download games. You must add your own game files. Click **View all** at the top right to browse the complete support list. Search by name, version or Title ID; each result links to its game notes. The catalog reads the local profiles each time you open it.
The home carousel shows the game profiles in your checkout; it does not provide or download games. You must add your own game files. Click **View all** at the top right to browse the complete support list. Search by name, version or Title ID; each result links to its game notes. The catalog reads the local profiles each time you open it. The carousel rotates automatically and pauses while you hover over it.
**Our own checks cover macOS compilation and packaging, not automatic iPhone gameplay verification.** Profiles and gameplay reports come from upstream and may concern Mac or iPhone; read [your game's notes](dm/games/README.md#games). A profile does not guarantee that every game version works on every device.
Binary file not shown.

Before

Width:  |  Height:  |  Size: 140 KiB

After

Width:  |  Height:  |  Size: 145 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 143 KiB

After

Width:  |  Height:  |  Size: 413 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 416 KiB

After

Width:  |  Height:  |  Size: 392 KiB

+9 -2
View File
@@ -6,7 +6,7 @@ MIT notice and third-party license files. Our additions are the native desktop
preparation UI, persistent iOS touch-control editor and lightweight build workflow.
No endorsement by Nintendo, Apple, game publishers or upstream authors is implied.
The desktop UI uses generic system symbols rather than game screenshots or logos.
The desktop UI uses original phone/controller artwork and generic system symbols rather than game screenshots or logos.
The README/gallery and upstream documentation still contain game screenshots;
removing artwork from the app does not remove that documentation or historical
Git objects. The code's license is not a blanket grant of rights over third-party
@@ -35,9 +35,16 @@ exists. It does not audit unreachable server objects or independently establish
third-party copyright permissions.
Validation: native desktop compilation, explicit ad-hoc signature inspection,
10 script/worker tests and 4 documentation/link checks passed. No Apple account
12 script/worker tests and 4 documentation/link checks passed. No Apple account
was used, no game was signed/installed, and no new device gameplay is claimed.
See GitHub's [visibility documentation](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility):
public visibility exposes repository content and Actions history, and others can fork
it. A later return to private does not retrieve copies already made by others.
Publication refresh on 2026-10-26 rechecked all 5,945 historical blobs reachable
from main before the README screenshot refresh. No matches were found for the
checked key/token patterns, sensitive package filenames, company references or
known private local identifiers. The owner explicitly requested public visibility.
Current English/Spanish app screenshots and the profile search screenshot replace
the earlier interface captures.