View source for CleanRip

{{Infobox homebrew
| image       = [[File:CleanRip.png]]
| title       = CleanRip
| type        = system tool
| author      = [[User:emu_kidid | emu_kidid]]
| version     = Version 2.2.0
| licence     = [http://www.gnu.org/licenses/gpl-2.0.txt GNU GPL v2]
| download    = https://github.com/emukidid/cleanrip/releases
| source      = https://github.com/emukidid/cleanrip
| peripherals = {{DVD}} {{WiFi}} {{Internet}} {{WiiDisc}} {{GCNController}} {{Wiimote1}} {{FrontSD}} {{FrontSDHC}} {{USBMSD}}
| hbb         =
| osc         = yes
}}
'''CleanRip''' is a Gamecube and Wii optical disc backup tool for the Nintendo Wii. It creates 1:1 backups of Gamecube or Wii discs for archival purposes.

The "Clean" in CleanRip comes from the fact that this tool does not require nor utilize any custom IOS (cIOS). It simply requires that you have the latest Homebrew Channel (HBC) installed. Also, if it finds that IOS58 is installed, you will be able to rip discs at USB 2.0 speeds.

==Usage==
Extract the .zip archive to your card and run it via the Homebrew Channel. Follow the on-screen instructions.

==Changes==
===2.2.0 (February 2nd, 2024)===
* Enable NTFS support on GameCube and SD cards
* Built with latest libNTFS

===2.1.2 (December 7th, 2023)===
* Added M.2 Loader support for GameCube
* Use libOGC2
* Add Wii unlicensed disc support
* Print dump duration in minutes and seconds instead of only seconds
* Implement automatic dual-layer disc detection

===2.1.1 (November 10th, 2019)===
* Option to remember settings for an entire ripping session
* Enable 32MHz mode on GameCube for slightly faster rips
* ETA and read speed is now based on the data read in the last second
* Tidy up the main read loop
* XenoGC patching workaround

===2.1.0 (October 31st, 2019)===
* Fix crash on verify disk and other minor fixes
* Fix DAT downloading issue (Wii DAT is > 1MB)
* Add SD2SP2 (GameCube Serial Port 2) support
* Add Datel disc dumping support
* Fix build issues/warnings with latest devKitPPC
* Disable DAT downloading from GameCube (no DNS support)
* Fix message prompts not appearing

===2.0.0 (July 28th, 2013)===
* GameCube version integrated into one codebase
* GX GUI
* Fix disc dumping on Wii U (Wii discs only of course)
* Fix ETA calculation on non GC discs
* Fix fatUnmount
* Stop larger than 4GB chunks on FAT FS
* Fix potential issue when read error occurs

===1.0.5 (June 29th, 2012)===
* Built with latest libOGC git (as of 30/06/2012)
* Built with libntfs-2012-1-15 (SVN Rev 13)
* Async read/write support for faster dumps (tueidj)
* Fixed time remaining to be accurate (tueidj)
* Fixed a potential bug when writing next chunk (tueidj)
* Fixed redump.org DAT file downloads (now re-hosted on gc-forever.com)
* Use proper DVD init from PPC and kill the starlet DVD IRQ (tueidj)
* Fixed Motor Off error message at the end of dumps

===1.0.4 (September 25th, 2010)===
* Added redump.org DAT file downloading
* Added more info to the dumpinfo.txt
* Fixed rip completion time not showing up
* Fixed NTFS issues (failed to create file/etc)

===1.0.3 (September 20th, 2010)===
* Added SHA-1 and CRC32 calculation (all saved to disk)
* Fixed redump.org verification on second and subsequent files
* Compiled with the latest libFAT & libOGC

===1.0.2 (September 19th, 2010)===
* Added redump.org in-program verification (see FAQ section)
* Added auto file splitting (i.e. ripping a Wii disc to a large FAT32 hdd)
* Fixed BCA dumping (GC & Wii disc)
* Fixed Multi-Disc rip file names
* Fixed Crashes on disc init

===1.0.1 (September 14th, 2010)===
* Added experimental BCA dumping (Wii disc only)
* Added MD5 sum saving
* Fixed Speed/ETA calculation
* Fixed file split issues
* Fixed SD/USB re-init issues
* Hopefully random code dumps with Wiimote are gone

==Features==
* FAT32 / NTFS file system support
* USB 2.0 support
* Front SD Support
* Gamecube / Wii / Wii Dual layer disc dumping
* BCA ripping to disk
* File Splitting (Maximum file size (only on NTFS) or 1, 2, 3 GB)
* MD5/SHA-1/CRC32/Disc version are saved to disk
* Redump.org in-program verification (via gc-forever.com) for known rips

==Requirements==
* Wii running the latest HBC (http://bootmii.org)
* Wii or GC Controller
* USB or SD storage device (>1.35GB free space)

==Credits==
libNTFS - Tantric/rodries (http://code.google.com/p/wiimc/source/browse/#svn/trunk/libs/libntfs)

libOGC/devKitPPC - shagkur / WinterMute

Team Twiizers for the HBC/Bootmii (http://bootmii.org)
.. and you, the users of course :)

==Known Issues==
===Device compatibility===
The Wii can be picky about particular USB drives/storage devices. It's recommended to use a Y cable for hard drives that fail to power up from one USB port alone. If USB flash storage doesn't want to work, try a different brand/size. SD cards on GameCube will potentially have similar issues, it's best to have a few different brands/sizes/types at your disposal.

CleanRip for GC is also compatible with M.2 SSDs via M.2 Loader.

===Partition table===
CleanRip will read external hard disk drives formatted as FAT32 or NTFS (though see below), as well as solid state drives via M.2 Loader, but may not read drives formatted using GUID Partition Table (GPT). Reformatting the drive using Master Boot Record (MBR) format for the partition table should allow CleanRip to use it.

===NTFS issues===
NTFS was broken on versions 1.0.2 and 1.0.3 - but was fixed in 1.0.4. It was also broken in 2.1.2, but fixed in 2.2.0{{Ref|https://github.com/emukidid/cleanrip/releases/tag/2.2.0}}.

===Issues with modchips===
When dumping GC Games, if you have a Wiikey/Modchip installed, make sure region patching is turned off, especially the "Full GC Regionfree" feature that Wiikey has as it will produce bad rips.

===Wii DAT download===
The Wii/GC DAT files from redump.org may fail to download. To manually obtain these files, download the latest version of the "Datfiles, Cuesheets, and GDIs compilation" from [http://redump.org/datfile/all/ Here]. Extract the Wii and GC dat files. Rename the files to wii.dat and gc.dat and place them in the root directory of the device you will use to rip discs with.

==Support==
If you're having any issues, drop by the forums at http://www.gc-forever.com/ and post your question.

==Older versions==
Older versions are available at [https://code.google.com/archive/p/cleanrip/ Google Code].

==References==
{{References}}