Skip to content

Current Status

Jump to bottom
Nanook edited this page Sep 27, 2026 · 3 revisions

Updated with each release. Check Discord for the latest news between releases.

Latest Release — v3.0.1

Bug Fixes in v3.0.1

  • PS2 NKDS VerifyFailed for mixed Mode2 CUE+BIN images — PS2 disc images using mixed Mode2 tracks in CUE+BIN format now store and verify correctly
  • PS2 NKDS VerifyFailed: uncovered FS gaps missed — a stale parallel-stage FST caused newly stored gaps to be missed, producing false verification failures
  • ISO9660 FST gap analysis regression — directory entries resolved via the refactored processDirectory path were incorrectly included in gap analysis; now correctly skipped (regression from the v3 refactor)
  • Xbox beta disc support — adds recognition of a known XGD1 beta disc (slightly larger than standard OG discs) and a known XGD3 beta disc (same size as XGD3v0 but with different video ISO lengths) — thanks @Deterous

v3.0.0

What's New in v3

  • New interactive CLI — run nkit or nkds with no arguments (or drop a file onto them) to launch a guided builder. Shows the equivalent command so it doubles as a way to learn the CLI. Both apps also detect when a file is dropped on them and pre-seed it into the interactive builder.
  • New verb-based CLI — nkit convert, nkds add, nkds mount etc. with modern --long / -short options. Config keys and CLI names match.
  • New processing core — async parallel pipeline (Input → PreProcess → Process → Output) with autoscaling workers. Live progress bar with throughput and stage stats.
  • Console colours — log lines coloured by scope and task; Verify outcomes green/red.
  • NKDS compaction fixed — v3 introduced validate-before-replace and promote-or-delete crash recovery for compaction. See NKDS Data Safety.
  • NKDS dat verification (UI) — load dats, classify images as Correct/Badly Named/Wrong CRC/Missing, auto-rename.
  • Config auto-setup — both nkit and nkds create the full folder tree (dats/, keys/, fix/, out/, …) and copy a default config on first run.
  • FUSE/Dokan improvements — stale mount cleanup, cleaner unmount on set close, cursor restored after interactive mode on Linux.
  • Window titles — taskbar and alt-tab now show NKit vX.Y.Z / NKDS vX.Y.Z across all platforms.

Known Issues

Area Issue Workaround
Windows Antivirus false positive on first run Whitelist the executables. All builds are automated and unsigned (native AOT).
Linux glibc error on older distros Use the legacy build (glibc 2.27+, Ubuntu 18.04+).
macOS Gatekeeper blocks unsigned binaries See macOS setup below.
VFS Requires extra software Windows: Dokan. Linux: FUSE 3. macOS: FUSE-T.
Linux terminal Resizing the terminal during processing may clip log lines Known Spectre.Console limitation. Minimised in v3.0.0 — the live region resets on resize.

macOS Gatekeeper

Builds are not code-signed (an Apple Developer certificate will be purchased from donations).

Quick fix (Terminal):

xattr -d com.apple.quarantine nkit nkds nkit-ui nkds-ui
chmod +x nkit nkds nkit-ui nkds-ui

GUI method: Open System Settings → Privacy & Security, find the blocked app, click Open Anyway.

Upcoming

See the Roadmap for planned features.

How to Stay Updated

Clone this wiki locally