Skip to content

SaveEditors/Xtaf-CLI

Repository files navigation

Xtaf-CLI (Xtaf v1.0)

Xtaf is a Windows CLI for Xbox 360 image mounting, recovery, and size tooling.

Support Xtaf-CLI on Ko-fi

About

The installed terminal command is xtaf.

Xtaf-CLI is a focused Xbox 360 filesystem utility intended for automation and integration workflows (including xecli). It provides partition-aware mounting, recovery/carving workflows, and image-size reduction tooling for FATX-based storage images.

Scope

  • Xbox 360 only.
  • FATX, STFS (CON / LIVE / PIRS), and GDFX (XISO) handling.
  • Partition-aware mount flow plus custom-volume flow for non-standard images.

Quick Start

  1. Install WinFsp on Windows.
  2. Use .NET Framework 4.5.2 (or newer compatible runtime).
  3. Run:
xtaf -i "D:\images\hdd.img" --list-partitions
xtaf -i "D:\images\hdd.img" --partition content -m X:

Core Features

  • Mount one partition or all partitions.
  • Diskpart-style helper (--diskpart).
  • Recovery pipeline:
    • metadata scan
    • deleted file recovery
    • signature carving
    • cross-reference CSV linking recovered/carved artifacts by probable directory groups
  • Image size tools:
    • trailing-zero audit
    • trimmed copy creation
  • Custom volume tools:
    • explicit --volume-offset / --volume-length targeting
    • FATX used/free stats
    • direct volume extraction for smaller standalone images

Build

dotnet build .\Xtaf.sln -c Release

Usage

xtaf -i <ImagePath> [mount|recovery|size options]

For full command list and examples, see COMMAND_GUIDE.md.

Output Conventions

  • Recovery output contains:
    • metadata_scan.csv
    • carve_scan.csv (if carving enabled)
    • cross_reference.csv
    • grouped metadata_recovered\...
    • grouped carved_files\...
  • Exit codes:
    • 0 success
    • 1 runtime failure
    • 2 CLI usage error

XeCLI Integration

Fully integrated in XeCLI.

About

Xbox 360 image CLI for FATX/STFS/GDFX mount, recovery, and volume tooling.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages