NxFileViewer - Ein Tool zum Auslesen von Metadaten (NSP, NSZ, XCI, XCZ)

4.0.0-beta 1

Version 4.0.0-beta.1: neue Oberfläche, Archivunterstützung und Updates

• Einzelprüfung, Stapelprüfung und Einstellungen in einem Hauptfenster zusammenführen
• Einstellungen in Programm, Updates und Plugins aufteilen
• ZIP- und 7z-Unterstützung für Einzel- und Stapelprüfung ergänzen
• Entpackte Dateien während der geöffneten Archivsitzung behalten
• Archivherkunft im Dateityp anzeigen, z. B. „NSP (ZIP)“
• NSZ-Laden und Wechsel zwischen Stapelergebnissen beschleunigen
• Stapeltabelle um wählbare Spalten, Sortierung, Filter und Scrollen erweitern
• Übersicht und Firmware-Prüfung passend zur ausgewählten Datei öffnen
• Firmware in Ordnern und Archiven sowie einzelne Firmware-NCAs erkennen
• Falsch benannte Firmware-Dateien anhand ihres Inhalts zuordnen
• Firmware-Referenzen bei Bedarf von GitHub laden und separat paketieren
• Programmupdates mit optionalen Vorabversionen integrieren
• Updateverwaltung für NSZ-Plugin, TitleDB und Firmware-Hashes ergänzen
• GitHub TitleDB und NLib als alternative Titelanbieter hinzufügen
• NSZ-Einstellungen, Fortschrittsanzeige und Fehlerdiagnose erweitern
• Vorhandene Zieldateien beim Umwandeln ersetzen oder nummerieren
• Quelldateien nach erfolgreich geprüfter Umwandlung optional löschen
• Programmdaten und Plugins vollständig im Programmordner speichern
• Key-Hinweise verbessern und Probleme auf der Startseite anzeigen
• Veröffentlichungen ohne persönliche Build-Pfade erstellen

Validierung: x64- und x86-Publish erfolgreich, 243 Tests bestanden.

3.0.4

Added

• Firmware verification for ZIP archives and folders of loose NCAs using bundled fw/hashes/*.json size and SHA-256 references, without keys or extraction.
• Firmware checks fetch current hash references from GitHub only for detected or explicitly selected firmware, with no disk cache and a visible bundled-reference fallback during outages. Repeated firmware checks fetch again; pure game folders make no request.
• Automatic firmware detection in folder integrity checks, firmware version/result details, and CSV export. Missing, changed, extra and duplicate NCA entries fail verification.
• Selectable title metadata sources: Tinfoil, regional GitHub TitleDB with persistent offline cache, and configurable NLib API.
• Firmware mapping for master-key revision 0x16 to 23.0.0. Its CRC32 reference was derived from a local key file and is not an independent upstream confirmation.
• Added validation results for prod.keys and title.keys to the settings window.
• Added detection and reporting of missing master_key_XX revisions in outdated prod.keys files.
• Added CRC32-based validation of known master-key revisions through master_key_16.
• Added malformed-line detection for key files.
• Added structural validation of Rights ID and title-key pairs in title.keys.
• Added an estimate of the newest supported firmware based on the highest valid master-key revision.
• Added a warning when a key file contains a newer master-key revision that this application version cannot validate or map to a firmware.
• Added localized validation messages for English, German, French, and Spanish.
• Added automated tests for key-file validation, firmware mapping, and unknown master-key detection.
• Added anonymous FTP support to the existing HTTP/HTTPS key downloader.
• Added editable default Sphaira FTP locations for prod.keys and title.keys; customized addresses continue to be stored in the application settings.
• Downloads now use a temporary file and only replace the destination after a successful transfer.
• Added parsing of main.npdm from program NCAs.
• Added a program-security assessment based on signed ACID file-system permissions, including safe, unsafe, and dangerous classifications.
• Added the ACID signature state, raw permission mask, and authorized service list to the program details.
• Added base title ID, required master-key revision/key generation, minimum application version for DLC, and NCA distribution type to the title overview.
• Added package-structure detection for Scene releases, CDN rips, converted packages, Homebrew packages, and incomplete NSP/NSZ/XCI/XCZ files.
• Added package file size and an estimated NSZ/XCZ compression ratio with reconstructed uncompressed size.
• Added detection of the system-update version contained in an XCI/XCZ update partition.

Fixed

• Solid NCZ reads now cache the decoded prefix in a temporary file, avoiding complete decompression restarts on backward/random reads and improving the likely bottleneck behind issue Myster-Tee#52.
• Block NCZ decoding respects compressed block boundaries; block lookup, short reads, EOF handling, zero-length reads and disabled caching are corrected or covered by regression tests.
• Online rename failures (including HTTP 503) fall back to the local NACP title when available.
• Unrecognized additional key names are reported as localized informational notices; malformed key data remains a warning.
• Prevented a double release of the LibHac main.npdm file while loading program-security information.
• Added a defensive size limit so malformed NPDM files fail safely instead of destabilizing file loading.
• Snapshot NPDM security data inside the protected parser block so UI bindings cannot trigger delayed parser failures.
• Batch preview errors no longer replace otherwise valid package and integrity results with Unknown.
• Exception details and stack traces are now included in the application log for actionable diagnostics.
• Fixed a crash when the program-security fields were displayed by explicitly using one-way WPF bindings for read-only values.
• Batch integrity results now include the underlying NCA error and identify broken NSZ/NCZ Zstandard streams as corrupted or incomplete compressed data.
• Batch integrity results and CSV exports now include the detected package structure.

Notes

• ZstdSharp.Port remains at 0.8.8; compressed NACP titles remain supported.
• Firmware references ship with the application and work offline. ZIPs repacked with different compression are valid if all NCA contents match. Local /test/ data is excluded from Git.
• Validation: solution build and 94 automated tests (including nine firmware tests). Real firmware archives were not used for these tests.
• The firmware shown for prod.keys is the newest content firmware supported by its keys. The exact firmware on which the file was dumped cannot be determined from the key file.
• title.keys can be checked for valid structure, but title-key values cannot be compared against a universal list of expected values.

3.0.3

Dieses Release erweitert NxFileViewer um eine Stapelprüfung, modernisiert die Oberfläche und übernimmt Verbesserungen aus verschiedenen Community-Forks.
Neue Stapel-Integritätsprüfung

• Ganze Ordner mit Nintendo-Switch-Dateien prüfen
• Unterstützt NSP, NSZ, XCI und XCZ
• Unterordner optional einbeziehen
• Ergebnisse erscheinen während der laufenden Prüfung
• Anzeige von:
  • Dateityp
  • Pakettyp
  • Komprimierung
  • Integritätsstatus
  • Fehlerbeschreibung
  • vollständigem Dateipfad
• Filter „Nur fehlerhafte anzeigen“
• Aktuell geprüfte Datei mit eigener Übersicht rechts
• Fortschrittsanzeige und Statusleiste
• Prüfung kann abgebrochen werden
• Ergebnisse als CSV exportieren
• Zuletzt verwendeten Stapelordner speichern
• Fehlerfreie Dateien in einen auswählbaren Zielordner verschieben
• Unterordnerstruktur bleibt beim Verschieben erhalten
• Vorhandene Zieldateien werden nicht überschrieben
• Fehlerhafte Dateien werden niemals automatisch gelöscht oder verschoben
  Oberfläche und Einstellungen
• Dark-, Light- und System-Theme
• Dunkle Titelleisten für Hauptfenster, Einstellungen, Umbenennen und Stapelprüfung
• Fensterposition und Fenstergröße werden gespeichert
• Verbesserte Darstellung des Stapelfensters im Dark Mode
• Tinfoil-Titelseiten-URL und Tinfoil-API-URL separat konfigurierbar
• Aktualisierung von tinfoil.media auf tinfoil.io
  NACP-Verbesserungen
• Unterstützung komprimierter NACP-Titelblöcke
• Unterstützung von bis zu 32 Sprachen statt bisher 16
• Erweiterte Anzeige von NACP-Informationen
  Umbenennen
• GitHub-Issue Myster-Tee#46 behoben
• Fehlende Leerzeichen bzw. Trennzeichen in online abgerufenen Titeln werden beim Umbenennen korrigiert
• Normalisierung fehlerhaft zusammengesetzter Dateinamen verbessert
  Abhängigkeiten und Build
• Projekt auf aktuelle .NET-8-kompatible Pakete aktualisiert
• ZstdSharp.Port aktualisiert
• Microsoft.Extensions-Pakete aktualisiert
• Test-SDK, xUnit und Coverlet aktualisiert
• LibHac bleibt vorerst auf Version 0.19.0, da kein vollständig kompatibler direkter Ersatz verfügbar ist

3.0.2

• Fix version displayed in title bar
• Latam Spanish language added (thanks to Impeeza)

3.0.1

• console.keys removed from the settings (not necessary for NxFileViewer)
• New setting added to load Keys from ticket files
• Can drag and drop keys (feature 10)
• Fix ticket keys injection for Sha256PartitionFileSystem (XCI) (issues 27 and 32)
• Displayed version {VerDsp} supported for renaming (feature 23)
• Fix some minor translations
• Some minor changes

3.0.0

• Full NSZ/XCZ support with optimized reading
• Simplification of integrity check
• Fix file saving
• Minor UI fix and improvements
• Updated to .NET 8

2.7.0

Here is the tenth release of NxFileViewer.

• Based on LibHac v0.19.0
• Do not anymore try to open sparse sections to avoid reporting unexpected errors
• Notification displayed when no prod.keys is found
• Updated to .NET 7

2.6.1

• Fix duplicated files display (in structure view) for file system sections (issue #5)
• Fix wrong error reporting for titles with Brazilian/Portuguese icons

2.6.0

• Based on latest LibHac release (v0.16.0)
• Possibility to rename files with custom options
• Fix «Offset must be a multiple of 16» when opening update files
• Settings can be reset to default
• Many small improvements

2.5.0

• Based on latest LibHac release (v0.15.0)
• Possibility to open a Web page for the loaded title (based on the Title ID)
• Possibility to save decrypted NCAs
• NCA hash strategy changed, now based on CNMT metadata file
• Property «IsNCA0» added for NCA
• French language supported (language can be changed in the settings)
• Some small issues fixed
• Based on .NET 6

v2.4.0

• Properties of ticket files (*.tik) are displayed
• Title ID keys from the ticket files are now loaded and used for opening NCA contents

v2.3.0

• Keys files being used are displayed in the settings
• New command added for reload keys on demand
• «title.keys» can also be downloaded from an URL defined in the settings
• Can edit keys from the settings
• New setting added for reloading keys each time a file is opened
• Keys download URL can be immediately tried
• Missing title keys are displayed via an icon in the status bar
• Can open location of opened file via context menu of «Overview» tab
• NCA (or NCZ) Sections are displayed even when content can't be opened
• FIX: NCA hash is not anymore considered valid when NCA content cannot be opened
• Hash status moved to «Section» items instead of «NCA» items
• Tooltip added for displaying NCA's hash or NCA's signature error
• Text of help tooltips can be copied

v2.2.0

• Hash of NCAs can now be verified
• Header signature of NCAs can now be verified
• Long time actions are now threaded (a status bar and a progress bar have been added )
• Possibility to save a Directory (was not finished in previous version)
• Possibility to save a NCA Section
• Possibility to save a PartitionFileEntry
• Program can now open supported files at startup when program is associated with supported files
• Errors are marked on the corresponding structure tree item when applicable
• Item's errors can be opened in a specific window
• Displayed item's properties order improved
• Size of PartitionFileEntry displayed
• Lazy loading option removed (as file opening is now threaded, it is better to always reveal possible errors)
• Fix initial directory when browsing for a file to open
• Lots of small UI changes and improvements

v2.1.0

• New setting added to select the structure tree loading mode
• Fix a display bug in the settings when cancel button was clicked
• Enum settings are now saved as string instead of integer (better readbility)
• Change version format in overview tab (displayed as 65536, 131072, etc instead of 0.1.0.0, 0.2.0.0)
• Opened file logged
• Log level can be selected in the settings
• Keys download URL can be defined in the settings
• The ModuleID (also known as Build ID) is displayed in the properties when the «main» program file is selected (requested by BigOnYa)
• Some extra properties added to display
• Missing NCAs of type «DeltaFragment» are logged as warning instead of error (maybe normal ?)

v2.0.0

• Now based on LibHac (hactool not anymore required)
• In addition to NSP, now supports NSZ, XCI and XCZ
• Supports Super NSP/XCI
• Full file content structure browsing
• Export contained files
• Save or copy title images
• Specify your own keys location
• Searches keys in commonly used locations
• Automatically download keys from an URL defined in the settings
• Supports drag and drop
• Checks real files type (XCI or NSP)
• Nearly totally redevelopped
• Now based on .NET 5
• Prepared for beeing translated in other languages

v1.0.0

• initial release