wiifuse allows you to mount a Gamecube or Wii DVD disc image as a read-only part of the file system on you computer. This allows users to browse the directory structure and read the files within.
In contrast to the Gamecube, Wii images have multiple partitions. These are encrypted and wiifuse supports on-the-fly decryption - provided you have the required 128bit AES key.
Further, wiifuse provides access to special data found on these discs. Among others, this includes the main executable and informational things like the game's name.
Starting with version v0.2.0, you can also remotely mount your Wii nand filesystem with wiifuse_server and a usbgecko adapter.
To build wiifuse, you will need a working compiler and the development packages for the required libraries; have a look at the OS-specific notes.
The archive includes a Makefile, so just run
wiifuse v0.2.0 coded by dhewg, #wiidev efnet/blitzed usage: ./wiifuse [-v] <image file> <mount point> [<FUSE options>] or ./wiifuse [-v] -i <identity> <tty device> <mount_point> [<FUSE options>]
- Increase the verbose level with multiple -v arguments (up to three)
-ffor debug messages (process won't daemonize).
-o allow_otherto let other users access the mount point.
-hfor common FUSE library options.
- Use fusermount -u <mount_point> to unmount a previously mounted image.
$ ./wiifuse ~/zelda_tp.iso ~/wii_image -o allow_other $ ls -l ~/wii_image total 0 lrwxrwxrwx 1 dhewg 1 Mar 15 2007 data -> partition2 dr-xr-xr-x 4 dhewg 0 Mar 15 2007 partition0 dr-xr-xr-x 6 dhewg 0 Mar 15 2007 partition1 dr-xr-xr-x 6 dhewg 0 Mar 15 2007 partition2 lrwxrwxrwx 1 dhewg 1 Mar 15 2007 update -> partition1 $ cat ~/wii_image/data/header/name The Legend of Zelda Twilight Princess $ mplayer ~/wii_image/data/fs/Movie/demo_movie98_00.thp $ fusermount -u ~/wii_image
- Check if the FUSE kernel module is loaded:
- linux: lsmod | grep fuse
- freebsd: kldstat | grep fuse
- OS X: kextstat | grep fuse
- Verify your key file, the MD5-sum of the 16 byte file (without line feed) currently is 8d1a2ebcd82a3469b77facf15d9c8e50.
Debian / Ubuntu
To install the binaries provided below, do the following:
dpkg -i wiifuse_0.2.0-wip1-1_i386.deb
To build wiifuse you need to fetch these required packages:
apt-get install build-essential fuse-utils libfuse-dev libssl-dev
To mount an image without root privileges, add the user to the
adduser dhewg fuse
Install the required ports:
Further docs can be found here.
Binary for Debian unstable (and probably latest Ubuntu as well):
- completely revamped wiifuse_server, check its page for details
- new client/server mode. requires an usb gecko and wiifuse server running on a gamecube or wii in gc mode - for now ;)
- new metadata: title id symlinks, tmd infos
- added more disc id's
- support for virtual console partitions (found 14 vc games on brawl)
- stat compliant - `du` works now
- statvfs compliant - `df` works now
- minor cleanups and fixes
- fixed some serious u64 offset bugs
- corrected the main.dol size calculation
- some easy partition validation
- support for symlinks
- cleaned up and extended the available metadata
- Based on gcfuse code
- Copyright (C) 2006 Mike Melanson (mike at multimedia.cx)
- Copyright (C) 2005 Janusz Dziemidowicz (rraptorr at nails.eu.org)