Difference between revisions of "Wiimms ISO Tools"

From Custom Mario Kart
Jump to navigation Jump to search
(Update to v2.40a)
(update to v3.00a)
Line 13: Line 13:
 
|-
 
|-
 
! Current Version:
 
! Current Version:
| v2.40a, 2017-01-05
+
| v3.00a, 2017-08-13
 
|-
 
|-
 
! Website:
 
! Website:
| [http://wit.wiimm.de/ wit.wiimm.de]
+
| [https://wit.wiimm.de/ wit.wiimm.de]
 
|}
 
|}
  
Line 30: Line 30:
 
The toolset is available for Linux, Mac and Windows.
 
The toolset is available for Linux, Mac and Windows.
  
→ [http://wit.wiimm.de/ Wiimms ISO Tools]
+
→ [https://wit.wiimm.de/ Wiimms ISO Tools]
  
 
== GUI ==
 
== GUI ==
  
 
There are several Graphical User Interfaces (GUI) for Wiimms ISO Tools:
 
There are several Graphical User Interfaces (GUI) for Wiimms ISO Tools:
; [http://wit.wiimm.de/r/qtwitgui QtWitGui] : This QT based GUI focuses on manipulating single ISO images. It can do much more and support also extraction and creation of ISO images.
+
; [https://wit.wiimm.de/r/qtwitgui QtWitGui] : This QT based GUI focuses on manipulating single ISO images. It can do much more and support also extraction and creation of ISO images.
; [http://wit.wiimm.de/r/wiibafu Wii Backup Fusion (WiiBaFu)] : This QT based GUI is a complete WBFS manager and ISO tool.
+
; [https://wit.wiimm.de/r/wiibafu Wii Backup Fusion (WiiBaFu)] : This QT based GUI is a complete WBFS manager and ISO tool.
  
→ [http://wit.wiimm.de/#gui More GUIs]
+
→ [https://wit.wiimm.de/#gui More GUIs]
  
 
== Extracting files ==
 
== Extracting files ==
  
The wit tools are able to extract all or some files of any of a Wii ISO image. Use [http://wit.wiimm.de/wwt wwt] (Wiimms WBFS Tool) to extract files from a disc inside a WBFS partition. Use [http://wit.wiimm.de/wit 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 [http://wit.wiimm.de/wfuse wfuse] (Wiimms [http://fuse.sourceforge.net/ FUSE] Tool) to mount an ISO image or a complete WBFS partition and to use any file browser to extract files.
+
The wit tools are able to extract all or some files of any of a Wii ISO image. Use [https://wit.wiimm.de/wwt wwt] (Wiimms WBFS Tool) to extract files from a disc inside a WBFS partition. Use [https://wit.wiimm.de/wit 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 [https://wit.wiimm.de/wfuse wfuse] (Wiimms [http://fuse.sourceforge.net/ FUSE] Tool) to mount an ISO image or a complete WBFS partition and to use any file browser to extract files.
  
 
=== wit example ===
 
=== wit example ===
Line 54: Line 54:
 
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.
 
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 http://wit.wiimm.de/wit/extract for more details about the command "wit extract".
+
Visit https://wit.wiimm.de/wit/extract for more details about the command "wit extract".
  
 
=== wfuse example ===
 
=== wfuse example ===
Line 88: Line 88:
 
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:
 
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:
 
<pre>
 
<pre>
svn co http://opensvn.wiimm.de/wii/trunk/wiimms-iso-tools
+
svn co https://opensvn.wiimm.de/wii/trunk/wiimms-iso-tools
 
cd wiimms-iso-tools
 
cd wiimms-iso-tools
 
make all titles
 
make all titles

Revision as of 14:06, 13 August 2017

Wiimms ISO Tools
File:Wiimms-ISO-Tools.png
Author: Wiimm
Software Type: ISO and WBFS Manager
File Formats: ISO, CISO, WBI, WBFS, WDF, WIA, GCZ, FST
Current Version: v3.00a, 2017-08-13
Website: wit.wiimm.de

Introduction

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

GUI

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

QtWitGui
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

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

Links