v0.1.0

nkit2iso converts GameCube & Wii *.nkit.iso (and GCZ-compressed *.nkit.gcz) disc images back to plain, bit-exact .iso files that emulators like Dolphin and Nintendont can boot — a single, dependency-free binary.

Highlights

• 🎮 GameCube & Wii — single- and multi-partition discs (UPDATE + DATA + CHANNEL), including scrubbed dumps
• 📦 .nkit.iso and .nkit.gcz input — GCZ containers are decompressed transparently
• ✅ Redump-verified 1:1 — every restore is checked against the original CRC32 stored in the NKit header; a successful run is byte-exact, not just "boots"
• 🪶 Zero dependencies — one static Go binary, constant memory even on 4.7 GB images
• 💻 Cross-platform — Windows, macOS (universal), Linux

Install

Homebrew (macOS / Linux):

brew install DonMikone/tap/nkit2iso

Manual — download the archive for your platform below and put the nkit2iso binary on your PATH:

Platform	Asset
Windows (x64)	nkit2iso_0.1.0_windows_amd64.zip
Linux (x64)	nkit2iso_0.1.0_linux_amd64.tar.gz
macOS (Intel + Apple Silicon)	nkit2iso_0.1.0_macos_universal.tar.gz

macOS manual download only: the binary isn't code-signed, so clear the quarantine flag once with xattr -dr com.apple.quarantine ./nkit2iso. (Homebrew does this for you.)

Usage

nkit2iso -i "game.nkit.iso"      # -> game.iso
nkit2iso -i "game.nkit.gcz"      # GCZ, decompressed on the fly -> game.iso

Exit code is 0 only when the reconstructed ISO's CRC32 matches the NKit header.

Verified

• GameCube — Mario Kart: Double Dash!! → CRC32 099E2C6D ✅
• Wii (single-partition) — Wii Play → CRC32 9B547521 ✅
• Wii (multi-partition, from .nkit.gcz) — Mario Kart Wii → CRC32 0CC7B4D5 ✅

Known limitation

Wii images whose update partition was removed can't be restored byte-exact from the .nkit alone (that data isn't in the file) — this is detected and reported rather than producing a wrong image.

---

🤖 Generated with Claude Code