WBFS2FAT Wii: Difference between revisions

WBFS2FAT
WBFS2FAT
General
Author	PsyBlade
Type	WBFS Managers
Version	0.9.0 beta2
License	Mixed
Last Updated	2013/01/26
Links
	Download
	Website

Latest revision as of 12:12, 4 Haziran 2024

WBFS2FAT is a tool that transforms a hard drive from WBFS to FAT32, enabling access to the drive without requiring a backup manager and allowing the drive to be repurposed for other functions. All games are preserved during the process. An alternative Python version for other operating systems is also provided.

The homebrew was part of the GBAtemp Homebrew Bounty 2011 (Wii).

Features

Convert a WBFS partition into a Fat32 partition - on the fly/in place.
Keep games as 4GiB splited ID6.wbfs files in wbfs folder.
Blazing fast - over 10GiB/s (50GiB Test in 4.27s).
Need very little space on other drives: only ~0.0125% of the partition size for Backup and RAM.
Windows + Linux (with some adjustments everything that runs python).
Both GUI and CLI available.
Designed with security in mind:
- Only modifies disk after all other computations.
- Creates backup of modified data.

User guide

Requirements

Windows(.exe) - Nothing.
Linux(.py) - python (+PyQt4 for GUI).
Windows(.py) - python + pywin32 + WMI for python (+PyQt4 for GUI).
Windows(Cygwin .py) - Cygwin + its python package.
(The versions marked "update" need to be copied over the next earlier full version).

Usage GUI

Run wbfs2fat without options (e.g. double click).
Select partition from list.
Click "convert to Fat32".

Usage CLI

"wbfs2fat --help" to see all options.
"wbfs2fat -m scan" to list of all wbfs partitions.
"wbfs2fat -m convert " to convert.

Error Codes

Error codes	Descriptions
0: No Error	Everything went as expected.
1: General Error	Something totally unexpected happened. Post the output and ask.
2: Argument Error	Check the command line options for typos and the like.
3: Not a WBFS partition (missing magic)	Partition is probably not in WBFS format. If it really should be a WBFS at least the identifier in the header is missing.
4: Unknown WBFS Version	So far I only encountered versions 0 and 1. If other versions appear wbfs2fat needs to be updated first.
5: Additional free Blocks needed	Conversion needs more free space. See chapter "Space" in the tutorial for details.
6: WBFS is corrupted: Blocks used multiple Times	Two or more games claim ownership of the same WBFS data, but only one can be right about it. That meant that at least parts of some games are corrupted. As possibly only a tiny part of a game was overwritten this may have gone unnoticed for years. This is caused by a known bug in the original version of the wbfs C library. If you delete a game using a manager, loader or whatever uses an affected library, parts of another game are marked as free too. If you add a game (even with a good lib) these parts are overwritten and the original game is corrupted. Unfortunately it is impossible to recover the data, delete and re-rip is the only way to fix it. wiimms "wwt" can figure out which game the block really belongs to and delete the corrupted ones. You need to download it and run it from a command-line. For details on how to do this see wit verify. If you can or want not do this there is another way. Run wbfs2fat with the "ignore-error-6" option. This will generate one copy of the affected block for each game that claims it. This will NOT fix nor identify the corrupted games. But it will allow you to go ahead while keeping your games in the same (bad) shape they are in now.
7: Permission denied	wbfs2fat was unable to read any data from the partition. Most likely you simply lack the rights required to do so. Try running wbfs2fat as admin/root. And try closing all WBFS mangers because they sometimes lock the drives. Empty CD drives and the like can show this too.

Screenshots

External links

Official site - https://www.unix-ag.uni-kl.de/~t_schmid/wbfs2fat/
GBAtemp - https://gbatemp.net/threads/wbfs2fat-py.291320/
GBAtemp - https://gbatemp.net/threads/wbfs2fat-wii-entry-pc-software.294498/
Detailed Tutorial/Howto - https://gbatemp.net/threads/how-to-convert-from-wbfs-to-fat32-or-ntfs.292391/

@@ Line 1: / Line 1: @@
-{{#seo:
-|title=Wii Homebrew PC Tools (PC Utilities) - GameBrew
-|title_mode=append
-|image=wbfs2fat.png
-|image_alt=WBFS2FAT
-}}
 {{Infobox Wii Homebrews
 |title=WBFS2FAT
-|image=wbfs2fat.png
+|image=wbfs2fatwii3.png
 |description=WBFS to FAT32 conversion.
 |author=PsyBlade
-|lastupdated=2013/01/03
+|lastupdated=2013/01/26
-|type=PC Utilities
+|type=WBFS Managers
 |version=0.9.0 beta2
 |license=Mixed
-|download=https://dlhb.gamebrew.org/wiihomebrews/wbfs2fatwii.7z
+|download=https://www.unix-ag.uni-kl.de/~t_schmid/wbfs2fat/
-|website=https://www.unix-ag.uni-kl.de/~t_schmid/wbfs2fat/
+|website=https://gbatemp.net/threads/wbfs2fat-py.291320/
-|source=
 }}
-WBFS2FAT is a tool that transforms a hard drive from WBFS to FAT32, enabling access to the drive without requiring a backup manager and allowing the drive to be repurposed for other functions. All games are preserved during the process.
+WBFS2FAT is a tool that transforms a hard drive from WBFS to FAT32, enabling access to the drive without requiring a backup manager and allowing the drive to be repurposed for other functions. All games are preserved during the process. An alternative Python version for other operating systems is also provided.
-An alternative Python version for other operating systems is also provided.
+The homebrew was part of the GBAtemp Homebrew Bounty 2011 (Wii).
-In our testing, the tool operates swiftly and achieves a rate of 25 GB per second. Following the conversion, the disk can be further transformed from FAT32 to NTFS via Windows disk management, among other methods.
 ==Features==
-* converts a WBFS partition into a Fat32 partition - on the fly/in place
+* Convert a WBFS partition into a Fat32 partition - on the fly/in place.
-* keeps Games as 4GiB splited ID6.wbfs files in wbfs folder
+* Keep games as 4GiB splited ID6.wbfs files in wbfs folder.
-* blazing fast - over 10GiB/s! (50GiB Test in 4.27s)
+* Blazing fast - over 10GiB/s (50GiB Test in 4.27s).
-* needs very little space on other drives
+* Need very little space on other drives: only ~0.0125% of the partition size for Backup and RAM.
-** only ~0.0125% of the partition size for Backup and RAM
+* Windows + Linux (with some adjustments everything that runs python).
-* Windows + Linux (with some adjustments everything that runs python)
+* Both GUI and CLI available.
-* both GUI and CLI available
+* Designed with security in mind:
-* designed with security in mind
+** Only modifies disk after all other computations.
-** only modifies disk after all other computations
+** Creates backup of modified data.
-** creates backup of modified data
-==Requirements==
-* Windows(.exe): nothing!
-* Linux(.py): python (+PyQt4 for GUI)
-* Windows(.py): python + pywin32 + WMI for python (+PyQt4 for GUI)
-* Windows(Cygwin .py): Cygwin + its python package
-* (The versions marked "update" need to be copied over the next earlier full version)
-==Usage GUI==
-* run wbfs2fat without options (e.g. double click)
-* Select partition from list
-* Click "convert to Fat32"
-==Usage CLI==
-* "wbfs2fat --help" to see all options
-* "wbfs2fat -m scan" to list of all wbfs partitions
-* "wbfs2fat -m convert " to convert
-==Screenshot==
-https://dlhb.gamebrew.org/wiihomebrews/wbfs2fat-01.png
-==FAQ==
-* yes Error 6 can be fixed - the msg even says how - see the error section below for details
-* no it does NOT delete the games - that's the whole fucking point
-* no it's not Linux only - look at the edit dates of the posts
-* the first post is updated - the rest is not
-* uploading it to every pirate hoster is pointless - you can get it from me free of charge
-* I don't like it either and therefore forbid hosting it unless I give explicit permission
-* yes I know you are gonna ignore this
-* if you expect an answer from me you should post here - not in some other forum where I'm not registered
-* looking at the (implied) Q's of this FAQ make makes one wanna bang ones head against a wall
-* I still think it should be named "Tips for the mentally challenged" but apparently no one reads that
-==Exit Codes and Error descriptions==
-<pre>
-: No Error
-Everything went as expected
-: General Error
-Something totally unexpected happened
-Post the output and ask
-: Argument Error
-Check the command line options for typos and the like
-: Not a WBFS partition (missing magic)
-Partition is probably not in WBFS format.
-If it really should be a WBFS at least the identifier in the header is missing.
-: Unknown WBFS Version
-So far I only encountered versions 0 and 1.
-If other versions appear wbfs2fat needs to be updated first.
-: additional free Blocks needed
+==User guide==
-Conversion needs more free space.
+===Requirements===
-See chapter "Space" it the tutorial for details.
+* Windows(.exe) - Nothing.
+* Linux(.py) - python (+PyQt4 for GUI).
+* Windows(.py) - python + pywin32 + WMI for python (+PyQt4 for GUI).
+* Windows(Cygwin .py) - Cygwin + its python package.
+* (The versions marked "update" need to be copied over the next earlier full version).
-: WBFS is corrupted: Blocks used multiple Times
+===Usage GUI===
-Two or more games claim ownership of the same WBFS data, but only one can be right about it.
+* Run wbfs2fat without options (e.g. double click).
-That meant that at least parts of some games are corrupted.
+* Select partition from list.
-As possibly only a tiny part of a game was overwritten this may have gone unnoticed for years.
+* Click "convert to Fat32".
-This is caused by a known bug in the original version of the wbfs C library.
+===Usage CLI===
-If you delete a game using a manager, loader or whatever uses an affected library,
+* "wbfs2fat --help" to see all options.
-parts of another game are marked as free too. If you add a game (even with a good lib)
+* "wbfs2fat -m scan" to list of all wbfs partitions.
-these parts are overwritten and the original game is corrupted.
+* "wbfs2fat -m convert " to convert.
-Unfortunately it is impossible to recover the data, delete and re-rip is the only way to fix it.
-wiimms "wwt" can figure out which game the block really belongs to and delete the corrupted ones.
+===Error Codes===
-You need to download it and run it from a command-line.
+{| class="wikitable" style="width: 800px;"
-For details on how to do this see wit verify
+!style="width: 20%;"|Error codes
+!style="width: 80%;"|Descriptions
+|-
+!0: No Error
+|Everything went as expected.
+|-
+!1: General Error
+|Something totally unexpected happened. <br>
+Post the output and ask.
+|-
+!2: Argument Error
+|Check the command line options for typos and the like. <br>
+|-
+!3: Not a WBFS partition (missing magic)
+|Partition is probably not in WBFS format. <br>
+If it really should be a WBFS at least the identifier in the header is missing.
+|-
+!4: Unknown WBFS Version
+|So far I only encountered versions 0 and 1. <br>
+If other versions appear wbfs2fat needs to be updated first.
+|-
+!5: Additional free Blocks needed
+|Conversion needs more free space. <br>
+See chapter "Space" in the [https://gbatemp.net/threads/how-to-convert-from-wbfs-to-fat32-or-ntfs.292391/ tutorial] for details.
+|-
+!6: WBFS is corrupted: Blocks used multiple Times
+|Two or more games claim ownership of the same WBFS data, but only one can be right about it. <br>
+That meant that at least parts of some games are corrupted. <br>
+As possibly only a tiny part of a game was overwritten this may have gone unnoticed for years. <br><br>
+This is caused by a known bug in the original version of the wbfs C library. <br>
+If you delete a game using a manager, loader or whatever uses an affected library, parts of another game are marked as free too. If you add a game (even with a good lib) these parts are overwritten and the original game is corrupted. <br>
+Unfortunately it is impossible to recover the data, delete and re-rip is the only way to fix it. <br><br>
+[[Wiimms ISO Tools|wiimms "wwt"]] can figure out which game the block really belongs to and delete the corrupted ones. <br>
+You need to download it and run it from a command-line. <br>
+For details on how to do this see wit verify. <br><br>
+If you can or want not do this there is another way. <br>
+Run wbfs2fat with the "ignore-error-6" option. This will generate one copy of the affected block for each game that claims it. This will NOT fix nor identify the corrupted games. <br>
+But it will allow you to go ahead while keeping your games in the same (bad) shape they are in now.
+|-
+!7: Permission denied
+|wbfs2fat was unable to read any data from the partition. <br>
+Most likely you simply lack the rights required to do so. Try running wbfs2fat as admin/root. <br>
+And try closing all WBFS mangers because they sometimes lock the drives. <br>
+Empty CD drives and the like can show this too.
+|-
+|}
-If you can or want not do this there is another way.
+==Screenshots==
-Run wbfs2fat with the "ignore-error-6" option. This will generate one copy of the affected block for
+https://dlhb.gamebrew.org/wiihomebrews/wbfs2fatwii3.png
-each game that claims it. This will NOT fix nor identify the corrupted games.
-But it will allow you to go ahead while keeping your games in the same (bad) shape they are in now.
-: permission denied
+==External links==
-wbfs2fat was unable to read any data from the partition.
+* Official site - https://www.unix-ag.uni-kl.de/~t_schmid/wbfs2fat/
-Most likely you simply lack the rights required to do so. Try running wbfs2fat as admin/root.
+* GBAtemp - https://gbatemp.net/threads/wbfs2fat-py.291320/
-And try closing all WBFS mangers because they sometimes lock the drives.
+* GBAtemp - https://gbatemp.net/threads/wbfs2fat-wii-entry-pc-software.294498/
-Empty CD drives and the like can show this too.
+* Detailed Tutorial/Howto - https://gbatemp.net/threads/how-to-convert-from-wbfs-to-fat32-or-ntfs.292391/
-</pre>
-==External Links==
+[[Category:GBAtemp Homebrew Bounty 2011]]
-* Official Site - https://www.unix-ag.uni-kl.de/~t_schmid/wbfs2fat/
-* Wiidatabase - https://wiidatabase.de/downloads/pc-tools/wbfs2fat/
-* Gbatemp - https://gbatemp.net/threads/wbfs2fat-py.291320/
-* Detailed Tutorial/Howto: https://web.archive.org/web/20120326070059/http://gbatemp.net/t292391-how-to-convert-from-wbfs-to-fat32-or-ntfs