Wiimms ISO Tools: Difference between revisions

From GameBrew
No edit summary
No edit summary
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{#seo:
|title=Wii Homebrew PC Tools (PC Utilities) - GameBrew
|title_mode=append
|image=wiimmsisotoolswii.jpg
|image_alt=Wiimms ISO Tools
}}
{{Infobox Wii Homebrews
{{Infobox Wii Homebrews
|title=Wiimms ISO Tools
|title=Wiimms ISO Tools
|image=wiimmsisotoolswii.jpg
|image=wiimmsisotools2.png
|description=This is the main ISO manipulation tool.
|description=A command line ISO+WBFS tool set for various OS.
|author=Wiimm
|author=Wiimm
|lastupdated=2022/08/27
|lastupdated=2022/08/27
|type=PC Utilities
|type=WBFS Managers
|version=3.05a
|version=3.05a
|license=GPL-2.0
|license=GPL-2.0
|download=https://dlhb.gamebrew.org/wiihomebrews/wiimmsisotoolswii.7z
|download=https://wit.wiimm.de/
|website=https://wit.wiimm.de
|website=https://wit.wiimm.de
|source=https://github.com/Wiimm/wiimms-iso-tools
|source=https://github.com/Wiimm/wiimms-iso-tools
}}
}}
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.
Wiimms ISO Tools is a set of [https://wit.wiimm.de/info/command-line.html command line] tools to manipulate Wii and GameCube ISO images and WBFS containers.  
 
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==
==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.
*Set of command line tools to manipulate Wii ISO images and WBFS files.
 
*wit (Wiimms ISO tool) - The main Wii and GameCube ISO manipulation tool.
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.
*wwt (Wiimms WBFS tool) - A complete WBFS manager including FS checking and repairing, time stamps and multi WBFS support.
 
*wdf (Wiimms WDF Tool) - A little tool to manage WDF, CISO and WIA files.
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.
*wfuse (Wiimms FUSE Tool) - Mount a Wii or GameCube image or a WBFS file or partition to a mount point using FUSE
 
* Supports 7 Wii disc file types (ISO, CISO, WDF, WIA, WBFS, GCZ and FST).
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."
* Verify and compare (diff) Wii and GameCube ISO images.
 
* Extract and compose Wii ISO images.
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.
* Patch Wii and GameCube ISO images while copying.
 
* Mix partitions from different sources into a new Wii ISO images.
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.
* Support many diagnostic commands (wit and wwt).
* Ignore and repair the used-block-table (wit and wwt).
* Advanced shell support.


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.
==User guide==
===Summary of tools===
[https://wit.wiimm.de/wit/ wit] (Wiimms ISO Tool):
*The main [https://wit.wiimm.de/info/iso-images.html 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.


"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.
[https://wit.wiimm.de/wwt/ wwt] (Wiimms WBFS Tool):
*The main [https://wit.wiimm.de/info/iso-images.html#wbfs 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.


"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.
[https://wit.wiimm.de/wdf/ wdf] (Wiimms WDF Tool):
*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.


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
[https://wit.wiimm.de/wfuse/ 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.


==Usage==
You can find a list of guide [https://wit.wiimm.de/info/ here].
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.
===Supported OS===
It is available for:
*Linux (i386, x86_64).
*Mac (universal binaries: ppc, i386 and x86_64)
*Windows (cygwin).


===Syntax===
===Graphical user interfaces (GUI)===
<pre>wit [option]... command [option|parameter|@file]...</pre>
*[https://code.google.com/archive/p/qtwitgui/ QtWitGui] - This QT based GUI focuses on manipulating single ISO images. It can do much more.
*[[Wii Backup Fusion]] - A WBFS and ISO manager. This QT based GUI is a complete WBFS manager and ISO tool.
*[[Witgui Wii|Witgui for Mac]] - A graphical user interface for wit available for Mac OS X. With Witgui you can manage your game collection with just a few clicks.


==Media==
==Media==
'''How To Rebuild Wii ISO's For Linterni-Gamer (LEGO Star Wars: The Complete Saga) - ([https://www.youtube.com/watch?v=gJhXSGQuCd4 The Proboscis Archive])'''<br>
'''How To Rebuild Wii ISO's For Linterni-Gamer (LEGO Star Wars: The Complete Saga) ([https://www.youtube.com/watch?v=gJhXSGQuCd4 The Proboscis Archive])'''<br>
<youtube>gJhXSGQuCd4</youtube>
<youtube>gJhXSGQuCd4</youtube>


==External Links==
==Changelog==
* Official Site - https://wit.wiimm.de/wit/
'''wit v3.05a r8638 2022/08/27'''
* Github - https://github.com/Wiimm/wiimms-iso-tools
*Mac support improved. Universal binaries for x86_64 and arm64.
* Gbatemp - https://gbatemp.net/threads/wwt-wit-wiimms-wbfs-iso-tools.182236/#entry2286365
*New debug command for wit and wwt: ARGTEST: Print all scanned arguments as list. This helps to find out wrong parameters, especially for windows.
* Gbatemp's Wiki - https://wiki.gbatemp.net/wiki/Wiimms_ISO_Tools
*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 website - https://wit.wiimm.de/
* GitHub - https://github.com/Wiimm/wiimms-iso-tools
* Wii-Homebrew - https://forum.wii-homebrew.com/index.php/Thread/14610-wit-wwt-Wiimms-ISO-WBFS-Tools/#post149775
* GBAtemp - https://gbatemp.net/threads/wwt-wit-wiimms-wbfs-iso-tools.182236/#entry2286365
* GBAtemp - https://wiki.gbatemp.net/wiki/Wiimms_ISO_Tools

Latest revision as of 01:53, 4 April 2023

Wiimms ISO Tools
Wiimmsisotools2.png
General
AuthorWiimm
TypeWBFS Managers
Version3.05a
LicenseGPL-2.0
Last Updated2022/08/27
Links
Download
Website
Source

Wiimms ISO Tools is a set of command line tools to manipulate Wii and GameCube ISO images and WBFS containers.

Features

  • Set of command line tools to manipulate Wii ISO images and WBFS files.
  • wit (Wiimms ISO tool) - The main Wii and GameCube ISO manipulation tool.
  • wwt (Wiimms WBFS tool) - A complete WBFS manager including FS checking and repairing, time stamps and multi WBFS support.
  • wdf (Wiimms WDF Tool) - A little tool to manage WDF, CISO and WIA files.
  • wfuse (Wiimms FUSE Tool) - Mount a Wii or GameCube image or a WBFS file or partition to a mount point using FUSE
  • Supports 7 Wii disc file types (ISO, CISO, WDF, WIA, WBFS, GCZ and FST).
  • Verify and compare (diff) Wii and GameCube ISO images.
  • Extract and compose Wii ISO images.
  • Patch Wii and GameCube ISO images while copying.
  • Mix partitions from different sources into a new Wii ISO images.
  • Support many diagnostic commands (wit and wwt).
  • Ignore and repair the used-block-table (wit and wwt).
  • Advanced shell support.

User guide

Summary of tools

wit (Wiimms ISO Tool):

  • 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):

  • 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):

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

You can find a list of guide here.

Supported OS

It is available for:

  • Linux (i386, x86_64).
  • Mac (universal binaries: ppc, i386 and x86_64)
  • Windows (cygwin).

Graphical user interfaces (GUI)

  • QtWitGui - This QT based GUI focuses on manipulating single ISO images. It can do much more.
  • Wii Backup Fusion - A WBFS and ISO manager. This QT based GUI is a complete WBFS manager and ISO tool.
  • Witgui for Mac - A graphical user interface for wit available for Mac OS X. With Witgui you can manage your game collection with just a few clicks.

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

Retrieved from ‘https://www.gamebrew.org/index.php?title=Wiimms_ISO_Tools&oldid=118792’

Advertising: