» WIT: Wiimms ISO Tools » WIT Features

# WIT Features

## 1. WIT (Wiimms ISO Toolset) is a set of command line tools.

Wiimms ISO Tools is a set of command line tools to manipulate Wii and GameCube ISO images and WBFS containers. Command line means that you have to open a text console (cmd for windows) to execute the commands. An other way is to write little scripts (windows: *.bat or *.cmd files) that call wit and wwt with all needed options and parameters.

If you work with wwt (the WBFS manager) and want to manage WBFS partitions on hard drives then the tool must run in root/admin mode. Use su or sudo for unix systems. Windows users should open an administration console.

### 1.1 Summary of tools

- wit (Wiimms ISO Tool):

  This is the main ISO manipulation tool : It can list, analyze, verify, convert, split, join, patch, mix, extract, compose, rename and compare Wii and GameCube images. It also can create and dump different other Wii file formats.

- wwt (Wiimms WBFS Tool):

  This is the main WBFS manipulation tool (WBFS manager) : It can create, check, repair, verify and clone WBFS files and partitions. It can list, add, extract, remove, rename and recover ISO images as part of a WBFS.

- wdf (Wiimms WDF Tool):

  wdf is a support tool for WDF, WIA, CISO and GCZ images. It converts (packs and unpacks), compares and dumps WDF and CISO images. Additionally it dumps WIA and GCT image and unpacks WIA images. The default command depends on the program file name (see command descriptions). Usual names are wdf, unwdf, wdf-cat, wdf-cmp and wdf-dump (with or without minus signs). »wdf +CAT« replaces the old tool wdf-cat and »wdf +DUMP« the old tool wdf-dump.

- wfuse (Wiimms FUSE Tool):

  Mount a Wii or GameCube image or a WBFS file or partition to a mount point using FUSE (Filesystem in USErspace). Use 'wfuse --umount mountdir' for unmounting.

## 2. wit (Wiimms ISO tool) is the main Wii and GameCube ISO manipulation tool.

wit is the main Wii and GameCube ISO disc manipulation tool:

- All commands accept all known Wii ISO file formats as input. If the source is a directory, all ISO images of that directory are used as source. Use the option --recurse and --rdepth to search whole directory trees.
- »wit COPY« will copy ISO images. The destination file names are set with format strings. WiiTDB is used to find locale disc names.

  Converting from/to ISO, WDF, WIA, CISO, WBFS, GCZ and FST is done on the fly. The source file format is detected automatically and split source files are joined together. Output files can be split controlled by the options --split and --split-size.

  Scrubbing is done automatically. It can be controlled by the options --psel and --raw.

  While copying you can patch ID, disc title, IOS and region. Objects for patching are disc header, ticket, tmd and boot.bin. If necessary the partitions will be fake signed (trucha sign) automatically.

- »wit EDIT« will patch existing Wii disc images directly.
- »wit COPY« (and other commands and »wwt ADD«) compose extracted and modified files systems. While composing you can patch ID, disc title, IOS and region. This functionality is also called »Partition builder« or »Disc builder«.
- »wit MOVE« can rename ISO images (with --recurse of a whole directory tree). The destination file names are set with format strings. WiiTDB is used to find locale disc names.
- »wit MIX« can create a new Wii ISO images. It takes the partitions from any other and different valid Wii discs. Fake signing is not necessary because partitions are copied 1:1. With the option --overlay partitions will be overlayed to reduce the total size of the new disc image.
- »wit VERIFY« verifies ISO images and find bad dumps. This is done by calculating the SHA1 checksums and comparing them with the stored checksums.
- »wit FILETYPE« will identfy files and find ISO images.
- »wit LIST« will list all ISO images as a table. Options like --long, --no-header, --sections and more control the formating. Try the abbreviations »wit LS«, »wwt LL« or »wwt LLL«.
- »wit FILES« will list all virtual and real files of Wii disc. The output can be filtered with the powerful option --files. Options like --long, --no-header, --sections and more control the formating. Try the abbreviations »wit IL«, »wwt ILL« or »wwt ILLL«.
- »wit EXTRACT« (and »wit COPY --fst«) will extract all virtual and real files of Wii disc. The output can be filtered with the powerful option --files.
- »wit DIFF« compares pairs of ISO images in scrubbed or raw mode. If the option --files is set the the diff works on file level.
- »wit DUMP« will print the data structures and information of ISO images and other files like ticket.bin, tmd.bin, header.bin, boot.bin, fst.bin and of dol-files. This is good for analysis.
- For all commands working with Wii ISO images the options --include, --include-path, --exclude and --exclude-path setup up filters to decide which ISO images are used for the operation.
- The options --quiet and --verbose control the verbosity. Both option can be set multiple times to decrease or increase the verbosity.

## 3. wwt (Wiimms WBFS tool) is a complete WBFS manager including FS checking and repairing, time stamps and multi WBFS support.

wwt is a complete WBFS manager:

- wwt can work with WBFS drives and partitions and with WBFS files. When creating plain WBFS files the tools try to create sparse files to reduce disk usage. Most commands accept multiple working WBFS to add, modify or extract more than one WBFS with one command.
- The working WBFS are defined by the options -part, --auto and --all. The option @--auto scanns all drives for valid WBFS partitionss.
- »wwt FORMAT« will format a WBFS partition or file. Together with option --recover it try to recover an already existing WBFS.
- »wwt LIST« list the discs of one ore more WBFS as a text table. Options like --long, --mixed, --unique, --no-header, --sections and more control the formating.

  Try the abbreviations »wwt LS«, »wwt LL«, »wwt LLL« or »wwt LM«.

- »wwt ADD« will add Wii discs in any file formats to one or more working WBFS. The options --update, --newer, --sync --ignore and many more controls the operation. Cloning of WBFS is done with this command too.

  »wwt ADD« can also read from extracted file system to compose a disc on the fly (like »wit COPY«). This functionality is also called »Partition builder« or »Disc builder«.

  While adding a disc you can patch ID, disc title, IOS and region. Objects for patching are disc header, ticket, tmd and boot.bin. If necessary the partitions will be fake signed (trucha sign) automatically.

- »wwt UPDATE« is a shortcut for »wwt ADD --update« and »wwt SYNC« for »wwt ADD --sync«.
- »wwt EXTRACT« will extract Wii discs and copy them to files in any file formats. If more then one working WBFS is set, each ISO image is searched in all working WBFS until found.
- »wwt REMOVE« will remove Wii discs from all working WBFS.
- »wwt VERIFY« verifies all ISO images of all working WBFS to find bad dumps. This is done by calculating the SHA1 checksums and comparing them with the stored checksums.
- The commands »wwt ANALYSE«, »wwt CHECK«, »wwt REPAIR« and »wwt RECOVER« can be used for analyzing, checking and repairing WBFS.
- »wwt CHECK« check the WBFS for different kinds of allocation errors. This check ist very fast (less than 1 second). All commands, which will modify the WBFS, do a silent check and report, if harmless errors found, or stop execution, if harmful errors found.
- »wwt DUMP« will print the data structures and information of WBFS partitionss and files. This is good for analysis.
- wwt (and also wit) supports time stamps for discs in WBFS containers like other file systems.
- For all commands working with Wii ISO images the options --include, --include-path, --exclude and --exclude-path setup up filters to decide which ISO images are used for the operation.
- The options --quiet and --verbose control the verbosity. Both option can be set multiple times to decrease or increase the verbosity.

## 4. wdf (Wiimms WDF Tool) is a little tool to manage WDF, CISO and WIA files.

## 5. WIT supports 7 Wii disc file types (ISO, CISO, WDF, WIA, WBFS, GCZ and FST).

When reading an ISO image all tools look inside the file to detect the file type. The file name does not matter. The usage is transparent for the commands, 6 file types are supported yet:

1. Plain ISO: Normal (and large) Wii or GameCube ISO image.
2. WDF: A special file format which manage wholes (scrubbed areas). Only non zero data is stored.
3. WIA: A special archive format to reduce the needed disc space. It is simmilar like WDF but it compress data in chunks with the bzip2 or lzma algorithm.
4. CISO: Like WDF, but not so effective. A advantage is that CISO files are loadable by some USB loaders.
5. WBFS: Single disc in a WBFS container. I is also possible to select one disc of a WBFS by using a selector.
6. GCZ: Dolphins GameCube-Zip format.
7. FST: Extracted file system (see below).

When writing to a Wii or GameCube ISO file the user has the choice between all file formats. He can force a output file format by using one of the options --wdf, --wia, --ico, --ciso, --wbfs, --gcz or --fst. If no option is set, the tools analyze the file extension to find the file type. For example name.iso will force a Plain ISO file while name.wdf will force WDF.

When reading Wii or GameCube ISO files split files are detected automatically. When writing files splitting can be controlled with the options --split and --split-size.

## 6. wit can verify and compare (diff) Wii and GameCube ISO images.

»wit DIFF« can compare Wii and GameCube ISO images of all supported file formats in in raw mode (whole ISO image) and in scrubbed mode (only needed sectors) or on file level.

»wit VERIFY« and »wwt VERIFY« verify Wii (but not GameCube) ISO images and find bad dumps. This is done by calculating the SHA1 checksums and comparing them with the stored checksums.

## 7. wit can extract and compose Wii ISO images.

»wit EXTRACT« (and »wit COPY --fst« as wrapper) can extract all virtual and real files of all partitions of Wii discs. This acts like the old WiiScrubber, but in a non interactive way.

The user can modify and exchange all files with any tools and editors.

Commands like »wit COPY« or »wwt ADD« can compose a new Wii ISO disc: Just define the base directory of a FST as source file. This functionality is also called »Partition builder« or »Disc builder«.

## 8. wit can patch Wii and GameCube ISO images while copying.

»wit COPY«, »wwt ADD« and other copy commands can patch the a Wii or GameCube ISO image while copying it.

Subjects of patching are ID (--id; disc header, ticket, tmd and boot.bin), disc title (--name; disc header and boot.bin), region info (--region; disc header) and the IOS (--ios; tmd). If necessary the partitions will be fake signed (trucha sign) automatically.

Removing (--rm-files), zeroing (--zero-files) and ignoring (--ignore-files) files are also posible.

TICKET and TMD are automatically fake signed if necessary.

## 9. wit can mix partitions from different sources into a new Wii ISO images.

The command »wit MIX« can mix different partitions of different Wii discs into a new Wii disc image. The MIX command copies the partitions 1:1 so that there is no need to fake sign the partitions; the original sign of the source is unchanged.

»wit MIX« has an unique feature: OVERLAY
If option --overlay is set then »wit MIX« tries to overlay the partitions to minimze the total image size. This works because most partitions have unused areas.

## 10. wit and wwt support many diagnostic commands.

Both main tools, wit and wwt, support many diagnostic commands, for example: »wit FILETYPE«, »wit DUMP«, »wit VERIFY«, »wwt FILETYPE«, »wwt DUMP«, »wwt ANALYZE«, »wwt CHECK« and »wwt VERIFY«.

## 11. wit and wwt ignore and repair the used-block-table.

wit and wwt ignore the used-block-table completely on reading and scans the map lists of the games to create an internal usage map. On writing a new repaired used-block-table is written.

So a damaged used-block-table has no impact to the tools and is repaired automatically.

## 12. Advanced shell support.

All tools are designed to support scripting:

- Exit codes are explained by the commands »wit ERROR« and »wwt ERROR«.
- The options --quiet and --verbose control the verbosity level.
- Many commands may produce machine readable output. The option --sections enables a special machine readable output format.
- The tools can read parameters from files.
- Different environment variables are supported.