User Manual Spanish

Manual de Usuario y Técnico — XGDTool (v1.4.0)

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

---

1. Visión General

XGDTool (Fork de Alto Rendimiento por Ashnar2602, basado en la herramienta original de WiredOpposite) es la suite unificada para la conversión, verificación y optimización de imágenes de disco para Xbox Original y Xbox 360.

Incluye tres plataformas oficiales:

• XGDTool-GUI (Windows): Aplicación de escritorio con interfaz oscura, cola de archivos Drag & Drop, verificación de imágenes e integración con el Explorador de Windows.
• XGDTool-CLI (Windows): Ejecutable ligero para terminal y automatización sin dependencias externas.
• XGDTool-Android (Android 8.0+): Aplicación nativa con interfaz Material 3 Dark, almacenamiento Zero-Copy y soporte en 7 idiomas.

---

2. Interfaz Gráfica de Windows (XGDTool-GUI)

2.1 Gestión de Cola y Arrastrar y Soltar

1. Ejecuta XGDTool-GUI.exe.
2. Arrastra archivos .iso, .xiso, .cso, .cci, .zar o carpetas de juego a la ventana.
3. También puedes usar Añadir Archivos... o Añadir Carpeta....
4. La cola muestra la ruta, tamaño y estado de cada elemento.

2.2 Selección del Formato de Salida

• XISO: Imagen limpia (scrubbed) para grabación en disco o emuladores.
• GoD (Games on Demand): Contenedor para Xbox 360 RGH/JTAG (00007000) para ejecución directa desde USB/HDD.
• ZAR (ZArchive): Archivo comprimido con Zstandard para Xenia Canary.
• CSO: Imagen comprimida por bloques mediante LZ4.
• CCI: Imagen comprimida LZ4 para emuladores de Xbox Original.
• Extraer Carpeta: Extracción directa de archivos y carpetas del disco.

2.3 Verificación Diagnóstica de Imágenes (Verificar Imagen)

• Pulsa Verificar Imagen para escanear la integridad del disco sin modificarlo.
• Inspecciona la geometría del disco (XGD2/XGD3, layerbreak), sistema de archivos AVL, Title ID, Media ID y genera sumas CRC32, MD5 y SHA-1.

2.4 Opciones y Preferencias

• Renombrado Inteligente ([<TitleID>] <GameName>): Nombra automáticamente el archivo de salida según el formato estándar.
• Generar Archivo .dvd: Crea el archivo .dvd con el layerbreak correspondiente para ImgBurn.
• Scrubbing Completo: Rellena con ceros los sectores no utilizados directamente en memoria RAM.
• Calcular Checksum: Calcula sumas de verificación en tiempo real durante la escritura.
• Nivel de Compresión: Selecciona el nivel Zstandard (1 a 6) para archivos ZAR.
• Menú Contextual: Haz clic en Registrar Menú Contextual para integrar la herramienta en el botón derecho de Windows.

---

3. Línea de Comandos (XGDTool-CLI)

3.1 Sintaxis

XGDTool-CLI.exe [OPCIONES] <ruta_entrada> [ruta_salida]

3.2 Tabla de Opciones

Opción	Argumento	Descripción
--xiso	Ninguno	Convierte a formato ISO / XISO
--god	Ninguno	Convierte a formato Games on Demand (GoD)
--zar	Ninguno	Convierte a archivo comprimido ZArchive (Zstandard)
--cso	Ninguno	Convierte a formato comprimido CSO (LZ4)
--cci	Ninguno	Convierte a formato comprimido CCI (LZ4)
--extract	Ninguno	Extrae el contenido del disco en carpetas sueltas
--verify	Ninguno	Escaneo diagnóstico y verificación de integridad
--smart-rename	Ninguno	Renombra automáticamente como [<TitleID>] <GameName>
--threads	<N>	Número de hilos para compresión en paralelo
--level	<1-6>	Nivel de compresión Zstd para ZAR (por defecto: 2)
--dvd	Ninguno	Genera archivo .dvd con el layerbreak
--full-scrub	Ninguno	Limpia todos los sectores de relleno no utilizados
--checksum	Ninguno	Calcula CRC32, MD5 y SHA-1 durante la escritura
--register-shell	Ninguno	Registra la integración en el menú contextual de Windows
--unregister-shell	Ninguno	Desregistra el menú contextual
-h, --help	Ninguno	Muestra la ayuda y sale

---

4. Aplicación Android (XGDTool-Android)

• Almacenamiento Zero-Copy: Lee y escribe directamente en el almacenamiento interno o tarjetas MicroSD sin duplicar archivos en caché.
• CRC32 Acelerado por Hardware: Instrucciones ARMv8 ACLE a 15–20 GB/s.
• Servicio en Primer Plano: Continúa la conversión con la pantalla apagada o en segundo plano.

---

5. Compatibilidad y Preguntas Frecuentes

• Sobrecarga de checksum: 0.0 segundos; se calcula al vuelo en memoria RAM.
• Integración en Windows: Ejecuta XGDTool-CLI.exe --register-shell desde una terminal.