More actions
| Wiimms ISO Tools | |
|---|---|
| File:Wiimmsisotoolswii.jpg | |
| General | |
| Author | Wiimm |
| Type | PC Utilities |
| Version | 3.05a |
| License | GPL-2.0 |
| Last Updated | 2022/08/27 |
| Links | |
| Download | |
| Website | |
| Source | |
Wiimms ISO Tool is a versatile software that allows you to perform a variety of tasks with Wii and GameCube image files. It can list the contents of an image, analyze its structure, verify its integrity, convert it to other formats, split it into smaller parts, join multiple images together, patch errors, mix different images, extract files, compose new images, rename files, and compare images.
Additionally, Wiimms ISO Tool can also create and dump various other Wii file formats. This tool is a powerful solution for managing and manipulating Wii and GameCube game images on your computer.
Features
The Wiimms ISO Tool is a set of command-line tools that can be used to manipulate Wii ISO images and WBFS containers. All of the commands accept all known Wii ISO file formats as input, and if the source is a directory, all ISO images within that directory will be used as the source. The option --recurse and --rdepth can be used to search entire directory trees.
The wit COPY command will copy ISO images and set the destination file names using format strings. The WiiTDB is used to find locale disc names. The tool can also convert between different file formats such as ISO, WDF, WIA, CISO, WBFS, GCZ and FST on the fly, automatically detecting the source file format and joining split source files. The option --split and --split-size can be used to control the output file size.
Scrubbing is automatically done, but can be controlled by the options --psel and --raw. When copying, you can also patch the ID, disc title, IOS and region. Objects for patching include the disc header, ticket, TMD, and boot.bin. If necessary, the partitions will be fake signed (trucha sign) automatically.
The wit EDIT command will patch existing Wii disc images directly. wit COPY and other commands, as well as wwt ADD, compose extracted and modified file systems. While composing, you can patch ID, disc title, IOS and region. This functionality is also called Partition builder or Disc builder.
The wit MOVE command can be used to rename ISO images, including those within a whole directory tree using the --recurse option. The destination file names are set with format strings and the WiiTDB is used to find locale disc names.
The wit MIX command can create new Wii ISO images by taking partitions from any other and different valid Wii discs. Fake signing is not necessary because partitions are copied 1:1. The --overlay option can be used to reduce the total size of the new disc image.
The wit VERIFY command verifies ISO images and finds bad dumps by calculating the SHA1 checksums and comparing them with the stored checksums. The wit FILETYPE command will identify files and find ISO images. wit LIST will list all ISO images in a table, with options such as --long, --no-header, --sections and more to control formatting.
wit FILES will list all virtual and real files of Wii disc. The output can be filtered with the powerful option --files. Options such as --long, --no-header, --sections and more control the formatting. 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 --files option is set, the diff works on the 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, which is useful for analysis.
For all commands working with Wii ISO images, the options --include, --include-path, --exclude, and --exclude-path can be used to set up filters to decide which ISO images are used for the operation. The options --quiet and --verbose can be used to control the verbosity, with both.
Tools Overview
wit (Wiimms ISO Tool):
This is the primary ISO manipulation tool, capable of performing various actions such as listing, analyzing, verifying, converting, splitting, joining, patching, mixing, extracting, composing, renaming, and comparing Wii and GameCube images. It can also create and dump various other Wii file formats.
wwt (Wiimms WBFS Tool):
The main WBFS manipulation tool (WBFS Manager), it allows you to create, check, repair, verify, and clone WBFS files and partitions. You can also list, add, extract, remove, rename, and recover ISO images as part of a WBFS.
wdf (Wiimms WDF Tool):
wdf is a supporting tool for WDF, WIA, CISO, and GCZ images. It converts (packs and unpacks), compares, and dumps WDF and CISO images, and also dumps WIA and GCT images while unpacking WIA images. The default command is dependent on the program file name, and common names include 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" replaces the old tool wdf-dump.
wfuse (Wiimms FUSE Tool):
wfuse enables you to mount a Wii or GameCube image, WBFS file, or partition to a mount point using FUSE (Filesystem in USErspace). To unmount, use 'wfuse --umount mountdir'.
Usage
Wiimms ISO Tool is a set of command-line tools that can be used to manipulate Wii ISO images and WBFS containers. To use these tools, you will need to open a text console, such as the Command Prompt on Windows, and enter the appropriate commands. An alternative method is to create small scripts, such as batch or command files, that run the tools with the necessary options and parameters.
When using the WBFS manager tool (wwt), it is necessary to run it in root or admin mode if you want to manage WBFS partitions on hard drives. On Unix systems, this can be done by using the su or sudo command. Windows users should open an administrative console to run the tool.
A collection of guides have been written and are available here.
Syntax
wit [option]... command [option|parameter|@file]...
Media
How To Rebuild Wii ISO's For Linterni-Gamer (LEGO Star Wars: The Complete Saga) - (The Proboscis Archive)
Changelog
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.
External Links
- Official Site - https://wit.wiimm.de/
- Github - https://github.com/Wiimm/wiimms-iso-tools
- Gbatemp - https://gbatemp.net/threads/wwt-wit-wiimms-wbfs-iso-tools.182236/#entry2286365
- Gbatemp's Wiki - https://wiki.gbatemp.net/wiki/Wiimms_ISO_Tools