Wiimms ISO Tools

From Custom Mario Kart
(Redirected from Wit)
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.05a, 2022-08-27
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.05a r8638 - 2022-08-27

 - Mac support improved. Universal binaries for x86_64 and arm64.

 - New debug command for wit and wwt: ARGTEST: Print all scanned arguments as
   list. This helps to find out wrong parameters, especially for windows.

 - File ./sys/bi2.bin is optional now and will be created if missed.

 - File ./sys/bi2.bin offset 0x30 will be patched for a double layer image
   if the source was a single layer image.

 - Bug fix: Command wit edit --ios=NUMBER did not mark the image as modified,
   so the modified file was not written.

 - Bug fix: If only recursive sources (option --recurse) but no standard
   sources were specified, then "wit EXTRACT" was terminated prematurely.

 - Options --source=PATH and --recurse=PATH support now wildcards. In this
   case PATH is used as search pattern and all found files are added. In order
   to use this variant, the calling shell must not interpret the wildcards.
   Therefore, PATH must usually be enclosed in single or double quotes.

wit v3.04a r8427 - 2021-04-18

 - Windows only: 32 bit and 64 bit versions of Cygwin are supported now.
   The 64 bit version is recommended.
    - 32 bit version: Cygwin DLL 3.0.7 / 2019-04-30
    - 64 bit version: Cygwin DLL 3.1.7 / 2020-08-22

 - wit CERT: Management of certificates improved.

 - Patching domains: Added special string replacements for different game
   variants of "Call of Duty" and "Band Hero".

 - Patch option --wiimmfi supports the new patches required since March.

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'.


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. Just execute the following commands:

git clone https://github.com/Wiimm/wiimms-iso-tools
cd wiimms-iso-tools/project
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.

git pull
cd project
make all titles
sudo make install
make clean