Wiimms ISO Tools

From Custom Mario Kart
Jump to navigation Jump to search
This article is about the software. For the user, see User:Wit.
Wiimms ISO Tools
Wiimms ISO Tools Logo.png
Author: Wiimm
Software Type: ISO and WBFS Manager
Current Version: v3.03a, 2020-08-03
Website: wit.wiimm.de


Wiimms ISO Tools is a set of four tools to manipulate ISO files and WBFS partitions. The tools are named:

  • wit : Wiimms ISO Tool (an ISO manipulating tool)
  • wwt : Wiimms WBFS Tool (an advanced WBFS Manager)
  • wfuse : A FUSE tool to mount ISO images and WBFS partitions (Windows not supported).
  • wdf : Pack, unpack and test WDF, WIA and CISO files.

The tools can handle the file formats .iso, .ciso, .wbi, .wdf, .wia, .wbfs and extracted files systems (FST). All tools are command line tools and run without any interaction. The main goal is to run them in batch files and scripts to automate recurring jobs. Wiimms ISO Patcher is an example for an automatic conversion.

The toolset is available for Linux, Mac and Windows.

Wiimms ISO Tools


There are several Graphical User Interfaces (GUI) for Wiimms ISO Tools:

This QT based GUI focuses on manipulating single ISO images. It can do much more and support also extraction and creation of ISO images.
Wii Backup Fusion (WiiBaFu)
This QT based GUI is a complete WBFS manager and ISO tool.

More GUIs

History and Download

Latest Change Log

wit v3.03a r8245 - 2020-08-03

 - Windows version only: Update to Cygwin DLL 3.0.7 / 2019-04-30.

 - wit COPY accepts patch options now.

 - Option --domain=DOMAIN: Bug fixed if DOMAIN contains exactly 16 characters.

 - Bug fix: Gamecube games are accessible again.

 - Bug fix for command wit CERT: Correct algorithm to verify signatures of
   type 'Elliptic Curve'.

wit v3.02a r7679 - 2018-11-23

 - Windows version only: Update to Cygwin 2.11.1.

 - Options --wiimmfi & --domain: Domain 'sake.gamespy.com' is replaced too,
   but only if the new domain is not longer than 11 characters. This is a
   special support for 'Super Smash Bros. Brawl'.

 - Option --dsync[=MODE] changed: --dsync accepts an optional parameter MODE
   now. If set, it one of OFF (disable), ON (enable) or AUTO (default). With
   AUTO, DSYNC is enabled if the progress counters are active. This option has
   only impact, if compiler and operation system support the flag O_DSYNC.
   Linux does.

 - Option --progress (-P) changed: Print progress counter. If --verbose is set
   at least twice, printing is enabled too. If progress is enabled, the
   default of --dsync is changed.

 - Some minor bug fixes.

wit v3.01a r7464 - 2017-12-03

 - New option: --dsync: The option enables the usage of flag O_DSYNC when
   opening a partition at a hard drive. With activated flag, writing an image
   is some percent slower, but the progress counters are exact again.


Extracting files

The wit tools are able to extract all or some files of any of a Wii ISO image. Use wwt (Wiimms WBFS Tool) to extract files from a disc inside a WBFS partition. Use wit (Wiimms ISO Tool) to extract files from any ISO image (file format .iso, .ciso, .wdf, .wia or .wbfs). Linux and Mac users can also use wfuse (Wiimms FUSE Tool) to mount an ISO image or a complete WBFS partition and to use any file browser to extract files.

wit example

Try the command:

wit extract mkw.iso --files=+/files/Race/Course --dest=tracks/ --flat

mkw.iso is the file name of your ISO image, all others must be entered literally. This command will extract all files of the ISO internal directory /files/Race/Course into the local sub directory tracks/. Most of this extracted files are Nintendos track files.

If you want to extract the whole DVD, just use:

wit extract mkw.iso --dest=mkw/

All files of all partitions (DATA, UPDATE and CHANNEL) including system files like main.dol are extracted into local sub directory mkw/. If you add the option --psel=data only the DATA partition is extracted.

Visit https://wit.wiimm.de/wit/extract for more details about the command "wit extract".

wfuse example

Try the command:

wfuse -c mkw.iso mkw-dir

mkw.iso is the file name of your ISO image and mkw-dir a temporary directory created by wfuse. If the mount is successful you can enter the directory mkw-dir with your favorite file browser. The tracks resides in ./mkw-dir/iso/part/data/files/Race/Course/. You can also mount a complete WBFS partition to browse all ISO images with all included files.

For unmounting use

wfuse -u mkw-dir

wfuse is not available for Windows because there is no Windows support for FUSE.

Image creation and Patching

The tools wit and wwt can not only extract some or all files of any Wii and GameCube image, it can also create images from scratch. It also replace the functionality of WiiScrubber to patch/modify images, but it goes an other non interactive way:

  1. Extract the images.
  2. Replace, remove and/or insert new files in the extracted file hierarchy.
  3. Create a new image.

Wiimms ISO Patcher use this method to patch fully automatically Wii images.

Use a copy of the original image of any file format (ISO, WBFS, ...). Extract it with:

wit extract <ORIGINAL_IMAGE> workdir.d

Now we have a working directory named workdir.d. Replace, add or delete any files with a file browser. If all is done, we create a new image:

wit copy workdir.d <NEWIMAGE> --id=<NEW_ID>

The file format is automatically chosen by analyzing the file extension. E.g name.wbfs will create a WBFS image and name.iso an ISO image. The optional option --id=NEW_ID defines a new ID for the new image. If not set, the original ID is used.

Self-compiling the tools

It's very easy to compile and install the tools by yourself.

The very first time, enter a directory (the parent directory) and make sure, that the sub-directory wiimms-iso-tools. Then execute the following commands:

svn co https://opensvn.wiimm.de/wii/trunk/wiimms-iso-tools
cd wiimms-iso-tools
make all titles
sudo make install
make clean

If you have checked out the distribution before, than enter the directory wiimms-iso-tools and execute the following commands.

svn update
make all titles
sudo make install
make clean