Guida Uso Italiano

Manuale d'Uso e Tecnico — XGDTool (v1.4.0)

English · Italiano · Español · Français · Deutsch · Português · 简体中文

---

1. Panoramica del Progetto

XGDTool (Fork ad Alte Prestazioni di Ashnar2602, basato sull'utility originale di WiredOpposite) e la suite unificata per la conversione, verifica e ottimizzazione di immagini disco per Xbox Originale e Xbox 360.

Il progetto include tre target ufficiali:

• XGDTool-GUI (Windows): Applicazione desktop con interfaccia scura, gestione coda Drag & Drop, verifica diagnostica e integrazione nel menu contestuale di Windows.
• XGDTool-CLI (Windows): Eseguibile a riga di comando standalone, leggero e privo di dipendenze esterne, ideale per script e automazioni.
• XGDTool-Android (Android 8.0+): Applicazione mobile nativa con interfaccia Material 3 Dark, motore di archiviazione Zero-Copy, servizio in background e localizzazione in 7 lingue.

---

2. Interfaccia Grafica Windows (XGDTool-GUI)

2.1 Gestione della Coda e Drag & Drop

1. Avvia XGDTool-GUI.exe.
2. Trascina qualsiasi file .iso, .xiso, .cso, .cci, .zar o cartella di gioco all'interno della finestra.
3. Puoi anche usare i pulsanti Aggiungi File... o Aggiungi Cartella....
4. La coda mostra percorso, dimensioni rilevate e stato per ogni elemento inserito.

2.2 Selezione del Formato di Output

Scegli il formato desiderato tramite i selettori radio:

• XISO: Immagine disco Xbox / Xbox 360 ripulita (scrubbed), pronta per la masterizzazione o emulazione.
• GoD (Games on Demand): Pacchetto contenitore Xbox 360 (00007000) per avvio diretto da USB/HDD su console RGH/JTAG.
• ZAR (ZArchive): Archivio compresso multi-thread in Zstandard, ideale per Xenia Canary.
• CSO: Immagine disco compressa a blocchi LZ4.
• CCI: Immagine compressa LZ4 a chunk per emulatori Xbox Originale.
• Estrai Cartella: Estrazione diretta del file system della ISO in file e cartelle sciolti.

2.3 Verifica Diagnostica delle Immagini (Verifica Immagine)

• Clicca su Verifica Immagine per eseguire un controllo di integrita non distruttivo sul file selezionato.
• Ispeziona geometria del disco (XGD2 / XGD3, layer break), struttura del filesystem AVL, Title ID, Media ID, Nome del Gioco e calcola al volo gli hash CRC32, MD5 e SHA-1.

2.4 Opzioni e Preferenze di Conversione

• Rinomina Intelligente ([<TitleID>] <GameName>): Assegna automaticamente il nome standard Xbox all'output generato.
• Genera File .dvd: Crea il file .dvd con il layerbreak corretto (1913760 per XGD2, 2133520 per XGD3) pronto per ImgBurn.
• Scrubbing Completo: Azzera i settori inutilizzati direttamente nei buffer RAM, velocizzando l'operazione.
• Calcola Checksum: Calcola CRC32, MD5 e SHA-1 accelerato in hardware (SHA-NI) durante la scrittura.
• Livello di Compressione: Regola la compressione Zstandard (livelli 1-6) per gli archivi ZAR.
• Thread di Lavoro: Imposta il numero di core CPU usati per la compressione parallela.
• Apri Cartella Output: Apre la cartella di destinazione al termine della coda.
• Suono di Completamento: Riproduce un avviso sonoro al termine dei lavori.
• Menu Contestuale Windows: Clicca su Registra Menu Contestuale per integrare XGDTool nel tasto destro di Windows Explorer.

---

3. Interfaccia a Riga di Comando (XGDTool-CLI)

3.1 Sintassi

XGDTool-CLI.exe [OPZIONI] <percorso_input> [percorso_output]

3.2 Tabella delle Opzioni

Opzione	Argomento	Descrizione
--xiso	Nessuno	Converte in formato ISO / XISO per Xbox o Xbox 360
--god	Nessuno	Converte in formato Games on Demand (GoD)
--zar	Nessuno	Converte in archivio compresso ZArchive (Zstandard)
--cso	Nessuno	Converte in formato compresso CSO (LZ4)
--cci	Nessuno	Converte in formato compresso CCI (LZ4)
--extract	Nessuno	Estrae il contenuto del disco in file e cartelle
--verify	Nessuno	Scansione diagnostica non distruttiva e verifica integrita
--smart-rename	Nessuno	Rinomina automaticamente l'output come [<TitleID>] <GameName>
--threads	<N>	Numero di thread per la compressione parallela
--level	<1-6>	Livello di compressione Zstd per ZAR (predefinito: 2)
--dvd	Nessuno	Genera file .dvd pre-configurato con il layerbreak
--full-scrub	Nessuno	Azzera tutti i settori di padding non utilizzati
--checksum	Nessuno	Calcola CRC32, MD5 e SHA-1 durante la scrittura
--register-shell	Nessuno	Registra il menu contestuale nel tasto destro di Windows Explorer
--unregister-shell	Nessuno	Rimuove il menu contestuale da Windows Explorer
-h, --help	Nessuno	Mostra la guida dei comandi ed esce

3.3 Esempi Pratici

1. Verificare un'immagine disco senza modificarla:

   XGDTool-CLI.exe --verify "D:\Giochi\Halo_Reach.iso"

2. Convertire una ISO in Games on Demand (GoD) per Xbox 360 RGH:

   XGDTool-CLI.exe --god "D:\Giochi\Halo_Reach.iso" "E:\Content\0000000000000000"

3. Convertire ISO in archivio ZAR con rinomina automatica:

   XGDTool-CLI.exe --zar --level 3 --smart-rename "D:\Giochi\Gears_of_War.iso" "D:\Emulatori\Xenia"

4. Convertire un'intera cartella di ISO in CSO usando 8 thread:

   XGDTool-CLI.exe --cso --threads 8 "D:\Collezione_ISO" "D:\Output_CSO"

5. Registrare l'integrazione con Windows Explorer:

   XGDTool-CLI.exe --register-shell

---

4. Applicazione Android (XGDTool-Android)

4.1 Caratteristiche Principali

• Motore Zero-Copy: Converte direttamente su memoria interna (/storage/emulated/0) e microSD esterne tramite MANAGE_EXTERNAL_STORAGE, evitando 15-20 GB di copie temporanee in cache.
• CRC32 Vettorizzato ARMv8: Istruzioni assembly dedicate (__crc32d) con velocita di 15-20 GB/s su dispositivi ARM64.
• Servizio in Background: Le conversioni proseguono anche con l'app in secondo piano grazie a una notifica persistente.
• Mantieni Schermo Acceso: Opzione per evitare lo standby durante conversioni lunghe.
• Ricerca Titolo Online/Offline: Ottiene il titolo corretto del gioco dal Title ID con timeout configurato.

4.2 Guida Rapida Android

1. Apri l'app sul dispositivo.
2. Tocca Sorgente e seleziona il file disco o la cartella.
3. Tocca Destinazione e scegli la cartella di salvataggio.
4. Scegli il formato di output (ZAR, GOD, CCI, CSO).
5. Tocca Converti.

---

5. Compatibilita Formati ed Emulatori

Formato	Estensione	Hardware / Emulatore Consigliato	Note
ISO / XISO	.iso	Xbox Originale, Xbox 360, Xemu, Xenia	Immagine standard non compressa
GoD	00007000	Xbox 360 RGH/JTAG, Aurora, FreestyleDash	Avvio diretto da hard disk o USB
ZAR	.zar	Xenia Canary, Cemu	Archivio Zstd compatto (~2 GB/s in lettura)
CSO	.cso	Emulatori Xbox, Xemu	Compressione a blocchi LZ4 veloce
CCI	.cci	Emulatori Xbox Originale	Allocazione LZ4 ottimizzata
Estrai	Cartella	Aurora, FreestyleDash, Dashboard Xbox Originale	File e cartelle estratti

---

6. Risoluzione dei Problemi e Domande Frequenti

• Overhead del calcolo Checksum: 0.0 secondi. Il calcolo avviene interamente nei buffer RAM durante la scrittura dei dati su disco.
• Verifica dell'immagine fallita: Verifica che il dump non sia corrotto e contenga la struttura standard AVL o XISO.
• Menu contestuale non visibile: Esegui XGDTool-CLI.exe --register-shell da PowerShell o usa l'opzione nelle Impostazioni della GUI.