Wii Ultimate Unscrubber
The tool can unscrub a scrubbed Wii ISO to it's original state. That matches Redump.org checksum.
The original discussion topic is at Romshepherd (category "tools")
* Can unscrub ISOs scrubbed with many tools (wiiscrubber, wit, WiiBackUp Manager).
* Can decrypt/encrypt ISOs
Changelog
v0.4 beta
* Added support for WBFS. Can use everywhere the ISO is expected.
* Can use UPDATE partitions from other ISOs, to restore ISOs that don't have UPDATE partition.
* Can use Redump DAT file to verify the unscrubbed ISO. The redump DAT file is required to unscrub an ISO that has no UPDATE partition.
* In some cases can restore a modified header. Works if the game title (name) is not too long.
Ok, how it works. If your ISO/Wbfs has an UPDATE partition, then just drop the iso on the UltimateUnscrubber.exe to unscrub it. If it doesn't have an UPDATE partition then you need 2 things. First is a Redump DAT file (any name, make sure the extension is .dat) Put that file into UltimateUnscrubber_files folder which is located where the UltimateUnscrubber.exe is. I have already included such a DAT file into the archive, but if you want a more recent version, then replace it.
Second you need a collection of extracted UPDATE partitions. Those should be placed at UltimateUnscrubber_files\update_partitions .
Those partitions you can either get from somewhere (download from the internet, here). Or extract them yourself, if you have a big collection of good ISOs. To extract UPDATE partitions, drop a folder with your good ISOs or WBFSs on UltimateUnscrubber.exe.
v0.3.2 changes
* Added support for complex partition tables (the only known game using it "Super Smash Bros. Brawl")
* Added support for unscrubbing ISOs with strange UPDATE padding, if the padding was not removed by scrubbing tools. (more info below)
v0.3.1 changes
* Added support for korean ISOs
* Added support for multi-disc games (the only known game "Dragon Quest X: Mezameshi Itsutsu no Shuzoku Online")
v0.3 changes
* Unscrubber now takes into account "Keep Headers" option in wiiscrubber.
v0.2 changes
* always try to unscrub, even if the ISO does not seem to be scrubbed.
* added "decrypt" switch, to decrypt the ISO instead of unscrub.
H3 CHECKSUM ERROR
If you get "H3 checksum error" in the unscrubber, then you should first verify if the ISO is damaged. Use wit tool: "wit verify game.iso". If the wit tool gives an error too, then the file is damaged, and there is no need to report this error here.
WHY AN ISO CANNOT BE UNSCRUBBED?
1. The often reason of an unsuccessful unscrub is the lack of an UPDATE partition inside the ISO or WBFS. The 0.4 beta version can integrate UPDATE partitions extracted from other ISOs.
2. Another reason could be that the header was modified. Especially it's known that some scene releasers add their name to the game's title inside an ISO.
3. The least probable reason is that the ISO is listed in the red list below
ISOS THAT CANNOT NOT BE UNSCRUBBED (unless scrubbed with WBM, more info below)
- Ant Bully (RI3E5D, RI3P5D)
- Rampage: Total Destruction (RPGE5D, RPGP5D)
- Link's Crossbow Training (only korean RZPK01)
WHY THE ISOS LISTED IN THE RED LIST CANNOT BE UNSCRUBBED?
Those ISOs contain some strange data after UPDATE partition. I didn't find what it is, and was not able to generate it. It is identical in USA and EUR discs for both games, but different in the korean one. Which makes me think, this could be data encrypted with an unknown encryption key (which are different for korean and non-korean). The "wii common AES key" for decrypting partitions, didn't work for that data.
All those games are from the first generation games for wii. They were in development when the console was not even released at that time. So it makes me think, they used very old Wii SDK for development. And that SDK (maybe beta version) had some strange behavior (maybe a bug).
Almost all scrubbing tools I tried, remove that data. The only way to preserve it when scrubbing is to use "Wii Backup Manager" with option "enable full scrubbing mode" disabled.
I will try to somehow workaround this situation in 0.4 version, by extracting that data, and preserving it separately. But for now those discs might be impossible to unscrub.
WHAT ARE PARTITIONS?
almost all wii isos contain only 2 partitions: UPDATE and DATA. Some isos contain additional partitions. All partitions except DATA are mostly not needed for playing a game. So WBFSs oftenly contain only DATA partition.
All these isos can be unscrubbed if the partitions were not removed.
the following games contain a CHANNEL partition
- Wii Fit
- Wii Fit Plus
- Rabbids Go Home
- Mario Kart Wii
the following game contains about 12 VC sample partitions. Their exact number depend on the region.
- Super Smash Bros. Brawl
the following japanese games contain a new partition type which actually contains most of game's data files. Without this partition the game does not work. These games are relatively new.
- Dragon Quest X: Mezameshi Itsutsu no Shuzoku Online
- Dragon Quest X: Inishie no Ryuu no Denshou Online
WHY WOULD YOU NEED TO DECRYPT AN ISO
All partitions inside a Wii ISO are AES encrypted. "UltimateUnscrubber decrypt <game.iso>" will decrypt an ISO. Decrypting an ISO makes it more compressible with ZIP or RAR. Up to 500mb regardless of scrubbing.
But decrypted ISOs cannot be played on the console or the Dolphin emulator. They need to be encrypted back.
My tool cannot scrub an ISO. So its "decrypt" feature is more for debugging purposes. If you want a more efficient decryption process, use the Wit tool. "wit convert <game.iso> --enc decrypt" , and to encrypt "wit convert <game.iso> --enc encrypt". My tool encrypts a decrypted iso automatically when unscrubbing.
And for the last word
All ISOs, if they have all their partitions in place and are not listed in the red list above, should be 100% unscrubable. If you found an ISO with an UPDATE partition and it didn't unscrub, please let me know.
The tool can unscrub a scrubbed Wii ISO to it's original state. That matches Redump.org checksum.
The original discussion topic is at Romshepherd (category "tools")
* Can unscrub ISOs scrubbed with many tools (wiiscrubber, wit, WiiBackUp Manager).
* Can decrypt/encrypt ISOs
Changelog
v0.4 beta
* Added support for WBFS. Can use everywhere the ISO is expected.
* Can use UPDATE partitions from other ISOs, to restore ISOs that don't have UPDATE partition.
* Can use Redump DAT file to verify the unscrubbed ISO. The redump DAT file is required to unscrub an ISO that has no UPDATE partition.
* In some cases can restore a modified header. Works if the game title (name) is not too long.
Ok, how it works. If your ISO/Wbfs has an UPDATE partition, then just drop the iso on the UltimateUnscrubber.exe to unscrub it. If it doesn't have an UPDATE partition then you need 2 things. First is a Redump DAT file (any name, make sure the extension is .dat) Put that file into UltimateUnscrubber_files folder which is located where the UltimateUnscrubber.exe is. I have already included such a DAT file into the archive, but if you want a more recent version, then replace it.
Second you need a collection of extracted UPDATE partitions. Those should be placed at UltimateUnscrubber_files\update_partitions .
Those partitions you can either get from somewhere (download from the internet, here). Or extract them yourself, if you have a big collection of good ISOs. To extract UPDATE partitions, drop a folder with your good ISOs or WBFSs on UltimateUnscrubber.exe.
v0.3.2 changes
* Added support for complex partition tables (the only known game using it "Super Smash Bros. Brawl")
* Added support for unscrubbing ISOs with strange UPDATE padding, if the padding was not removed by scrubbing tools. (more info below)
v0.3.1 changes
* Added support for korean ISOs
* Added support for multi-disc games (the only known game "Dragon Quest X: Mezameshi Itsutsu no Shuzoku Online")
v0.3 changes
* Unscrubber now takes into account "Keep Headers" option in wiiscrubber.
v0.2 changes
* always try to unscrub, even if the ISO does not seem to be scrubbed.
* added "decrypt" switch, to decrypt the ISO instead of unscrub.
H3 CHECKSUM ERROR
If you get "H3 checksum error" in the unscrubber, then you should first verify if the ISO is damaged. Use wit tool: "wit verify game.iso". If the wit tool gives an error too, then the file is damaged, and there is no need to report this error here.
WHY AN ISO CANNOT BE UNSCRUBBED?
1. The often reason of an unsuccessful unscrub is the lack of an UPDATE partition inside the ISO or WBFS. The 0.4 beta version can integrate UPDATE partitions extracted from other ISOs.
2. Another reason could be that the header was modified. Especially it's known that some scene releasers add their name to the game's title inside an ISO.
3. The least probable reason is that the ISO is listed in the red list below
ISOS THAT CANNOT NOT BE UNSCRUBBED (unless scrubbed with WBM, more info below)
- Ant Bully (RI3E5D, RI3P5D)
- Rampage: Total Destruction (RPGE5D, RPGP5D)
- Link's Crossbow Training (only korean RZPK01)
WHY THE ISOS LISTED IN THE RED LIST CANNOT BE UNSCRUBBED?
Those ISOs contain some strange data after UPDATE partition. I didn't find what it is, and was not able to generate it. It is identical in USA and EUR discs for both games, but different in the korean one. Which makes me think, this could be data encrypted with an unknown encryption key (which are different for korean and non-korean). The "wii common AES key" for decrypting partitions, didn't work for that data.
All those games are from the first generation games for wii. They were in development when the console was not even released at that time. So it makes me think, they used very old Wii SDK for development. And that SDK (maybe beta version) had some strange behavior (maybe a bug).
Almost all scrubbing tools I tried, remove that data. The only way to preserve it when scrubbing is to use "Wii Backup Manager" with option "enable full scrubbing mode" disabled.
I will try to somehow workaround this situation in 0.4 version, by extracting that data, and preserving it separately. But for now those discs might be impossible to unscrub.
WHAT ARE PARTITIONS?
almost all wii isos contain only 2 partitions: UPDATE and DATA. Some isos contain additional partitions. All partitions except DATA are mostly not needed for playing a game. So WBFSs oftenly contain only DATA partition.
All these isos can be unscrubbed if the partitions were not removed.
the following games contain a CHANNEL partition
- Wii Fit
- Wii Fit Plus
- Rabbids Go Home
- Mario Kart Wii
the following game contains about 12 VC sample partitions. Their exact number depend on the region.
- Super Smash Bros. Brawl
the following japanese games contain a new partition type which actually contains most of game's data files. Without this partition the game does not work. These games are relatively new.
- Dragon Quest X: Mezameshi Itsutsu no Shuzoku Online
- Dragon Quest X: Inishie no Ryuu no Denshou Online
WHY WOULD YOU NEED TO DECRYPT AN ISO
All partitions inside a Wii ISO are AES encrypted. "UltimateUnscrubber decrypt <game.iso>" will decrypt an ISO. Decrypting an ISO makes it more compressible with ZIP or RAR. Up to 500mb regardless of scrubbing.
But decrypted ISOs cannot be played on the console or the Dolphin emulator. They need to be encrypted back.
My tool cannot scrub an ISO. So its "decrypt" feature is more for debugging purposes. If you want a more efficient decryption process, use the Wit tool. "wit convert <game.iso> --enc decrypt" , and to encrypt "wit convert <game.iso> --enc encrypt". My tool encrypts a decrypted iso automatically when unscrubbing.
And for the last word
All ISOs, if they have all their partitions in place and are not listed in the red list above, should be 100% unscrubable. If you found an ISO with an UPDATE partition and it didn't unscrub, please let me know.
Attachments
Last edited by osupka,