Usage Guide

Usage Guide

Getting Started	Using the App	Technical Reference	Project
Home	Usage Guide	Architecture	Repository
Installation	Conversion Methods	XDVDFS Technical Docs	Building from Source
	XISO Explorer	Troubleshooting & FAQ	Release Notes

---

The main window is organized into four views, selectable from the navigation buttons at the top:

View	Purpose
Convert	Batch-convert ISOs (and archives containing ISOs) into trimmed XISO, ZAR, CSO, CCI, or CHD files
Test Integrity	Validate ISO, XISO, IMG, CSO, CCI, ZAR, Xbox CHD images and XBLA/XBLIG STFS packages, and repair or salvage failures
Decompress	Turn CSO, CCI, ZAR, CHD or GOD/SVOD images back into plain ISO files
Explorer	Browse the contents of an Xbox ISO, XISO, IMG, CSO, CCI, ZAR, CHD, GOD/SVOD container or XBLA/XBLIG STFS package without extracting it, with metadata, container details, checksums, extract-all, and split/join tools

Below the four views, a shared status bar shows a live log, progress bar, cancel button, statistics (total / success / fail / skipped / processing time), and per-drive read/write speed indicators.

---

The Convert Tab

1. Select Folders

• Input folder — the folder containing your source files. Supported inputs: .iso, .xiso, .img (Redump full-disc images or optimized XISO files), .zip, .7z, .rar.
• Output folder — the folder where converted .iso (XISO) files are written.

The system temporary folder (or a subfolder of it) cannot be selected as an input or output folder. The application refuses it deliberately to avoid recursive processing and cleanup conflicts.

Enable Search Subfolders to recurse into nested directories; the file list is rescanned immediately.

2. Select Files to Convert

Once an input folder is chosen, the Select Files to Convert list is filled with every supported file found (respecting Search Subfolders). Each row shows a Select checkbox, the file name relative to the input folder, and the file size.

• Untick any file you do not want to process; only ticked files are converted.
• Use Select All / Deselect All to toggle the entire list.
• The list is refreshed automatically after each batch, so it reflects deleted originals and newly created outputs.

3. Conversion Engine

All conversion is performed in-process by the XISOSharp library, with CHDSharp handling CHD encoding — there is no external tool. Choose the Output Format in the Options panel:

• XISO (default) — tightly packed, optimized XISO (.iso); images that already carry the optimized tag are skipped automatically.
• ZAR — ZArchive (.zar, zstd) for direct use in Xenia canary.
• CSO — compressed ISO (.cso, CISO v2/LZ4), compatible with the xdvdfs ecosystem.
• CCI — CCI/CCIM (.cci, LZ4 level 9 by default), written as a single file.
• CHD — Compressed Hunks of Data (.chd, CHD v5) with the chdman createdvd preset (4096-byte hunks, 2048-byte units, lzma,zlib,huff,flac).

See the Conversion Methods page for details.

4. Options

Option	Behavior when enabled
Output Format	Produces .iso (optimized XISO), .zar (ZArchive/zstd), .cso (CISO v2/LZ4), .cci (CCI/CCIM), or .chd (CHD v5, chdman createdvd preset).
Skip $SystemUpdate	Excludes the $SystemUpdate folder from the output for extra space savings (~100–300 MB).
Delete Originals	Replaces each input file with its converted version. Deletion happens only after the output has been produced and verified. An archive is kept when any entry was skipped or any extracted image was not converted.
Check Output Integrity	Audits each new XISO, then compares the output against the source (paths, sizes and per-file SHA-256 hashes) for XISO/CSO/CCI/ZAR; a deliberately removed $SystemUpdate folder is ignored. CHD is deep-verified (every hunk and hash).
Search Subfolders	Includes files found in subdirectories of the input folder in the list.

5. Start, Monitor, Cancel

• Click Start Conversion to begin the batch.
• The progress bar shows per-file and overall progress; the log pane records every action with timestamps.
• The statistics panel updates live: Total, Success, Failed, Skipped, Processing Time, plus read/write speed with a drive-letter indicator for the currently active disk.
• Click Cancel at any time. The current file operation is cancelled as soon as possible; already-converted files remain valid.

6. What Happens to Each File

The orchestrator decides per input file:

1. .iso — converted with the XISOSharp engine (or CHDSharp for CHD) into the selected output format (.iso, .zar, .cso, or .chd).
2. .zip / .7z / .rar — extracted to a temporary folder (with automatic drive fallback if the temp drive is short on space), the first ISO inside is converted, then temporaries are cleaned up. Entries that are skipped (additional ISOs, non-ISO images, unsafe paths) are reported in the log.
   • Password-protected/encrypted archives are detected and skipped with a clear message instead of a cryptic failure.
   • With Delete Originals enabled, an archive is kept whenever an entry was skipped or an image was not converted.
3. At the end, a summary is logged (files processed, succeeded, failed, skipped) and the operation is finalized.

Files stored in cloud-sync folders (OneDrive, etc.) that are not hydrated locally are detected and retried automatically with exponential backoff while the cloud provider downloads them.

---

The Test Integrity Tab

Use this view to validate images without converting them. Supported formats:

• .iso, .xiso, .img and .cso (CISO, including split .1.cso part sets) — a deep audit of the XDVDFS file tree, with an optional sequential sector scan.
• .cci (including split .1.cci part sets) — validates the CCI container and decodes every sector with the deep scan enabled, then audits the decompressed Xbox filesystem.
• .zar (ZArchive/zstd) — opens the archive (header, index, name table, file tree), walks the whole tree, and with the deep scan enabled decompresses every file to prove all blocks are readable.
• .chd (Xbox DVD images only) - verifies the CHD container (header-only, or every hunk and checksum with the deep scan enabled) and then audits the Xbox filesystem inside the decompressed image. CD/GD-ROM/hard-disk CHDs are rejected.
• GOD/SVOD headers (extensionless files with a matching .data folder) - audits the mapped XDVDFS filesystem; with the deep scan enabled the whole decompressed image is read.
• XBLA/XBLIG STFS packages (extensionless files with a CON /LIVE/PIRS signature) — verifies the package SHA-1 hash tree: every data block, file chain, level-0/1/2 table, top hash and header hash. Package signatures are not checked.

Options

Option	Behavior when enabled
Move Passed Files	Moves images that pass validation into a _success subfolder (a split set's continuation parts travel with part 1)
Move Failed Files	Moves images that fail validation into a _failed subfolder
Search Subfolders	Recurses into subdirectories of the input folder
Perform Deep Scan	Reads the entire image - every sector for ISO/CSO/CCI/GOD, every decompressed block for ZAR, every CHD hunk and checksum for CHD - to detect physical corruption / bad sectors (slower, but thorough). STFS packages are always fully hash-checked.

Recovery

Two buttons below the start button recover images that failed the test:

• Repair selected — fixes safely patchable defects in place (reserved attribute bits, a missing optimized tag, separators in names). Every image is backed up as <name>.old first; truncated or structurally broken images are reported, never modified. Only plain .iso/.xiso images can be repaired (compressed CISO/CCI files must be decompressed first).
• Salvage selected — rebuilds every reachable file from a damaged ISO, CISO or CCI image into a fresh <name>.salvaged.iso. The source is never modified, and every skipped entry is listed with its reason.

Workflow

1. Select the input folder containing the images to test.
2. Tick the files you want to test in the Select Files to Test list (or use Select All / Deselect All).
3. Choose any of the options above.
4. Click Start Integrity Test.
5. Review the log: each file is reported as passed or failed, with the reason for failure where applicable.

File moves performed by the test view use the same retry logic as conversion: transient locks (antivirus scans, cloud hydration, network hiccups) are retried with exponential backoff before being reported as failures.

---

The Decompress Tab

Use this view to turn container images back into a plain ISO:

1. Select the folder containing the compressed images and the output folder.
2. Tick the files to process. Supported inputs: .cso, .cci, .zar, .chd and extensionless GOD/SVOD headers (the matching .data folder is resolved automatically). Plain .iso/.xiso/.img files are listed but skipped as already uncompressed.
3. Choose whether to delete the originals after a successful decompression, whether to search subfolders, and whether to check the output integrity.
4. Click Start Decompression.

Input	Result
CISO/CSO (single or split)	the decompressed sector image
CCI (single or split)	the decompressed sector image
ZAR	the file tree repacked into an ISO (the xdvdfs tree hash is preserved; the sector layout may differ)
CHD (Xbox DVD)	the decompressed image copied to an ISO
GOD/SVOD	the mapped logical image copied to an ISO

Split sets are deleted as a whole when Delete Originals is enabled, so no orphaned continuation parts are left behind. For a GOD/SVOD source, the header and every DataNNNN fragment in the .data folder are removed together.

The Explorer Tab

The built-in Image Explorer lets you inspect the contents of an Xbox .iso, .xiso, .img, .cso, .cci, .zar, .chd or GOD/SVOD container, or an extensionless XBLA/XBLIG STFS package, without extraction. The right-hand panel shows title metadata (title name/ID, region, disc, version, publisher, developer, genre, description), container details (disc layout, XGD generation, codecs, parts, compression ratio, SHA-1), and renders the XBE logo/title/save images or the Xbox 360 XDBF thumbnail. See the dedicated XISO Explorer page for the full walkthrough.

The toolbar also provides:

• Extract all… — writes the whole image to a folder (safe name sanitizing, per-file error containment, optional skip-existing resume).
• Compute hashes — CRC-32, MD5, SHA-1, SHA-256, SHA3-256 and the xdvdfs-compatible sorted-path SHA3-256 tree hash, with a Copy button.
• Split… — splits the open plain ISO into sector-aligned parts for FAT32/FATX drives (4 GiB − 16 MiB per part).
• Join… — reassembles a split .1.iso/.2.iso set into a single ISO and audits the result.

---

Statistics Panel

The shared statistics panel at the bottom of the window is active during conversion and testing:

Field	Meaning
Total Files	Number of files discovered in the batch
Success	Files processed successfully
Failed	Files that could not be processed (reason logged)
Skipped	Files intentionally skipped (e.g., unsupported, encrypted archives, insufficient disk space)
Processing Time	Elapsed time for the current/last batch
Read Speed / Write Speed	Live throughput of the drives involved, with the drive letter as an indicator

The memory indicator shows the current process memory usage, which is useful when processing very large batches of large images.

---

Logging

Every operation is written to the in-application log pane. The log includes:

• File-by-file decisions (source, destination, engine output)
• Warnings for skipped files with clear reasons (disk space, FAT32 size limit, permissions, locked files)
• Retry attempts for transient failures (file locks, network errors)
• A final batch summary

When an unexpected error occurs, the application can send an automatic bug report (exception message and stack trace) to the developer. Environmental errors — such as full disks, network failures, or files held open by another process — are not reported as bugs; they are shown to you with actionable messages instead.

---

Practical Tips

• Test one file first when converting a new type of image, then run the whole batch.
• Keep 10–15% free space on the output drive; the application pre-checks free space but headroom avoids edge cases.
• Antivirus software can temporarily lock newly created files. The application waits and retries automatically, but real-time scanning of large ISO folders slows batches down — consider adding your working folders to the exclusion list.
• Network shares are fully supported (UNC paths and mapped drives). Wired connections reduce retry-related slowdowns.
• FAT32 output drives cannot hold files larger than 4 GB; the application detects this in advance and skips those files with a clear message. Use NTFS or exFAT for modern game images.