User Manual Portuguese

Manual do Usuário e Técnico — XGDTool (v1.4.0)

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

---

1. Visão Geral

XGDTool (Fork de Alta Performance por Ashnar2602, baseado no projeto original de WiredOpposite) é uma suíte unificada para conversão, verificação e otimização de imagens de disco para Xbox Clássico e Xbox 360.

Disponível em três versões:

• XGDTool-GUI (Windows): Interface desktop com Modo Escuro, fila Drag & Drop, verificação de integridade e integração ao Windows Explorer.
• XGDTool-CLI (Windows): Executável de linha de comando portátil para automações e scripts.
• XGDTool-Android (Android 8.0+): Aplicativo móvel nativo com Material 3 Dark, motor Zero-Copy e suporte em 7 idiomas.

---

2. Interface Gráfica Windows (XGDTool-GUI)

2.1 Fila de Arquivos e Drag & Drop

1. Abra o XGDTool-GUI.exe.
2. Arraste arquivos .iso, .xiso, .cso, .cci, .zar ou pastas para a janela.
3. Você também pode usar os botões Adicionar Arquivos... ou Adicionar Pasta....
4. A lista exibe o caminho, tamanho e status de cada item.

2.2 Formatos de Saída

• XISO: Imagem de disco otimizada para gravação ou emuladores.
• GoD (Games on Demand): Pacote Xbox 360 (00007000) para consoles RGH/JTAG.
• ZAR (ZArchive): Arquivo comprimido multi-thread Zstandard para emuladores como Xenia Canary.
• CSO: Imagem comprimida por blocos LZ4.
• CCI: Imagem comprimida LZ4 para emuladores de Xbox Clássico.
• Extrair Pasta: Extrai o sistema de arquivos diretamente em pastas.

2.3 Verificação de Imagem (Verify Image)

• Clique em Verify Image para realizar uma verificação diagnóstica sem alterar o arquivo.
• Analisa geometria do disco (XGD2/XGD3), sistema AVL, Title ID, nome do jogo e gera somas CRC32, MD5 e SHA-1.

2.4 Opções e Preferências

• Renomeação Inteligente ([<TitleID>] <GameName>): Renomeia automaticamente a saída segundo o padrão Xbox.
• Gerar Arquivo .dvd: Cria o arquivo .dvd com o layerbreak exato para o ImgBurn.
• Scrubbing Completo: Preenche setores não utilizados com zeros na memória RAM.
• Menu de Contexto do Windows: Clique em Registrar Menu de Contexto para habilitar a opção no botão direito do Explorer.

---

3. Linha de Comando (XGDTool-CLI)

3.1 Sintaxe

XGDTool-CLI.exe [OPÇÕES] <caminho_entrada> [caminho_saída]

3.2 Tabela de Opções

Opção	Argumento	Descrição
--xiso	Nenhum	Converte para formato ISO / XISO
--god	Nenhum	Converte para formato Games on Demand (GoD)
--zar	Nenhum	Converte para arquivo comprimido ZArchive (Zstandard)
--cso	Nenhum	Converte para formato comprimido CSO (LZ4)
--cci	Nenhum	Converte para formato comprimido CCI (LZ4)
--extract	Nenhum	Extrai o conteúdo do disco para pastas
--verify	Nenhum	Verificação diagnóstica de integridade
--smart-rename	Nenhum	Renomeia automaticamente para [<TitleID>] <GameName>
--threads	<N>	Número de threads para compressão paralela
--level	<1-6>	Nível de compressão Zstd para ZAR (padrão: 2)
--dvd	Nenhum	Gera arquivo .dvd com o layerbreak
--full-scrub	Nenhum	Limpa todos os setores de padding
--checksum	Nenhum	Calcula CRC32, MD5 e SHA-1 durante a gravação
--register-shell	Nenhum	Registra o menu de contexto no botão direito do Explorer
--unregister-shell	Nenhum	Remove a integração do menu de contexto
-h, --help	Nenhum	Exibe a ajuda e encerra

---

4. Aplicativo Android (XGDTool-Android)

• Armazenamento Zero-Copy: Gravação direta no armazenamento interno e cartão MicroSD sem cópias redundantes no cache.
• Aceleração de Hardware ARMv8: Cálculo de CRC32 a 15–20 GB/s em processadores ARM64.
• Serviço em Primeiro Plano: Conversão segura em segundo plano com notificações em tempo real.