# Installazione Come installare, aggiornare e rimuovere PlayGuard, e cosa scrive sulla scheda SD. Una volta installato: [Per iniziare](https://guard.boreale.dev/it/docs/getting-started.md). ## Dove trovarlo A scelta: - **Homebrew App Store** / **App Store di sphaira** (stesso catalogo) — Cerca *PlayGuard* e installalo. Le nuove versioni vengono riprese automaticamente, dopo una verifica: spesso qualche giorno dopo GitHub. PlayGuard sa di essere stato installato da lì e consiglia di aggiornarlo tramite lo store. - **Manualmente** — Scarica `playguard.zip` dall'[ultima versione](https://github.com/JigSawFr/PlayGuard/releases/latest) ed estrailo nella **radice** della scheda SD. L'app finisce in `sd:/switch/playguard/`, i suoi file in `sd:/config/playguard/`. - **sphaira › GitHub** — Lo zip della versione contiene già la voce (`/config/sphaira/github/playguard.json`): dopo una prima installazione, aggiorna da *GitHub* in sphaira. Il **sysmodule di ripristino** facoltativo si installa da PlayGuard (*Console › Moduli facoltativi*, o *Sicurezza › Bloccato?*), o a mano dal suo download (`playguard-rescue.zip`): estrai anche lui nella radice della scheda SD, poi riavvia la console. Finisce in `atmosphere/contents/4200000000505247/` e agisce solo quando un file `RESCUE` glielo chiede — vedi [Console bloccata?](https://guard.boreale.dev/it/docs/troubleshooting.md#console-bloccata). Poi apri PlayGuard **sopra un gioco**, con l'utente di un genitore ([perché](https://guard.boreale.dev/it/docs/compatibility.md#launcher)). ## Aggiornare - **In PlayGuard:** *Preferenze › Aggiorna con* sceglie come — in PlayGuard stesso (scarica la versione, la verifica, si sostituisce e si riavvia), sphaira, l'Homebrew App Store o manualmente. Con *Cerca aggiornamenti ogni giorno* attivo, PlayGuard si apre sulla nuova versione quando ce n'è una. - **Il sysmodule di ripristino** segue la versione di PlayGuard: dopo ogni aggiornamento, estrai di nuovo il `playguard-rescue.zip` di quella versione (oppure *Aggiorna* sulla voce *Il sysmodule di ripristino non è aggiornato* della campanella, o in *Console › Moduli facoltativi*), poi riavvia la console. - **L'agente del collegamento remoto**, se è installato: all'avvio successivo ne viene proposto l'aggiornamento quando PlayGuard ne contiene uno più recente ([Home Assistant](https://github.com/JigSawFr/PlayGuard/blob/main/docs/home-assistant.md#keep-the-link-up-when-playguard-is-closed), in inglese). - Impostazioni, cronologia, profili e backup restano: sono in `sd:/config/playguard/`, non accanto all'app. ## Rimuoverlo Elimina `sd:/switch/playguard/` (l'app) e, per rimuovere anche i suoi file, `sd:/config/playguard/`; con i sysmodule facoltativi, anche `sd:/atmosphere/contents/4200000000505247/` (ripristino) e `sd:/atmosphere/contents/4200000000504741/` (l'agente), oppure rimuovili prima in *Console › Moduli facoltativi*. I limiti, il PIN e le limitazioni sono quelli della console: **restano sulla console**. Per rimuovere anche loro, usa prima *Sicurezza › Elimina il filtro famiglia*. ## File sulla scheda SD Tutti in `sd:/config/playguard/` (l'app stessa resta in `sd:/switch/playguard/`: rimuoverla o reinstallarla li conserva). Le versioni che li tenevano accanto all'app li hanno spostati lì al primo avvio. - **`config.json`** — Preferenze (lingua, tema, server NTP, *Proteggi PlayGuard con il PIN*…); ogni chiave in [config.md](https://guard.boreale.dev/it/docs/config.md) (in inglese). Se non si può leggere, viene conservato come `config.json.bad` (il precedente come `.bad.1`) e le impostazioni ripartono dai valori predefiniti; PlayGuard lo segnala una volta all'avvio - **`profiles/`** — I profili di limiti del tempo di gioco salvati - **`exports/`** — Le esportazioni dell'attività - **`nand//`** — Ciò che appartiene a un sistema, ognuno con il proprio filtro famiglia: `sysmmc/` per il sysMMC, `emummc/` per l'emuMMC. Dentro: `history.json` la cronologia delle modifiche (le 500 più recenti, comprese quelle rifiutate dalla console; se non si può leggere, viene conservata come `history.json.bad`, la precedente come `.bad.1`, invece di essere sovrascritta, e PlayGuard lo segnala una volta); `state.json` ciò che *Blocca tutti i giochi*, il tempo extra, un nuovo blocco in sospeso e la scelta del firmware devono ricordare ([config.md](https://guard.boreale.dev/it/docs/config.md#state-kept-between-launches), in inglese); `forwarders.json` i forwarder creati da PlayGuard; `watch.json` ciò che PlayGuard ha visto per ultimo della console, per segnalare cosa è cambiato fuori da lui ([config.md](https://guard.boreale.dev/it/docs/config.md#watchjson), in inglese; eliminarlo non fa danni); `backups/` i backup delle impostazioni (mai il PIN); `cache/` l'ultima attività di gioco letta (tutti gli utenti, e ogni utente consultato), mostrata subito all'avvio successivo mentre il registro viene riletto. I file di una versione precedente a queste cartelle vanno al primo sistema su cui PlayGuard si avvia - **`cache/`** — Le icone dei giochi (`icons/`, 16 MB al massimo, svuotata quando cambia la lingua della console), comuni a tutti i sistemi, per non rileggere nome e icona di ogni gioco a ogni avvio; le note di rilascio di Atmosphère, hekate, sys-patch e del firmware (`sys_notes.json`, per *Console*) e quelle di PlayGuard (per *Informazioni*); in modalità sviluppatore, l'elenco di *Installa un'altra build* (`dev_builds.json`) - **`github_token`** — L'accesso a GitHub di *Invia un rapporto…* e, in modalità sviluppatore, di *Installa un'altra build*; eliminato uscendo dall'account (*Informazioni › Aiuto e diagnostica › Account GitHub*, mostrato una volta effettuato l'accesso) - **`gate.nro`**, **`gate-.nro`**, **`gate_*.txt`** — Il cancello dei forwarder protetti (*Console › Forwarder*): il suo programma, i suoi orari liberi, gli orari in cui non si apre mai e la pausa dopo i rifiuti, i suoi tentativi finché PlayGuard non li legge, e quanto dura la sua schermata di apertura (`gate_wait.txt`, letto a ogni avvio) - **`previous_build.json`**, **`boot_check.json`** — Dopo l'installazione di una build al posto di quella attuale: il nome della build sostituita (conservata accanto al `.nro` come `playguard.nro.previous`), e il controllo dell'avvio successivo (eliminato appena compare la sua prima schermata) - **`rescue_report.txt`** — Lasciato dal sysmodule di ripristino dopo il suo intervento, finché PlayGuard non lo mostra all'avvio (se non si può leggere viene rimosso, e PlayGuard lo segnala) - **`rescue_nonce`** — Una sfida casuale a cui il sysmodule di ripristino risponde nel suo rapporto, perché PlayGuard distingua un rapporto scritto da lui da uno scritto a mano ([sysmodule/rescue/README.md](https://github.com/JigSawFr/PlayGuard/blob/main/sysmodule/rescue/README.md), in inglese); uno nuovo a ogni avvio - **`sync.conf`** — Solo una volta configurato l'*Accesso remoto*: le impostazioni del collegamento, password del broker compresa (mai in un rapporto né in un invio) - **`sync/`** — Solo con l'*Accesso remoto*: i profili salvati, per l'agente facoltativo (`profiles.txt`); ciò che legge e scrive per un sistema è nel `nand//sync/` di quel sistema (registrazioni, nomi dei giochi, ciò che ha cambiato, i suoi eventi). Un sysMMC e un emuMMC condividono `sync.conf` ma sono due dispositivi in Home Assistant - **`logs/`** — `reports/` i rapporti di diagnostica salvati (mai il PIN né il numero di serie); `crashes/` un file per crash (ciò che ha fermato PlayGuard); `uploads/` un collegamento Internet (`.url`) per ogni rapporto inviato online; `play_timer/` i file del tempo di gioco degli strumenti per sviluppatori. Quanti rapporti, file di crash e link vengono conservati: *Informazioni › Aiuto e diagnostica* (per numero, età o dimensione; il più recente resta sempre) Maggiori dettagli in [packaging/README.md](https://github.com/JigSawFr/PlayGuard/blob/main/packaging/README.md) (in inglese).