Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

NKit Wii: Difference between revisions

From GameBrew
m (HydeWing moved page Nkit Wii to NKit Wii without leaving a redirect)
No edit summary
 
(2 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=nkitwii.jpg
|image_alt=NKit
}}
{{Infobox Wii Homebrews
{{Infobox Wii Homebrews
|title=NKit
|title=NKit
|image=nkitwii.jpg
|image=nkitwii2.png
|description=NKit is a Nintendo ToolKit that can Recover and Preserve Wii and GameCube disc images.
|description=ToolKit that can recover and preserve Wii and GameCube disc images.
|author=nanook
|author=nanook
|lastupdated=2019/10/29
|lastupdated=2019/10/29
Line 18: Line 12:
|source=https://github.com/Nanook/NKit
|source=https://github.com/Nanook/NKit
}}
}}
'''NKit''' is a Nintendo ToolKit that is able to recover and preserve Wii and GameCube disc images. It has the ability to rebuild the source images to match the verified good images from Redump, and also has the ability to shrink any image and convert it back to the original source ISO.
NKit is a Nintendo ToolKit that can Recover and Preserve Wii and GameCube disc images.


NKit can convert to both ISO and the NKit format. The NKit format is specifically designed to shrink the image to its smallest size while still ensuring that it can be restored back to the original source data. These NKit images are also compatible with Dolphin, Swiss, and Nintendont but not yet with Wii USB Loaders.
Recovery is the ability to rebuild source images to match the known good images verified by Redump. Preserve is the ability to shrink any image and convert it back to the source iso.


==Key Uses==
NKit can convert to ISO and NKit format. The NKit format is designed to shrink an image to it's smallest while ensuring it can be restored back to the original source data. NKit images are also playable by Dolphin.
*Unscrub/Rebuild Wii/GC images from scrubbed/header+region hacked/wbfs(file)/iso.dec/iso/gcz to match Redump good images
*Convert Wii/GC images to NKit format (small, playable, reversible) - with optional gcz compression
*Preserve and shrink Scrubbed and Custom images
*Preserve Wii images with controlled removal of update partition
===Recovery===
*Recover scrubbed, header/region hacked images to match Redump verified images
===Preservation - NKit Format===
*Convert Redump, Hacks, Scrubbed images to NKit format and back to the original iso data


==Requirements==
Some of the key uses:
*Windows | Linux | Mac
*Unscrub/Rebuild Wii/GC images from scrubbed/header+region hacked/wbfs(file)/iso.dec/iso/gcz to match Redump good images.
*.Net for Windows or Mono 4.6.1 for Mac or Linux (Will be ported to dotnet core 3.0 soon)
*Convert Wii/GC images to NKit format (small, playable, reversible) - with optional gcz compression.
*Preserve and shrink Scrubbed and Custom images.
*Preserve Wii images with controlled removal of update partition.
*Recovery - Recover scrubbed, header/region hacked images to match Redump verified images.
*Preservation (NKit Format) Convert Redump, Hacks, Scrubbed images to NKit format and back to the original iso data.


==Features==
==Features==
*Recovery and Preservation of GameCube and Wii images
*Recovery and Preservation of GameCube and Wii images.
*NKit Format (smallest format and Dolphin compatible, GC is hardware compatible)
*NKit Format (smallest format and Dolphin compatible, GC is hardware compatible).
*GC NKit format aligns audio and tgc files to 32k for playability
*GC NKit format aligns audio and tgc files to 32k for playability.
*Wii NKit format removes hashes and encryption (Dolphin Compatible)
*Wii NKit format removes hashes and encryption (Dolphin Compatible).
*Reusable library for use in other projects
*Reusable library for use in other projects.
*Test Mode
*Test Mode.
*Summary log of all conversions
*Summary log of all conversions.
*Rename images that match Dat file entries to a configurable mask
*Rename images that match Dat file entries to a configurable mask.
*Supports 100% of Redump images (Unlicensed, All Regions, Multi Disc etc)
*Supports 100% of Redump images (Unlicensed, All Regions, Multi Disc etc).
*Scrubbed and Hacked preservation support
*Scrubbed and Hacked preservation support.


===Future Features===
===Formats===
*WBFS output (for easy output for Wii Hardware use)
*GCZ support.
*CISO reading
*ISO.DEC read support.
*Port the code to dotnet core 3 when it's released (GUIs too)
*WBFS read support.
*Port to Android
*ISO support.
*RVT-R Wii ISO read support.
*NKit Format support (smallest format and Dolphin compatible).
*Read the above images from Rar/Zip/7zip etc.


==Formats==
===Recovery===
*GCZ support
*ISO.DEC read support
*WBFS read support
*ISO support
*RVT-R Wii ISO read support
*NKit Format support (smallest format and Dolphin compatible)
*Read the above images from Rar/Zip/7zip etc
 
==Recovery Abilities==
*Insert missing Wii Update (inc rare extra data), Channel and VC partitions
*Insert missing Wii Update (inc rare extra data), Channel and VC partitions
*Replace Brickblocked Update partitions
*Replace Brickblocked Update partitions
Line 80: Line 64:
*Support for GC images with junk not generated with the image ID
*Support for GC images with junk not generated with the image ID


==Documentation==
==User guide==
* [https://wiki.gbatemp.net/wiki/NKit/UserGuide User Guide]
===Requirements===
* [https://wiki.gbatemp.net/wiki/NKit/FAQ FAQ] - Coming Soon
*Windows | Linux | Mac.
* [https://wiki.gbatemp.net/wiki/NKit/Glossary Glossary]
*.Net for Windows or Mono 4.6.1 for Mac or Linux.


'''Technical'''
===Documentation===
* [https://wiki.gbatemp.net/wiki/NKit/Discs Discs] : GameCube and Wii disc details
* [https://wiki.gbatemp.net/wiki/NKit/UserGuide User Guide].
* [https://wiki.gbatemp.net/wiki/NKit/DiscFileSystem File Systems] : Info about the GameCube/Wii filesystems and gaps
* [https://wiki.gbatemp.net/wiki/NKit/Glossary Glossary].
* [https://wiki.gbatemp.net/wiki/NKit/NKitFormat The NKit Format] : Detailed information about the NKit Format
 
===Technical details===
* [https://wiki.gbatemp.net/wiki/NKit/Discs Discs] - GameCube and Wii disc details.
* [https://wiki.gbatemp.net/wiki/NKit/DiscFileSystem File Systems] - Info about the GameCube/Wii filesystems and gaps.
* [https://wiki.gbatemp.net/wiki/NKit/NKitFormat The NKit Format] - Detailed information about the NKit Format.


==Changelog==
==Changelog==
'''Version 1.4'''
'''Version 1.4'''
*Fixed Hash Preservation for images with corrupt FSTs
*Fixed Hash Preservation for images with corrupt FSTs.
*Fixed "Truncated RVT-R image detected..." message being shown incorrectly
*Fixed "Truncated RVT-R image detected..." message being shown incorrectly.
*FST filenames are now correctly encoded with Shift-JIS
*FST filenames are now correctly encoded with Shift-JIS.
*There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.
*There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.


'''Version 1.3'''
'''Version 1.3'''
*Added RVT-H Detection. This is not currently supported - An error is thrown and logged
*Added RVT-H Detection. This is not currently supported - An error is thrown and logged.
*Fixed NkitReencode. It was always reencoding and not copying the NKit file when converting nkit.iso <-> nkit.gcz
*Fixed NkitReencode. It was always reencoding and not copying the NKit file when converting nkit.iso <-> nkit.gcz.
*Fixed Verify not outputting any log detail messages e.g. When a removed Update Partition is required to verify and was not present - no message was output, it just failed
*Fixed Verify not outputting any log detail messages e.g. When a removed Update Partition is required to verify and was not present - no message was output, it just failed.
*Moved the SummaryLog to the Processed folder rather than the app folder to make it more obvious
*Moved the SummaryLog to the Processed folder rather than the app folder to make it more obvious.
*Added settings home support. ~ at the start of a Path will insert the user's home directory (all OSs)
*Added settings home support. ~ at the start of a Path will insert the user's home directory (all OSs).
*Revert To .Net 4.6.1 - mono wasn't handling 4.7.2 very well. The app well be ported to dotnet core 3 soon
*Revert To .Net 4.6.1 - mono wasn't handling 4.7.2 very well. The app well be ported to dotnet core 3 soon.
*ProcessorApp: Added failure message to log errors (same as cmldline exe output)
*ProcessorApp: Added failure message to log errors (same as cmldline exe output).
*ProcessorApp: Disabled the checkbox for 'Remove and Preserve Wii Update Partitions' when Recovering or Converting to iso
*ProcessorApp: Disabled the checkbox for 'Remove and Preserve Wii Update Partitions' when Recovering or Converting to iso.
*ProcessorApp: Fixed checkbox for 'Remove and Preserve Wii Update Partitions' not being set on app load
*ProcessorApp: Fixed checkbox for 'Remove and Preserve Wii Update Partitions' not being set on app load.
*ProcessorApp: Fixed progress .1.2.3... text alignment in the log output
*ProcessorApp: Fixed progress .1.2.3... text alignment in the log output.
*ProcessorApp: Fixed the output log being truncated when a partition ID contained a null char
*ProcessorApp: Fixed the output log being truncated when a partition ID contained a null char.
*There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.
*There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.


'''Version 1.2'''
'''Version 1.2'''
*Updated to .Net 4.7.2 (Preparation for long file name support)
*Updated to .Net 4.7.2 (Preparation for long file name support).
*Added support for images that a file ends on a non 4 byte alignment (for 1 shrunk GC demo)
*Added support for images that a file ends on a non 4 byte alignment (for 1 shrunk GC demo).
*Added support for images that have no Magic (default to GC - for 1 GC early system disc)
*Added support for images that have no Magic (default to GC - for 1 GC early system disc).
*Fixed the ExtractionApp GC Region always showing Japan
*Fixed the ExtractionApp GC Region always showing Japan.
*Corrected NKitExtracted path in config
*Corrected NKitExtracted path in config.
*Added missing Wii Jakers config entry
*Added missing Wii Jakers config entry.
*Fixed Double "Truncated RVT-R" message
*Fixed Double "Truncated RVT-R" message.
*Fixed ProcessorApp Gui Exception not being captured
*Fixed ProcessorApp Gui Exception not being captured.
*Fixed Drag Drop message being cleared when a non supported file is dropped
*Fixed Drag Drop message being cleared when a non supported file is dropped.
*Modified some public class accessibility to make them internal
*Modified some public class accessibility to make them internal.
*There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.
*There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.


Line 127: Line 115:
*NKit format fix: Fixed a bug when converting Wii to NKit. This was introduced during the last 2 days of development while adding support for a Customs preservation bug.
*NKit format fix: Fixed a bug when converting Wii to NKit. This was introduced during the last 2 days of development while adding support for a Customs preservation bug.
*Fixed a minor ProcessingApp bug where the output path wouldn't be used.
*Fixed a minor ProcessingApp bug where the output path wouldn't be used.
*Any Converted NKit Wii images from v1.0 are not corrupt. Just not 100% correct to the format. Reconverting will correct the issue. Make sure NKitReencode is set to true if reconverting images that were made with v1.0.
*Any Converted NKit Wii images from v1.0 are not corrupt. Just not 100% correct to the format. Reconverting will correct the issue. Make sure NKitReencode is set to true if reconverting images that were made with v1.0.


'''Version 1.0'''
'''Version 1.0'''
*A lot of effort has gone in to ensuring this version is as stable and reliable as possible. The NKit Format is stable and reliable. Always use FullVerify as it's always accurate as are the Hashes when CalculateHashes is on. Please report any issues and ask any questions.
*A lot of effort has gone in to ensuring this version is as stable and reliable as possible. The NKit Format is stable and reliable. Always use FullVerify as it's always accurate as are the Hashes when CalculateHashes is on. Please report any issues and ask any questions.
 
*Fixed a bug in the GC Format (This alters 12 of the GC Redump images - just reencode them if you verify against NKit dats).
*Fixed a bug in the GC Format (This alters 12 of the GC Redump images - just reencode them if you verify against NKit dats)
*Added Wii NKit Format (100% Redump tested, Scrubbed & Custom Support).
*Added Wii NKit Format (100% Redump tested, Scrubbed & Custom Support)
*2 Windows (Sorry Linux & Mac users) GUI Apps added, including file extraction.
*2 Windows (Sorry Linux & Mac users) GUI Apps added, including file extraction


'''Version 0.5'''
'''Version 0.5'''
*First stable version
*First stable version.


==Credits==
==Credits==
*Johnsanc - Testing, ideas and motivation
*Johnsanc - Testing, ideas and motivation.
*JosJuice - Disc format and Dolphin knowledge
*JosJuice - Disc format and Dolphin knowledge.
*GerbilSoft - Disc format knowledge (+ RVT-R) (rvthtool / rom-properties)
*GerbilSoft - Disc format knowledge (+ RVT-R) (rvthtool / rom-properties).
*Osupka - UltimateUnscrubber code
*Osupka - UltimateUnscrubber code.
*LedZeppelin68 - Nasos (ISO.DEC) code
*LedZeppelin68 - Nasos (ISO.DEC) code.
*Wiimm - WIT (WBFS) code
*Wiimm - WIT (WBFS) code.
*ToeKnee - Testing
*ToeKnee - Testing.
*Dack - Wii Scrubber code
*Dack - Wii Scrubber code.
*Scifi76 - Wii Scrubber dll (fst.bin) code
*Scifi76 - Wii Scrubber dll (fst.bin) code.
*All the game preservationists out there - hope this saves you some space...
*All the game preservationists out there - hope this saves you some space.


==External Links==
==External links==
* Gbatemp - https://wiki.gbatemp.net/wiki/NKit
* GBAtemp - https://gbatemp.net/download/nkit.36157/
* Github - https://github.com/Nanook/NKit
* GBAtemp - https://wiki.gbatemp.net/wiki/NKit
* GitHub - https://github.com/Nanook/NKit

Latest revision as of 06:12, 1 April 2023

NKit
Nkitwii2.png
General
Authornanook
TypePC Utilities
Version1.4
LicenseMixed
Last Updated2019/10/29
Links
Download
Website
Source

NKit is a Nintendo ToolKit that can Recover and Preserve Wii and GameCube disc images.

Recovery is the ability to rebuild source images to match the known good images verified by Redump. Preserve is the ability to shrink any image and convert it back to the source iso.

NKit can convert to ISO and NKit format. The NKit format is designed to shrink an image to it's smallest while ensuring it can be restored back to the original source data. NKit images are also playable by Dolphin.

Some of the key uses:

  • Unscrub/Rebuild Wii/GC images from scrubbed/header+region hacked/wbfs(file)/iso.dec/iso/gcz to match Redump good images.
  • Convert Wii/GC images to NKit format (small, playable, reversible) - with optional gcz compression.
  • Preserve and shrink Scrubbed and Custom images.
  • Preserve Wii images with controlled removal of update partition.
  • Recovery - Recover scrubbed, header/region hacked images to match Redump verified images.
  • Preservation (NKit Format) Convert Redump, Hacks, Scrubbed images to NKit format and back to the original iso data.

Features

  • Recovery and Preservation of GameCube and Wii images.
  • NKit Format (smallest format and Dolphin compatible, GC is hardware compatible).
  • GC NKit format aligns audio and tgc files to 32k for playability.
  • Wii NKit format removes hashes and encryption (Dolphin Compatible).
  • Reusable library for use in other projects.
  • Test Mode.
  • Summary log of all conversions.
  • Rename images that match Dat file entries to a configurable mask.
  • Supports 100% of Redump images (Unlicensed, All Regions, Multi Disc etc).
  • Scrubbed and Hacked preservation support.

Formats

  • GCZ support.
  • ISO.DEC read support.
  • WBFS read support.
  • ISO support.
  • RVT-R Wii ISO read support.
  • NKit Format support (smallest format and Dolphin compatible).
  • Read the above images from Rar/Zip/7zip etc.

Recovery

  • Insert missing Wii Update (inc rare extra data), Channel and VC partitions
  • Replace Brickblocked Update partitions
  • Auto fixes modified disc headers (where the Data header remains intact)
  • Fixes rare corrupt Wii partition table (caused by Wii Backup Manager)
  • Fixes scrubbed trailing file 0's
  • Fixes truncated Wii images (where the Data partition is intact)
  • Fixes slightly overdumped images (from descramble tools)
  • Fixes Wii Data partitions moved before 0xF800000 to save space
  • Fixes compacted GC images
  • Fixes moved and reordered GC files
  • Fixes modified GC headers (inc. title, region hacks)
  • Fixes mod chip modified GC apploaders
  • Fixes GC images with non conformant junk
  • Fixes modified Wii region and ratings
  • Support for GC images with junk not generated with the image ID

User guide

Requirements

  • Windows | Linux | Mac.
  • .Net for Windows or Mono 4.6.1 for Mac or Linux.

Documentation

Technical details

  • Discs - GameCube and Wii disc details.
  • File Systems - Info about the GameCube/Wii filesystems and gaps.
  • The NKit Format - Detailed information about the NKit Format.

Changelog

Version 1.4

  • Fixed Hash Preservation for images with corrupt FSTs.
  • Fixed "Truncated RVT-R image detected..." message being shown incorrectly.
  • FST filenames are now correctly encoded with Shift-JIS.
  • There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.

Version 1.3

  • Added RVT-H Detection. This is not currently supported - An error is thrown and logged.
  • Fixed NkitReencode. It was always reencoding and not copying the NKit file when converting nkit.iso <-> nkit.gcz.
  • Fixed Verify not outputting any log detail messages e.g. When a removed Update Partition is required to verify and was not present - no message was output, it just failed.
  • Moved the SummaryLog to the Processed folder rather than the app folder to make it more obvious.
  • Added settings home support. ~ at the start of a Path will insert the user's home directory (all OSs).
  • Revert To .Net 4.6.1 - mono wasn't handling 4.7.2 very well. The app well be ported to dotnet core 3 soon.
  • ProcessorApp: Added failure message to log errors (same as cmldline exe output).
  • ProcessorApp: Disabled the checkbox for 'Remove and Preserve Wii Update Partitions' when Recovering or Converting to iso.
  • ProcessorApp: Fixed checkbox for 'Remove and Preserve Wii Update Partitions' not being set on app load.
  • ProcessorApp: Fixed progress .1.2.3... text alignment in the log output.
  • ProcessorApp: Fixed the output log being truncated when a partition ID contained a null char.
  • There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.

Version 1.2

  • Updated to .Net 4.7.2 (Preparation for long file name support).
  • Added support for images that a file ends on a non 4 byte alignment (for 1 shrunk GC demo).
  • Added support for images that have no Magic (default to GC - for 1 GC early system disc).
  • Fixed the ExtractionApp GC Region always showing Japan.
  • Corrected NKitExtracted path in config.
  • Added missing Wii Jakers config entry.
  • Fixed Double "Truncated RVT-R" message.
  • Fixed ProcessorApp Gui Exception not being captured.
  • Fixed Drag Drop message being cleared when a non supported file is dropped.
  • Modified some public class accessibility to make them internal.
  • There should be no breaking changes or conversion difference for any previously successfully verified images. Please report any issues.

Version 1.1

  • NKit format fix: Fixed a bug when converting Wii to NKit. This was introduced during the last 2 days of development while adding support for a Customs preservation bug.
  • Fixed a minor ProcessingApp bug where the output path wouldn't be used.
  • Any Converted NKit Wii images from v1.0 are not corrupt. Just not 100% correct to the format. Reconverting will correct the issue. Make sure NKitReencode is set to true if reconverting images that were made with v1.0.

Version 1.0

  • A lot of effort has gone in to ensuring this version is as stable and reliable as possible. The NKit Format is stable and reliable. Always use FullVerify as it's always accurate as are the Hashes when CalculateHashes is on. Please report any issues and ask any questions.
  • Fixed a bug in the GC Format (This alters 12 of the GC Redump images - just reencode them if you verify against NKit dats).
  • Added Wii NKit Format (100% Redump tested, Scrubbed & Custom Support).
  • 2 Windows (Sorry Linux & Mac users) GUI Apps added, including file extraction.

Version 0.5

  • First stable version.

Credits

  • Johnsanc - Testing, ideas and motivation.
  • JosJuice - Disc format and Dolphin knowledge.
  • GerbilSoft - Disc format knowledge (+ RVT-R) (rvthtool / rom-properties).
  • Osupka - UltimateUnscrubber code.
  • LedZeppelin68 - Nasos (ISO.DEC) code.
  • Wiimm - WIT (WBFS) code.
  • ToeKnee - Testing.
  • Dack - Wii Scrubber code.
  • Scifi76 - Wii Scrubber dll (fst.bin) code.
  • All the game preservationists out there - hope this saves you some space.

External links

Advertising: