NX Game Info Switch

NX Game Info
General
Author	garoxas
Type	Game Management
Version	0.7.1
License	GPL-3.0
Last Updated	2019/11/10
Links
Download
Website
Source

A multiplatform tool to read information from Nintendo Switch game files.

This started as an experiment to add LibHac to Switch Backup Manager, but due to the complexity of integrating it into an existing app, it progressed as a separate project.

Features

• Windows, macOS and Linux compatible (Command Line Interface).
• NSP, XCI, NRO and installed titles on Switch SD card.
• Game files structure (Scene Release, CDN Rip, Authoring Tool, Converted from other formats).
• NCA signature to verify official Nintendo titles. Unmodified titles should pass this verification, although titles converted from other formats will not.
• Filesystem services permissions. Game titles should not have excessive permissions, and only trust titles with Unsafe and Dangerous from reliable source.

User guide

Information

• Title ID.
• Base Title ID.
• Title Name.
• Display Version:
  • Only available for Base and Update.
• Version.
• Latest Version:
  • Latest title version from tagaya CDN server.
• System Update:
  • XCI - System version on Update Partition.
  • NSP - RequiredSystemVersion from Metadata XML.
• System Version:
  • Minimum system version from Metadata NCA. Only available for Base and Update.
• Application Version:
  • Minimum application version from Metadata NCA. Only available for DLC.
• MasterKey.
• Title Key.
• Publisher:
  • Only available for Base and Update.
• Languages:
  • List of language codes as specified by RFC 5646. Only available for Base and Update.
• File Name.
• File Size.
• Type:
  • Base.
  • Update.
  • DLC.
• Distribution:
  • Digital - eShop titles (NSP).
  • Cartridge - Gamecard titles (XCI).
  • Homebrew - Homebrew titles (NRO).
  • Filesystem - Installed titles on Switch SD card (NAX0).
• Structure:
  • Scene (for XCI files) - XCI files with Update Partition, Normal Partition and Secure Partition.
  • Converted (for XCI files) - XCI files with only Secure Partition. Commonly found in NSP converted to XCI files.
  • Scene (for NSP files) - NSP files with legalinfo.xml, nacp.xml, programinfo.xml, cardspec.xml. Commonly found in BBB Scene Release.
  • Homebrew (for NSP files) - NSP files with authoringtoolinfo.xml.
  • CDN (for NSP files) - NSP files with cert and tik. Commonly found in NSP files ripped from the eShop CDN server.
  • Converted (for NSP files) - NSP files without cert and tik. Commonly found in XCI converted to NSP files.
  • Filesystem (for SD Card files) - NAX0 files installed titles on Switch SD card.
  • Not complete - XCI/NSP files with only NCA files.
• Signature:
  • Passed - NCA signature valid. Only available for official titles.
  • Not Passed - NCA signature invalid. Should only be for homebrew titles and not official titles.
• Permission:
  • Safe - Titles without Filesystem services access or permissions bitmask 0x8000000000000000 unset.
  • Unsafe - Titles with Filesystem services access and permissions bitmask 0x8000000000000000 set. Has EraseMmc permission, should only be for homebrew titles and not game titles.
  • Dangerous - Titles with Filesystem services access and permissions bitmask 0xffffffffffffffff set. Has all permissions, should only be for homebrew titles and not game titles.
  • Only available for Base and Update.

How to use

NX Game Info uses prod.keys, title.keys and console.keys in the format as defined here and hac_versionlist.json from tagaya CDN server.

• prod.keys:
  • Contains common keys used by all Switch devices, also found as keys.txt in other apps. Can be obtained from your Switch using Lockpick.
  • Mandatory keys includes header_key, aes_kek_generation_source, aes_key_generation_source, key_area_key_application_source and master_key_00. Failing to provide these keys will make the application quit master_key_##, key_area_key_application_## and titlekek_## will also be necessary to decrypt titles with higher MasterKey requirement.
• title.keys (optional):
  • Title keys file, support any popular format such as from newkeydb or nutdb.
  • This is required to read FS permission for games using Titlekey Crypto. Also used to map game title name and latest version if available. More details here.
• console.keys (optional):
  • sd_seed key required for Open SD Card feature.
  • Can also be obtained using Lockpick.
• hac_versionlist.json (optional):
  • Version list file, required for Latest Version feature.
  • Can be downloaded from https://pastebin.com/raw/9N26Bx10 (updated daily). No DLC version.

The application will look for these files at the following locations (other file locations will follow wherever prod.keys file was found).

• Directory of the executable file (.exe) for Windows or (.app) for macOS.
• $HOME/.switch e.g. C:\Users\yourname\.switch for Windows, /Users/yourname/.switch for macOS or /home/yourname/.switch for Linux.

Export menu supports exporting current list to either CSV or XLSX. For CSV file, default delimiter to use is comma ( , ) and user defined character can be set in user.settings by specifying the delimiter character in CsvSeparator field.

Compressed NCA is not supported, but there is an option to make the application accept XCZ and NSZ file extension by setting NszExtension field in user.settings. Please note that issues related to these file extensions will not be supported

Command Line Interface

Usage

Windows:

• Install .NET Core Runtime.
• Usage: nxgameinfo_cli.exe [-h|--help] [-d|--debug] [-c|--sdcard] [-s(titleid|titlename|filename)|--sort=(titleid|titlename|filename)] [-z|--nsz] paths...

macOS, Linux:

• macOS: Install Mono (Visual Studio channel)
• Linux (Ubuntu): Install Mono
• Usage: mono nxgameinfo_cli.exe [-h|--help] [-d|--debug] [-c|--sdcard] [-s(titleid|titlename|filename)|--sort=(titleid|titlename|filename)] [-z|--nsz] paths...

Parameters

• -h|--help
  • Show help message and immediately exit
• -d|--debug
  • Print debug output to debug.log
• -c|--sdcard
  • Treat arguments passed in paths parameters as installed titles on Switch SD card
• -s|--sort
  • Sort output by one of the following options:
    • titleid
    • titlename
    • filename (default)
• -z|--nsz
  • Enable XCZ and NSZ extension
• paths
  • File or directory path, can pass multiple arguments

Screenshots

macOS

- Open File/Directory

macOS GUI - Open SD Card

Windows

Open File/Directory

Open SD Card

Command Line Interface

Windows

macOS

Linux

Changelog

v0.7.1 2019/11/10

• Export to CSV and XLSX.
• Add Column for Languages.
• Add Update Title Keys for Title Names.

v0.7 2019/10/06

• Command Line Interface.
• Add Columns for Title Key and Publisher.
• Add Right Click Context Menu on Table View.
• Update Cart System Update for 9.0.1.
• Bug fixes.

v0.6 2019/09/16

• Table Contents History.
• Add Columns for Base Title ID, System Update (for XCI), System Version, Application Version (for DLC).
• Bug fixes.
• If you downloaded prior to 16th September 2019 at 7.30 AM Pacific time, please re-download to fix the issue when application start.

v0.5+hotfix.1

• [macOS] Fix crash on v0.5 (#7).
• [Windows] Save column width and filter.

v0.5 2019/05/12

• Highlight outdated titles.
• Update Latest Version List.
• Move user.config from AppData to .switch or Application Directory.
• Show last opened table contents on start.
• Bug fixes.

v0.4.1-alpha 2019/03/09

• Add export titles to text.
• Read titlekey from .tik.
• Move files enumeration to background worker.

v0.4-alpha 2019/02/09

• Improve installed titles on SD card for titles without Meta NCA.
• Save window location and size on exit.
• Add NRO support.

v0.3.2.1-alpha 2019/01/13

• Fix crash in macOS when opening file dialog.

v0.3.2-alpha 2019/01/13

• Debug Log.

v0.3.1-alpha 2019/01/09

• Background worker cancellation.
• Add progress dialog for macOS.

v0.3-alpha 2019/01/08

• Move missing Keys error messages to separate column and other fixes.
• Add support for other Title Keys file formats, and get name and version if available.
• Add icon and installed titles on Switch SD card to macOS build.

v0.2.1-alpha 2018/12/31

• Add icon and progress dialog.

v0.2-alpha 2018/12/29

• List installed titles on Switch SD card.

v0.1-alpha 2018/12/16

• Process NSP and XCI.
• Windows and macOS build.

Credits

• Thealexbarney for the LibHac library.
• switchbrew for the documentation on the Nintendo Switch.
• gibaBR for the Switch-Backup-Manager project.

External links

• GitHub - https://github.com/garoxas/NX_Game_Info
• GBAtemp - https://gbatemp.net/threads/nx-game-info-for-macos-and-windows.528419/