WiiScrubber: Difference between revisions

WiiScrubber
WiiScrubber
	File:Wiiscrubberwii.jpg
General
Author	Dack
Type	PC Utilities
Version	1.4
License	Mixed
Last Updated	2009/02/14
Links
	Download
	Website

Revision as of 03:18, 29 Ocak 2023

The WiiScrubber is a tool that allows you to scrub or remove unnecessary data from Wii disc images and exchange files within them. In order to use the tool, the common key of the Wii must first be generated using the "MakeKeyBin.exe" program. The WiiScrubber only supports ISO images, not WBFS.

Whats new?

ticket.bin is displayed under the partition.bin breakout
cert.bin and tmd.bin can now be different sizes
Extra button for Trimming an ISO - this makes an ISO slightly larger than the indicated data size - USES TRUCHA
Confirmation window on Shrinking partition
Proper Korean key support so can open and scrub/trim/extract/replace Korean ISOs
Deleted the 'force Wii' option as I followed the advice of Marcan
Partition support corrected due to a Wii limitation on Primary partition (you can only have three partitions in the primary. To paraphrase Star Wars "Many verbatims died to bring you this information").
Can save/load/import crypted partitions making replacement much quicker
Full 4 partition offset support
Partition titles displayed in the window.

In other words you can easily create a multipartition disc. AKA a multiboot.

Companion software

Makewiikeybin. exe - makes a key.bin file for you. Does not contain the actual key but generates it from a simple algorithm.
1. Decided to remove this from the pack due to some twittering. See links for possible solution
2. I also recommend hexd.exe. Version 1.1 also generates the Korean kkey.bin.
PartitionBuilder - allows you to generate a partition file that can be loaded via wiiscrubber. This means you can now generate an entire partition from a directory of files. So rather than changing one at a time you can extract an entire partition, change whatever files you want and then rebuild.
Partition.bin changer - allows you to view/modify the ticket, tmd, certs and h3.bin in one simple editing package Allows trucha signing of ticket and tmd
HBC Multiboot file, based on SoftChip, that allows you to select which partition to boot from. i.e. A multiISO loader

Usage

You need:

You will need a copy of the ubiquitous "key.bin" in the same directory.
For full functionality you also require the Korean "kkey.bin"
You should not need to install any extra runtime files.
A descrambled wii iso
Plenty of disc space
A fair bit of time.

How to use:

Copy the key.bin file to the same directory as the exe.
Load the software.
Load the ISO file by clicking on the 'load iso' button
What the program is doing appears in the bottom window
Disc filelist appears in the top window as a standard treelist
Name of game and size of the data on the disc appears in top right

How to extract files:

Only one at a time at present
In the treelist click on a file to select
Right click the mouse button
Select 'Save' from the popup menu
The fields on the filename shown are:
name, partition, Offset into decrypted file, Filesize, file reference in FST (-ve means system file)

How to scrub the disc:

Click on the clean and save button Depending on the option chosen next to the clean button you will then save either a scrubbed file, a dif file or both files. If the TRUCHA option is chosen then you will create several new files:

. a dummy fst.bin
. a modified fst.bin containing links for the padding files
. several files full of 0's that can be loaded into the modified image.
. a modified boot.bin that is needed for the modified fst.bin to be accessed

ISO: This creates a copy of the loaded ISO with the same name but (compress) appended to the name before the .ISO part (so SPM.ISO would become SPM(compress).ISO).
DIFF: This creates a Diff file of the differences between the loaded file and what a scrubbed one would contain. The filename used is the same as the savename but with .dif used instead of ISO
BOTH: does both ISO and DIFF - you will need a LOT of storage for this

Compressing the scrubbed image should give you a figure close to the size of data detailed earlier. The DIFF file will not compress that well (due to it being the random data contained in the 'empty' disk blocks.

To unscrub/patch the compressed ISO

Click on "unscrub image"
Select the scrubbed ISO e.g. m-mkwii(compress).iso
Select the .DIF file to patch in e.g. m-mkwiifix.dif
Select the name of the file you want to save as e.g. m-mkwiiFIXED.iso
Wait.......
(Make sure you have at least 4.5 Gig free on an NTFS formatted drive - there is a limit of 4 Gig on FAT32 drives)
Burn the newly created ISO

Media

WiiScrubber - Extracting Files and Things (Tutorial) - (SuperSandwic)

FAQ

Q1. What does it actually do?
A1. It finds out where in the disc image the data is and changes the rest of the data to 0xFFs.

Q2. And this does what?
A2. It allows compression programs to then compress the image. After you have run the software, in 'classic mode', you can compress the resulting ISO and get a size similar to that indicated in the top right panel.

Q3. What does the TRUCHA option do?
A3. Well one of the other ways of overwriting the non-compressable empty space is by overwriting it with 0's. This has the advantage of, since it is using TRUCHA, actually correcting the SHA tables.

Q4. But TRUCHA won't work with IOS37 will it so it's a bit pointless?
A4. Most likely BUT it's very much a case of wait and see. Changing the disc to boot directly instead of from the system menu would possibly still allow it to work anyways. It was also a bit of development I was doing for multidisc :) Some people haven't updated to IOS37 anyways. The downgrader also makes it worthwile.

Q5. Multidisc????
A5. Well since I know where the data is on the disc, and can add files,directories etc. It's only a small step to create an image that contains the files of several other ISO images.

I "only" need to finalise the "merge fst.bins while checking for duplicate filenames and relocating all the files in the second disc to the free space on the first disc" function.

The TRUCHA option adds 5 files to the image in the root directory and then maps their data to the free space. This is made even easier by the partition options now implemented as you could simply extract several partitions worth of data, merge the files and add on a loader/chooser.

I'll give it a week from when this software is released until a multidisc maker appears (change the main.dol names for each disc, put into seperate directories, modify the main.dols to use the new directories, have a menu on screen that allows you to choose and run the different (renamed) main.dols).

Q6. How do I scrub a disc normally?
A6. You can only do this if you have a copy of the key.bin file in the same directory as the software.

Depending on whether you want to create the DIFF file then make a selection from ISO, DIFF or BOTH A DIFF file is a copy of the data that was 'scrubbed' from the ISO and allows you to unscrub at a later date if you so wish.

Depending on whether you want to maintain the header information then choose either YES or NO from the keep headers block. Given the ease of checking sha tables it's probably a bit pointless keeping them and adds 1k per cluster to the storage if you do (about an extra 150Meg over a disc image)

Depending on whether you want to do TRUCHA scrubbing or normal then chose 0xFF or TRUCHA from the scrub type box

0xFF Mode:

1. Click on 'open ISO'
2. Wait for it to be parsed. If all looks OK then click on 'clean and save'
3. You will be prompted for where to save the file. Choose a path and name - I recommend using a different drive to the source ISO.
4. Confirm your selection from the pop-up prompts
5. Wait until it says it's finished
6. Compress the newly created file with whatever archive software you want

Trucha Mode:
1. Click on 'open ISO'
2. Wait for it to be parsed. If all looks OK then click on 'clean and save'
3. You will be asked to confirm you want to save the file.
4. Empty files and a replacement fst.bin, a fake fst.bin and a replacement boot.bin are created
   in the same directory as the ISO
5. Wait until it says it's finished
6. Follow the instructions in the final pop-up
7. Compress the newly created file with whatever archive software you want

Q7. How do I unscrub a disc?
A7. You do not need a copy of key.bin for this operation.

You will need at least 4.3Gig of storage space for this

1. Click on UNSCRUB IMAGE
2. Choose the ISO image to unscrub and the choose the DIFF file to use
3. Choose where to save the unscrubbed image
4. Select yes from the 'are you sure' popups.
5. Wait.

Q8. Why cant I create files bigger than 4Gig?
A8. You have the destination partition formatted to FAT32 which only allows files upto 4Gig in size

Q9. How do I Save a file from an ISO?
A9. Open the ISO and then right hand click on the file in the disc display. Then choose "extract" from the pop-up menu.

Q10. How do I load a file?
A10. Similar to A9. Load the ISO and choose 'replace' from the pop-up menu. If a file is bigger than the one originally there then the software will try and relocate it to another part of the disc image that does have enough space to accomodate it and the update the fst.bin or boot.bin accordingly.

Q11. Does Load work on Gamecube discs?
A11. No. As all the work is based around encrypted partitions.

Q12. I think I've found a bug!
A12. Then pop along to www.gbatemp.net and let me know

Q13. What is the point of deleting a partition?
A13. That allows you to delete, for example, an update partition from the disc image. Effectively it then functions in a similar manner to having 'brickblocked' it. It has the added advantage of not including any Nintendo firmware image and knocks a bit more off the scrubbed ISO size.

Q14. Why would I need to resize a partition?
A14. Some ISO images have a partition size set to, say, 4Gig while having the datasize set to only a few hundred Megs. This then means that extra files cannot be added into the disc partition OR larger files cannot be moved in either as the datasize will not allow it.

Q15. Do I have to unscrub an image before burning it?
A16. Nay, nay and thrice times nay. Just unrar/zip/7 Zip the image which should then give you a 4.5 Gig (or whatever) file and then burn it. Imageburn is the recommended application for burning.

Q16. Whats the best compressor to use?
A16. I use winrar but other people use 7 Zip. When compressing you might as well choose the 'fastest' option as there is a negligible difference in output compared to a massive decrease in compression time. It's why I never implemented a compression option.

Q17. Will you write a Linux and Mac version?
A17. No. I don't have the time at present (or the hardware in the Mac instance). I'm more than willing to help anyone who wants to though. Source code is always available (and I usually comment what I do :) )

Q18. Why did you stop developing it?
A18. It's use is now moving away from what was originally intended (the partition stuff and the trucha bits). It's time for new apps.

I'm also bored of developing it at the moment and it seems a good time to stop.

Q19. Does getting rid of the headers use the TRUCHA bug?
A19. No. It works as a 'normal' scrub but doesn't keep the 1k of encrypted header. This means it's easier to spot in software but as the headers are incorrect in relation to the data in a scrubbed disc it would fail a simple SHA test either with or without them.

Q20. I've heared that discs that have been scrubbed cannot be opened by Trucha signer. Is this true?
A20. No. Trucha, like scrubber, has it's own set of bugs and scrubbing the disc does not trigger any of those. Trucha cannot open some discs as standard due to some of it's limitations on file count and not handling more than 2 partitions. It's still a very nice application.

Q21. What about changing the boot mode of the disc?
A21. Depending on where you right click in the display, you'll get a different menu. Doing the right hand click over "WII DISC" allows you to change the boot mode. In short, by setting the first byte of the disc to '0' it bypasses the system disc channel menu. The usual value is 'R'.

Q22. What on earth is "shuffling"?
A22. This is where the partitions on the disc have been madified in some way and there is a gap between them. Shuffling moves all the partitions upto the end of the previous partition and has the effect of moving all the intergap partitions upto the end of the disc. e.g. if you delete the update partition you can then 'shuffle' the data partition down to where the update partition started.

Q23. What does the 'Shrink' option do?
A23. This takes all the data in the partition and moves it all upto the start of the partition, moving all the free space to the end. This uses the Trucha bug as the H3 table gets regenerated.

Q24. Why bother changing the boot mode?
A24. Why not? It allows for the disc to be booted as an automatic instead of manual mode. This is just another feature I implemented while playing around.

Q25. What do the other exe's in the Rar do?
A25. MakeWiiKeyBin.exe alleviates the need to distribute key.bin - it makes it for you Partition builder allows you to take a directory of data and create a partition from it - that can then be put into a disc image by wiiscrubber.

To build a partition you will need:
1. A partition.bin, apploader.img, boot.bin and bi2.bin taken from an existing disc
2. A Main.dol
3. A boot.bin and bi2.bin taken from an existing disc
4. Some other files that you want to put in the image - max filecount is about 0x20000

Q26. Why doesn't the extract option work sometimes?
A26. The name probably contains spaces, while acceptable under Windows I wasn't sure the Wii actually allowed filenames like that I didn't bother fixing it.

Q27. I sometimes get "i/o error" when adding partitions and/or opening an ISO - why is this?
A27. This is due to me not fully creating a boot.bin for the new partition you create. It's a 'soft error' in that things will still work. You may encounter it when importing a partition.

If the ISO is the DVD5 version of SSBB then the reason you have the error is because the channel table still shows the VC games as being present, though they have been removed. If you delete the VC partitions they'll disappear.

Q28. What about the source code? Can I have a copy?
A28. Yep. The source is released and should be found somewhere near where you found this FAQ and readme. A lot of it is commented to a reasonable standard.

Q29. I have a great idea to improve the software, how do I do that?
A29. See the answer to A28 and get a copy of visual C. I'll probably do any small bugfixes anyways.

Q30. I've heared that scrubbed discs do not work under IOS37 - is this true?

A30.
 xx  xx   xxxx  xx
 xxxxxx xxxxxx
 xx xx   xx xxxxxx
 xx  xx  xx xxxxxx
 xx   xx xx xxxxxx
 xxxxxx xxxx
 xx  xx   xxxx  xx

IT DOES NOT USE THE TRUCHA BUG UNLESS YOU CHANGE A FILE. THE TRUCHA BUG IS FIXED UNDER 37.

Q31. How do I create a multiboot disc. THESE ARE TRUCHA SIGNED BECAUSE OF THE SHRINK PROCESS.
A31. Simplest technique is to:

1. load an ISO, select the data partition and shrink it. Then save it out as a crypted partition.
2. Repeat stage 1 until you have a selection of partitions.
3. Load an ISO that you want to adapt.
4. Delete all the partitions (right click on partition, delete partition)
5. Repeat for all partitions.
6. Right click on WII DISC and select IMPORT, Crypted. Choose partition to load. Select partition table to use.Wait.
   The partition table 0 MUST contain at least one partition but can have a maximum of 3.
7. Repeat for all the partitions you created at stage 2.
8. Burn disc.

Q32. What about Answer 18?
A32. Well I changed my mind :) And enough time had passed for me to get interested again.

Limitations/Errors/Bugs/Features/Improvements

You may notice the 'load' function on the file popup - that would be a target - FIXED
Multiple file extraction would be more than useful but I thought it was better to test the extraction function on single files first
I've got an issue where a release version will not work correctly, thats why this release is a debug build. (*Love* finding those errors) - FIXED - Thanks to Juster at GBATemp.net
Yes the Icon is rubbish - one of my trademarks - will be fixed soon
File size is limited to 4.5 Gig as if the software is on a DL disc it probably needs to be - Fixed
Some of the extracted Disc titles look odd - not my fault :) - Fixed

Changelog

1.40

You can actually load/replace partition.bin again - this was broken in the 1.30 to 1.31 update
Shrink partition works correctly now - incorrect size was being copied down - OOOPS.
Can change the bootmode of unusually defined boot mode discs
Partitions now start on a 0x20000 boundary as the Wii seems to like them that way
Partitions in the second partition table now show correctly

1.30

17 Can cater for discs that have non-standard disc IDs by using the 'force wii' check box e.g. iso_template.iso.bz2
18 Can extract/replace the sub parts of partition.bin i.e. tmd.bin, cert.bin and h3.bin
19 Added two useful links in the about box ;)

1.21

1. Extra options on right click menu related to partition operations (you can now delete them and resize the data area)
2. Increased speed of file replacement by blocking it (and progress bar)
3. Extra couple of links in the about box
4. Window is now resizable (within limits)
5. Some of the text on buttons changed
6. More accurate indication of size as headers are now included in calculation and dynamically considered when header button pressed
7. Extra option on right click for WIIDISC as it allows for changing between system boot and normal boot
8. Common key check possible to over-ride in case Korean key becomes available
9. Can now replace the partition.bin file
10. Can add data partitions/channels
11. Can 'shuffle' up the partitions to the start of the disc for where some have been deleted - doesn't use Trucha bug.
12. Can Shrink the partition by moving the data up in the partition (meaning all the free space then appears at the end - Uses Trucha Bug.
13. Can save a decoded partition
14. Can load/replace a decoded partition
15. Can import a new disc partition.
16. Can resize a partition.

1.2

1. Bug fixes in the fst.bin size calculation for non-system files meant that added files were made as size / 4
2. 32/64 bug in line:

/* Jump to the specified cluster and copy it to memory */
offset = iso->parts[partition].offset + iso->parts[partition].data_offset + (cluster * SIZE_CLUSTER); fixed to:
/* Jump to the specified cluster and copy it to memory */
offset = iso->parts[partition].offset + iso->parts[partition].data_offset + (u64)((u64)cluster * (u64)SIZE_CLUSTER);

So that data could be read above the 2 gig point correctly. Problem possibly exists in Waninkokos source code too as it does an int by UL calculation for the cluster * SIZE_CLUSTER

1.1b

1. Load file now works
2. Several more bug fixes with 32/64 issues
3. Display changed for partition info to allow VC channels to show correctly
4. Trucha signing of disc works automagically
5. Can possibly load files bigger than the original

1.0a

1. Options of creating and using the dif files
2. MoH2 now really does show correctly ;)
3. Key checking to make sure the correct one is used
4. code tidy up
5. Gamecube images work
6. TRUCHA signer padding option
7. Option of keeping crypto headers or not
8. settings are saved in the registry
9. Bug fixing - thank you Juster.

1.0

1. Way of scrubbing changed slightly so that the sector crypto header is left unchanged. This makes it a bit more difficult to detect but lessens the compressability.
2. Disc Filename display corrected so titles like MoH2 show correctly ;)

Changes from beta test version:

1. Key file now only needs to be in the same directory as the program
2. A progress bar with cancel option when you start scrubbing
3. appended file name changed to (compress) to avoid confusion
4. Clickable URL of gbatemp in about box.

Thanks to

My wife for putting up with me while I twiddled with this
Lots of people who did beta testing e.g sr_corsario
People who suggested things or who's software I 'borrowed' e.g. Wiipower and the Softchip people

External Links

Wiidatabase - https://wiidatabase.de/downloads/pc-tools/wiiscrubber/