Original Xbox FATX Filesystem Library, Python bindings, FUSE driver, and GUI explorer.
- libfatx is a C library for working with the FATX filesystem, a variant of FAT16/32 developed by Microsoft for the original Xbox console.
- fatxfs is a FUSE driver built using libfatx.
- pyfatx is a Python module providing bindings to libfatx.
- gfatx is a graphical utility for working with FATX disk images, built around libfatx.
libfatx provides both read and write access to FATX filesystems, and formatting disks. Large disks are supported via F partition.
A FUSE userspace filesystem driver built using libfatx that enables you to mount a FATX filesystem on your host system and interact with it using your typical system tools. Works on Linux and macOS. Other platform support is possible, but untested.
fatxfs can be easily built inside a Docker container. If you use this method, you can skip the prerequisites and build instructions below.
$ git clone https://github.com/mborgerson/fatx
$ docker build -t fatxfs .
$ docker run -it --rm -v $PWD:/work -w /work --device /dev/fuse --privileged fatxfs
# mkdir c
# fatxfs xbox.img c
# ls c
Assuming you already have typical build tools installed, install FUSE and CMake:
$ sudo apt-get install libfuse-dev cmake pkg-config
Download Xcode (available from the App Store) to get command line tools.
Assuming you have homebrew installed, install pkgconfig
and cmake
:
$ brew install pkgconfig cmake macfuse
Clone the repository:
$ git clone https://github.com/mborgerson/fatx && cd fatx
Create a build directory and run cmake
to construct the Makefiles:
$ mkdir build && cd build
$ cmake ..
Finally, start the build:
$ make
Firstly, you will need a raw disk image or block device to mount. Then, you can simply create a mountpoint and mount the "C drive" (default behavior). For example:
$ cd fatxfs
$ mkdir c_drive
$ ./fatxfs /dev/nbd0 c_drive
$ ls c_drive
You can specify the drive letter of the partition to mount:
$ ./fatxfs /dev/nbd0 e_drive --drive=e
Or, you can specify the offset and size of the partition manually:
$ ./fatxfs /dev/nbd0 c_drive --offset=0x8ca80000 --size=0x01f400000
If your disk image is a qcow image, you can mount it as a network block device before mounting a partition on the device:
$ sudo apt-get install qemu-utils
$ sudo modprobe nbd max_part=8
$ sudo qemu-nbd --connect=/dev/nbd0 /path/to/your/image.qcow2
$ sudo chmod a rwx /dev/nbd0
Unfortunately, on macOS, there is not a way to mount a qcow image like this (AFAIK). I recommend converting the qcow image to a raw disk image.
$ qemu-img convert /path/to/image.qcow /path/to/output.raw
For debug purposes, you can have fatxfs
log operations to a file given by the
--log
option. You can control the amount of output using the --loglevel
option.
A Python module providing bindings to libfatx. Wheels are provided for Windows and Linux.
The latest release of pyfatx can be installed via:
pip install pyfatx
You can install the latest version from source with:
pip install git https://github.com/mborgerson/fatx
pyfatx provides a module with some helpful utilities, like listing drive contents and extracting a filesystem, e.g. a filesystem can be extracted with:
python -m pyfatx -x ./path/to/disk.img
A graphical utility for working with FATX disk images, built around libfatx.
Note: This tool is in a very early state, and only has the functionality to browse filesystems in a disk at the moment.
sudo apt install qt5-default
cd /path/to/fatx
mkdir build
cd build
cmake ..
make gfatx
- Install Visual Studio 2019 Community
- Install Qt 5.15.2. I recommend using the Qt open source online installer.
- From Start menu, launch a "Qt 5.15.2 MSVC 2019" command prompt
"C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars32.bat" amd64
cd C:\path\to\fatx
mkdir build
cd build
cmake ..
cmake --build . --target gfatx
brew install pkgconfig qt@5
export PATH="/usr/local/opt/qt@5/bin:$PATH"
export LDFLAGS="-L/usr/local/opt/qt@5/lib"
export CPPFLAGS="-I/usr/local/opt/qt@5/include"
export PKG_CONFIG_PATH="/usr/local/opt/qt@5/lib/pkgconfig"
cd /path/to/fatx
mkdir build
cd build
cmake --build . --target gfatx
Copyright (C) 2015 Matt Borgerson
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
This project was made possible in part by the research done by Andrew de Quincey, Lucien Murray-Pitts, and Michael Steil. Thank you!