x1nixmzeng / xbox-iso-vfs

Mount Xbox ISO files on Windows

xbox-iso-vfs

xbox-iso-vfs is a utility to mount Xbox ISO files as a file system on Windows

Note that the Dokan library is required for the kernel model file system driver. For more information on Dokan and how it works, click here.

Once mounted, the files can be

• Used natively by emulators (such as Cxbx-Reloaded)
• Used to view or extract files using Windows Explorer

Usage

xbox-iso-vfs.exe [/d|/l] <iso_file> <mount_path>
  /d           Display debug Dokan output in console window
  /l           Open Windows Explorer to the mount path
  <iso_file>   Path to the Xbox ISO file to mount
  <mount_path> Driver letter ("M:\") or folder path on NTFS partition
  /h           Show usage

Unmount with CTRL + C in the console or alternatively via "dokanctl /u mount_path".

Installation

1. Download Dokan v2 - x64/x86 or all releases
2. Run the Dokan installer
3. Download xbox-iso-vfs - latest version

History

• Mar 2022 - Upgraded Dokan from v1.4 to v2.0 to match new API and improvements
• Jan 2021 - Initial version

Similar Projects

The idea of an ISO file system in userspace (FUSE) is not new, even for the Xbox community

• xbfuse does exactly the same thing on Linux

There are also various other utilities extract ISO files

• extract-xiso
• xbiso
• zef-xiso-convert

Others apps (closed source)

• Qwix
• XDVDMulleter

Thanks

The implementation of xdvdfs was taken from xbiso

xbox-iso-vfs's Issues

Virus in release?

Hello, I tried to download the latest release and it said that it had Script/Wacatac.B!ml trojan in the zip file.

trying to mount a file that for some reason fails to mount shows no error

Attempting to mount a image that has a issue keeping it from mounting doesn't print anything to the user to say as such. Currently, it just drops back to the prompt after a bit of loading

/d /h options do not function

Using the /d or /h options do not print anything to the current console and doesn't open any new console windows that I can find

No exit after mounting

Hello,

I'm using xbox-iso-vfs in a python app with PyQt6 Qprocess (think python subprocess, just for QT GUI) and when running xbox-iso-vfs I'm able to mount the xiso fine through my program, via your program & Dokan, but it doesn't seem to exit once mounted, so the next process in the queue isn't running thereafter (and the process after that, to manually unmount, isn't either.)

I don't need a full exit (or for it to unmount), as I want it to stay mounted until I'm done working with it, but I do need it to send some sort of exit or complete signal, this so the next process in the queue can proceed. Then I'll unmount manually using the command: dokanctl /u some/path/to/iso etc.

That said, do you happen to know if this is an xbox-iso-vfs issue or a Dokan (Dokan FUSE?) issue?

Possible to add option to control file caching?

Would it be possible to add a option to control how the iso file is cached? Currently it seems the program loads the file on the fly as its needed, unless im wrong. I keep all of my bulk storage on a network drive and whole file caching might be useful if possible