ShadowMountPlus continua a ricevere aggiornamenti ravvicinati e arriva alla versione 1.7 alpha 5, una nuova release di test che introduce diverse ottimizzazioni per il montaggio delle immagini e migliora la gestione dei giochi sulle PlayStation 5 modificate.

Sviluppato da drakmor come evoluzione di ShadowMount, il payload è pensato per automatizzare il rilevamento e il montaggio dei giochi, evitando di dover intervenire manualmente ogni volta che viene collegata un’unità esterna o viene aggiunto un nuovo titolo.

Il progetto permette infatti di individuare le immagini presenti nelle cartelle configurate e renderle disponibili direttamente nel sistema della console.

La versione 1.7alpha5, indicata dallo sviluppatore come una versione di test instabile, si concentra soprattutto sulle prestazioni e sull’affidabilità del sistema di montaggio.

Ottimizzato il montaggio LVD, introducendo anche il percorso rapido BFS con blocchi I/O da 64 KiB quando supportati dall’ambiente. Per le immagini PFSC annidate è stato inoltre aggiunto il caching degli offset compressi, con l’obiettivo di ridurre ulteriormente i tempi di accesso ai dati.

Un’altra modifica riguarda la creazione delle immagini: gli script sono stati aggiornati per utilizzare una dimensione fissa dell’unità di allocazione exFAT pari a 64 KiB. Sono stati inoltre migliorati la stabilità durante il montaggio e lo smontaggio delle immagini LVD e MD e la gestione delle immagini già occupate.

In questi casi ShadowMountPlus ora procede allo smontaggio in maniera più sicura, evitando il teardown forzato che potrebbe causare problemi.

La nuova alpha introduce anche una funzione dedicata al controllo della temperatura della ventola. Ora è possibile impostare il parametro fan_target_temperature scegliendo tra la modalità automatica oppure un valore compreso tra 50 e 91 gradi, permettendo così di definire il comportamento della ventola in base alle proprie esigenze.

Infine, è stato ampliato il sistema di logging diagnostico relativo al backport e a UnionFS, fornendo maggiori informazioni utili durante l’analisi di eventuali problemi di montaggio o funzionamento.

La nuova versione arriva dopo una serie di aggiornamenti che hanno progressivamente trasformato il ramo 1.7.

Con la 1.7alpha4, ShadowMountPlus aveva introdotto il montaggio persistente opzionale delle immagini tra un avvio e l’altro del gioco, una gestione più efficiente dei file descriptor dello scanner, report dettagliati in caso di segnali fatali, un recupero USB migliorato dopo sospensione e ripresa e la possibilità di passare più facilmente da un gioco montato all’altro.

Era stato inoltre aggiunto il supporto alle notifiche localizzate in 30 lingue, con rilevamento automatico della lingua della console.

La precedente 1.7alpha3 aveva invece portato una API HTTP/JSON pubblica per elencare, montare e smontare i giochi, insieme a funzioni per rimuovere automaticamente dalla libreria i titoli la cui sorgente non è più disponibile.

La versione 1.7alpha1 aveva introdotto un sistema più efficiente per montare i giochi soltanto quando vengono avviati, una cache dei metadati delle immagini, un migliore supporto alle catene di immagini annidate e la possibilità di gestire fino a 8192 giochi distribuiti su 2048 immagini.

Il ramo 1.7, rappresenta quindi un’evoluzione significativa di ShadowMountPlus, con lo sviluppatore concentrato non soltanto sull’automazione del montaggio, ma anche su prestazioni, stabilità, gestione delle periferiche USB, diagnostica e controllo termico della PS5.

Essendo una alpha di test, la versione 1.7alpha5 rimane destinata principalmente agli utenti che vogliono provare in anticipo le nuove funzionalità e contribuire alla fase di sviluppo.

Per un utilizzo quotidiano è quindi consigliabile tenere presente che potrebbero essere presenti bug o comportamenti ancora non definitivi.

Compatibilità

• Supporta tutti i firmware PS5 jailbroken che eseguono Kstuff v1.6.7.

Supporto immagini attuale

Nota: Il supporto PFS è sperimentale.

Note

• Backend, modalità sola lettura e dimensione dei settori configurabili tramite /data/shadowmount/config.ini.
• Il logging di debug è abilitato di default (debug=1) e scrive su console e su /data/shadowmount/debug.log (impostare debug=0 per disattivarlo).
• exFAT è il filesystem di immagine consigliato, anche su firmware 4.xx, senza problemi noti di riavvio o spegnimento nell’uso tipico.

Filesystem consigliato

• Preferire exFAT (.exfat) nella maggior parte dei casi: Generalmente più performante, case-insensitive e senza problemi di riavvio/spegnimento nell’uso tipico.
• Utilizzare UFS (.ffpkg) solo quando necessario per specifiche esigenze di compatibilità con il proprio gioco o setup.

Configurazione runtime (/data/shadowmount/config.ini)

File opzionale. Se non esiste, vengono utilizzate le impostazioni predefinite integrate.

Chiavi supportate (tutte opzionali)

• debug=1|0 (1 abilita l’output log_debug su console + /data/shadowmount/debug.log; predefinito: 1).
• mount_read_only=1|0 (predefinito: 1).
• recursive_scan=1|0 (0 = scansiona solo le sottocartelle di primo livello, 1 = scansione ricorsiva senza limite di profondità; predefinito: 0).
• exfat_backend=lvd|md (predefinito: lvd).
• ufs_backend=lvd|md (predefinito: lvd).
• scanpath=<percorso_assoluto> (può essere ripetuto su più righe; predefinito: elenco percorsi di scansione integrato).
• lvd_exfat_sector_size=<valore> (predefinito: 512).
• lvd_ufs_sector_size=<valore> (predefinito: 4096).
• lvd_pfs_sector_size=<valore> (predefinito: 32768).
• md_exfat_sector_size=<valore> (predefinito: 512).
• md_ufs_sector_size=<valore> (predefinito: 512).

Comportamento dei percorsi di scansione

• Se è presente almeno una voce scanpath=..., verranno utilizzati solo i percorsi personalizzati indicati.
• /data/ufsmnt viene sempre aggiunto automaticamente, anche in presenza di percorsi personalizzati.
• Con recursive_scan=0 (predefinito), vengono controllate solo le sottocartelle di primo livello.
• Con recursive_scan=1, le sottocartelle vengono scansionate in modo ricorsivo.
• Il ciclo completo di scansione viene eseguito ogni 10 secondi.

Validazione

• Consultare config.ini.example per un modello pronto all’uso.

Nome dei mount point

I mountpoint delle immagini vengono creati in: /data/ufsmnt/<nome_immagine>-<suffisso_fs>

Requisiti di layout dell’immagine (.ffpkg, .exfat, .ffpfs):

• I file di gioco devono trovarsi alla radice dell’immagine.
• Non aggiungere una cartella extra di primo livello all’interno dell’immagine.
• Esempio valido: /sce_sys/param.json esiste direttamente dalla radice dell’immagine.
• Esempio non valido: /GAME_FOLDER/sce_sys/param.json (livello di nidificazione extra).

Percorsi di scansione predefinite

• /data/homebrew
• /data/etaHEN/games
• /mnt/ext0/homebrew
• /mnt/ext0/etaHEN/games
• /mnt/ext1/homebrew
• /mnt/ext1/etaHEN/games
• /mnt/usb0/homebrew … /mnt/usb7/homebrew
• /mnt/usb0/etaHEN/games … /mnt/usb7/etaHEN/games
• /mnt/usb0 … /mnt/usb7
• /mnt/ext0
• /mnt/ext1
• /data/ufsmnt (scansione del contenuto delle immagini montate)

È possibile sovrascrivere le radici di scansione con voci scanpath=... in /data/shadowmount/config.ini.

• Struttura cartelle consigliata:
  • Modalità predefinita (recursive_scan=0):
    • /data/homebrew/<TITLE_ID>/
    • /data/etaHEN/games/<TITLE_ID>/
  • Modalità ricorsiva (recursive_scan=1):
    • /data/homebrew/PS5/<AnyFolder>/<TITLE_ID>/
    • /mnt/ext0/etaHEN/games/<Collection>/<TITLE_ID>/

Creazione immagine exFAT

Linux (Ubuntu/Debian)

• Installazione dei componenti richiesti:
  • sudo apt-get update && sudo apt-get install -y exfatprogs exfat-fuse fuse3 rsync
• Script:mkexfat.sh
• Utilizzo:./mkexfat.sh <game_root_dir> [output_file]
• Esempio:
  • chmod +x mkexfat.sh
  • ./mkexfat.sh ./APPXXXX ./PPSA12345.exfat
• Note:
  • La cartella di origine deve essere la radice del gioco e contenere eboot.bin.
  • Calcola automaticamente le dimensioni dell’immagine utilizzando l’allocazione arrotondata dei file + metadati + margine di sicurezza.
  • Seleziona automaticamente il profilo del cluster exFAT:
  • Profilo di file di grandi dimensioni: 64K
  • Profilo piccolo/file misto: 32K

Windows:

• Consigliato: utilizzare make_image.bat (wrapper per New-OsfExfatImage.ps1 + OSFMount).
• Requisiti:
  • Installare OSFMount: https://www.osforensics.com/tools/mount-disk-images.html.
  • Mantenere make_image.bat e New-OsfExfatImage.ps1 nella stessa cartella.
  • Eseguire cmd.exe come amministratore.
• Utilizzo:
  • make_image.bat "C:\images\game.exfat" "C:\payload\APPXXXX"
• <>Comportamento:
  • Adatta automaticamente le dimensioni dell’immagine al contenuto sorgente.
  • La cartella di origine deve essere la radice del gioco e contenere il file eboot.bin.
  • Formattare e copiare il contenuto della cartella di origine nella radice dell’immagine.
• Facoltativo (dimensione fissa): eseguire direttamente lo script PowerShell:
  • powershell.exe -ExecutionPolicy Bypass -File .\New-OsfExfatImage.ps1 -ImagePath "C:\images\game.exfat" -SourceDir "C:\payload\APPXXXX" -Size 8G -ForceOverwrite

Creazione di un’immagine UFS2 (.ffpkg)

FreeBSD:

• Script: mkufs2.sh
• Utilizzo: ./mkufs2.sh <game_root_dir> [output_file]
• Esempio:
  • chmod +x mkufs2.sh
  • ./mkufs2.sh ./APPXXXX ./PPSA12345.ffpkg
• Note:
  • La cartella di origine deve essere la radice del gioco e contenere il file eboot.bin.
  • Lo script calcola automaticamente le dimensioni dell’immagine utilizzando l’allocazione arrotondata dei file + metadati + margine di sicurezza.
  • Parametri newfs consigliati per UFS2:
  • Profilo di file di grandi dimensioni: newfs -O 2 -b 65536 -f 4096 -m 0 -i 262144
  • Profilo piccolo/file misto: newfs -O 2 -b 32768 -f 4096 -m 0 -i 262144
  • mkufs2.sh seleziona automaticamente uno dei due profili (in base alla dimensione media del file).

Windows:

• È possibile creare immagini UFS2 con UFS2Tool https://github.com/SvenGDK/UFS2Tool.
• Esempio:
  • UFS2Tool.exe newfs -O 2 -b 32768 -f 4096 -m 0 -i 262144 -D ./APPXXXX ./PPSA12345.ffpkg

Installazione e utilizzo

Metodo 1: Iniezione manuale del payload (Porta 9021)

Utilizzare un payload sender (come NetCat GUI o un loader web) per inviare i file alla porta 9021.

• Inviare notify.elf (opzionale).
  • Inviare questo file solo se si desiderano popup grafici. Saltare se si preferiscono notifiche standard.
• Inviare shadowmountplus.elf.
  • Attendere la notifica: “ShadowMount+”.

Metodo 2: PLK Autoloader (Consigliato)

• Aggiungere ShadowMountPlus al file autoload.txt per plk-autoloader, così da garantirne l’avvio automatico a ogni accensione.

Configurazione di esempio:

!1000
kstuff.elf
!1000
notify.elf  ; Opzionale - Rimuovere questa riga se non si desiderano notifiche avanzate (Rich Toast)
!1000
shadowmountplus.elf

Risoluzione dei problemi

Se un gioco non viene montato:

• Il log di debug è abilitato di default; se disattivato, impostare debug=1 in /data/shadowmount/config.ini.
• Controllare /data/shadowmount/debug.log e le notifiche di sistema di ShadowMount+.
• Verificare le directory di scansione:
  • Se è impostato scanpath=..., verranno scansionati esclusivamente quei percorsi.
  • /data/ufsmnt viene sempre scansionato.
• Verificare la profondità di scansione:
  • recursive_scan=0 scansiona solo le sottocartelle di primo livello.
  • recursive_scan=1 esegue la scansione ricorsiva.
• Verificare la struttura del gioco:
  • Gioco in cartella: <GAME_DIR>/sce_sys/param.json.
  • Gioco in immagine (.ffpkg / .exfat / .ffpfs): sce_sys/param.json deve trovarsi nella root dell’immagine (senza cartelle aggiuntive di livello superiore).
• Se viene segnalato un param.json mancante o non valido per un’immagine, verificare via FTP che /data/ufsmnt/<TITLE_ID>/ contenga tutti i file del gioco e sce_sys/param.json.
• Se si verifica un errore di mount dell’immagine, controllare l’integrità dell’immagine e il tipo di filesystem (.ffpkg=UFS, .exfat=exFAT, .ffpfs=PFS).
• Se appare una notifica di titleId duplicato, mantenere una sola sorgente per ogni <TITLE_ID>.

Se un gioco viene montato ma non si avvia:

• Controllare le notifiche di registrazione (Register failed ...).
• Se il gioco non risulta registrato, provare a rimuovere la sua icona di avvio e a eliminarlo da Itemzflow.
• Se il problema persiste, eliminare i dati del gioco dalle impostazioni di sistema e riprovare (questo comporterà la cancellazione dei salvataggi).

Note

• Primo avvio: Se avete una libreria estesa, la scansione iniziale può richiedere alcuni secondi per registrare tutti i titoli.
• Giochi di grandi dimensioni: Per giochi molto grandi (oltre 100 GB), concedere qualche secondo in più affinché il sistema verifichi l’integrità dei file prima che compaia la notifica “Installed”.

Changelog v1.7alpha5

Versione di test. Instabile

• Ottimizzato il montaggio LVD e abilitato il percorso rapido BFS con trasferimenti I/O da 64 KiB dove supportato.
• Abilitato il caching degli offset compressi per le immagini PFSC annidate.
• Aggiornati gli script per la creazione delle immagini, ora configurati per utilizzare un’unità di allocazione exFAT fissa da 64 KiB.
• Migliorata la stabilità durante il montaggio e lo smontaggio delle immagini LVD/MD.
• Le immagini occupate vengono ora smontate in modo sicuro, senza ricorrere al teardown forzato.
• Aggiunta la configurazione della temperatura della ventola tramite fan_target_temperature=auto|50..91.
• Ampliato il logging diagnostico relativo a backport/UnionFS.

Changelog v1.7alpha4

Versione di test. Instabile.

Questa versione migliora l’affidabilità del montaggio, la gestione del ciclo di vita dei giochi e la facilità d’uso:

• Aggiunto il montaggio persistente opzionale delle immagini tra un avvio e l’altro dei giochi (modalità Legacy).
  persistent_image_mounts=1|0 (1 mantiene montate le immagini rilevate tra un avvio e l’altro dei giochi; valore predefinito: 0).
• Ridotto l’utilizzo dei file descriptor da parte dello scanner.
• Aggiunti report dettagliati sui segnali fatali per i giochi monitorati.
• Migliorato il ripristino dei giochi su USB dopo la sospensione e la ripresa della console.
• Aggiunto il passaggio senza interruzioni tra i giochi montati.
• Aggiunte notifiche localizzate in 30 lingue, con rilevamento automatico della lingua della console e possibilità di selezionarla manualmente tramite language.

Changelog v1.7alpha3

Versione di test. Instabile.

• Aggiunta una API HTTP/JSON pubblica per elencare, montare e smontare i giochi.
• Aggiunta la rimozione automatica opzionale dei giochi con sorgenti non disponibili, con protezione per i titoli che dispongono di DLC:
  • auto_remove_missing_games=1|0 — con 1 rimuove automaticamente dalla libreria di sistema i giochi quando la relativa sorgente non è più disponibile; valore predefinito: 0.
  • auto_remove_games_with_dlc=1|0 — con 1 consente la rimozione automatica dei giochi che hanno DLC installati; valore predefinito: 0.
  • auto_remove_missing_delay_seconds=<1..86400> — indica per quanto tempo la sorgente deve rimanere non disponibile prima della rimozione; valore predefinito: 300 secondi.
• Migliorate le prestazioni della preparazione e della registrazione dei metadati dei giochi.
• Risolto il problema relativo alla pulizia dei montaggi temporanei dopo la chiusura dei giochi.
• Corretto il conteggio dei giochi per le immagini invariate riutilizzate dall’indice.

Changelog v1.7alpha2

Versione di test. Instabile.

• Migliorata la convalida dei percorsi runtime e dei titoli.
• Risolta la gestione del ciclo di vita del montaggio dei giochi, del riavvio, della sospensione e dello spegnimento.
• Posticipato il teardown del runtime fino al completamento di unmountWorkspace da parte di ShellCore.
• Reso più sicuro lo smontaggio di nullfs e delle immagini, evitando il teardown forzato e mostrando le dipendenze del montaggio quando un dispositivo è occupato.
• Resa più sicura durante lo spegnimento la gestione del passaggio dell’automount di KStuff e del contrassegno .kstuff_noautomount.

Changelog v1.7alpha1

• I giochi ora vengonomontati solamente quando vengono avviati e smontati dopo la loro chiusura, riducendo il numero di montaggi persistenti del filesystem.
• Aggiunta una cache dei metadati delle immagini per evitare di montare ripetutamente durante le scansioni le immagini che non hanno subito modifiche.
• Migliorato il supporto per le catene di immagini annidate e la pulizia dei montaggi runtime.
• I giochi presenti su USB vengono arrestati in modo sicuro prima di entrare in modalità riposo.
• Dal firmware 12.00 e successivi viene ora utilizzata la registrazione InstallTitleDir per singolo titolo invece della registrazione tramite InstallAll in blocco.
• Migliorate la stabilità dei montaggi, la gestione dello spegnimento e le prestazioni dello scanner.
• Supporto fino a 8192 giochi distribuiti su 2048 immagini.
• Ridotto il numero di watcher utilizzati dallo scanner e disabilitati i monitoraggi USB durante la sospensione della console.

Download: ShadowMountPlus v1.7 Alpha 5

Download: Source code ShadowMountPlus v1.7 Alpha 5

Alcune parti di questo articolo sono state generate con l’aiuto dell’intelligenza artificiale.

Ultimo aggiornamento 2026-09-13 / Link di affiliazione / Immagini da Amazon Product Advertising API