More actions
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
andDangerous
from reliable source.
User guide
Information
- Title ID.
- Base Title ID.
- Title Name.
- Display Version:
- Only available for
Base
andUpdate
.
- Only available for
- Version.
- Latest Version:
- Latest title version from tagaya CDN server.
- System Update:
- XCI - System version on
Update Partition
. - NSP -
RequiredSystemVersion
from Metadata XML.
- XCI - System version on
- System Version:
- Minimum system version from Metadata NCA. Only available for
Base
andUpdate
.
- Minimum system version from Metadata NCA. Only available for
- Application Version:
- Minimum application version from Metadata NCA. Only available for
DLC
.
- Minimum application version from Metadata NCA. Only available for
- MasterKey.
- Title Key.
- Publisher:
- Only available for
Base
andUpdate
.
- Only available for
- Languages:
- List of language codes as specified by RFC 5646. Only available for
Base
andUpdate
.
- List of language codes as specified by RFC 5646. Only available for
- 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
andSecure 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
andtik
. 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.
- Scene (for XCI files) - XCI files with
- 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
andUpdate
.
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
andmaster_key_00
. Failing to provide these keys will make the application quitmaster_key_##
,key_area_key_application_##
andtitlekek_##
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 forOpen 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
- Print debug output to
- -c|--sdcard
- Treat arguments passed in
paths
parameters as installed titles on Switch SD card
- Treat arguments passed in
- -s|--sort
- Sort output by one of the following options:
titleid
titlename
filename
(default)
- Sort output by one of the following options:
- -z|--nsz
- Enable
XCZ
andNSZ
extension
- Enable
- 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.