https://github.com/multimediamike/xbfuse

Mount Xbox and Xbox 360 disk images via FUSE
https://github.com/multimediamike/xbfuse

c fuse-filesystem xbox

Last synced: 3 months ago
JSON representation

Mount Xbox and Xbox 360 disk images via FUSE

• Host: GitHub
• URL: https://github.com/multimediamike/xbfuse
• Owner: multimediamike
• License: gpl-2.0
• Created: 2012-02-12T01:39:19.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2023-10-30T14:18:06.000Z (about 1 year ago)
• Last Synced: 2024-06-25T11:40:27.110Z (5 months ago)
• Topics: c, fuse-filesystem, xbox
• Language: C
• Homepage: http://multimedia.cx/xbfuse/
• Size: 42 KB
• Stars: 71
• Watchers: 9
• Forks: 11
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog
  • License: COPYING

Awesome Lists containing this project

README

        
# xbfuse - Use FUSE To Mount (Original) Xbox and Xbox 360 DVD Filesystems

xbfuse is a program that allows you to mount the filesystem of a 

Microsoft Xbox or Xbox 360 DVD as a read-only part of the Linux 

filesystem. This allows the user to browse the directory structure and 

read the files within. 

xbfuse is made possible with Filesystem in Userspace (FUSE), available 

at:

  https://github.com/libfuse/libfuse

Note that it is not usually possible to simply read an Xbox/360 DVD in

an ordinary computer's DVD-ROM drive. The optical drives in Microsoft 

consoles have special firmware which allows them to access areas of the 

disc that are effectively invisible to most DVD-ROM drives. In order to 

mount a filesystem, generally, you will have to rip the proper 

sector image from the disc using special hardware and tools, or contact 

another source who has already done so.

Note also that there are likely to be bugs and perhaps even security 

problems. xbfuse is currently meant as primarily an experimental 

research tool for studying Microsoft Xbox/360 discs.

### Requirements:

- Linux 2.4.x or 2.6.x (as of 2.6.14 FUSE is part of the kernel, but you still need user libraries)

- FUSE (https://github.com/libfuse/libfuse) 2.5.x or higher

- FUSE development libraries; 'libfuse-dev' on Ubuntu distros

### Build:

After cloning this git repo, perform the standard development steps for building an autotool'd project:

    ./autogen.sh

    ./configure

    make

### Install:

    make install

### Usage:

The basic usage is to supply an Xbox/360 DVD image and an empty mount point on the filesystem:

    xbfuse  

To unmount a previously mounted filesystem image, use `fusermount`:

    fusermount -u 

To debug, or investigate how xbfuse examines the filesystem:

    xbfuse   -d

To export the absolute file offsets via a file's stat structure's inode field, specify the "-o use_ino" option. For example:

    xbfuse xbox-game.image-file /path/to/mountpoint -o use_ino

    stat --printf='offset: %i\nsize: %s\n' /path/to/mountpoint/default.xbe

This `stat` command will print the absolute offset and size of the default.xbe

file at the root of the filesystem.

### References:

This program was made possible through the information found in

[this XDVDFS document](https://multimedia.cx/xdvdfs.html).